CMFCRibbonGalleryMenuButton, classe

Implémente un bouton de menu de ruban qui contient des galeries de ruban. Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

Syntaxe

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Membres

Constructeurs publics

Méthodes publiques

Notes

Le bouton de menu de galerie s'affiche sous forme de menu contextuel avec une flèche. Quand l'utilisateur clique sur ce bouton, une galerie d'images s'affiche. Quand vous construisez un bouton de menu de galerie, vous devez spécifier une liste d'images qui contient ces images.

Exemple

L'exemple suivant montre comment afficher une galerie de puces dans un bouton de menu :

BOOL CMainFrame::OnShowPopupMenu (CMFCPopupMenu* pMenuPopup)
{
    int nBulletIndex = pMenuBar->CommandToIndex (ID_PARA_BULLETS);

    if (nBulletIndex>= 0)
    {
        CMFCToolBarButton* pExButton =
        pMenuBar->GetButton(nBulletIndex);
        ASSERT_VALID (pExButton);

        CMFCRibbonGalleryMenuButton paletteBullet (
        pExButton->m_nID,
        pExButton->GetImage (),
        pExButton->m_strText);

        InitBulletPalette (&paletteBullet.GetPalette ());

        pMenuBar->ReplaceButton (ID_PARA_BULLETS,
        paletteBullet);
    }
}

Hiérarchie d'héritage

CObject
└ CMFCToolBarButton
 └ CMFCToolBarMenuButton
  └ CMFCRibbonGalleryMenuButton

Spécifications

En-tête : afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton ::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Paramètres

[in] src

Notes

CMFCRibbonGalleryMenuButton ::CMFCRibbonGalleryMenuButton

Construit et initialise un objet CMFCRibbonGalleryMenuButton .

CMFCRibbonGalleryMenuButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText,
    CMFCToolBarImages& imagesPalette);

CMFCRibbonGalleryMenuButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText,
    UINT uiImagesPaletteResID = 0,
    int cxPaletteImage = 0);

Paramètres

uiID
ID de commande du bouton. Il s’agit de la valeur envoyée dans le message WM_COMMAND lorsque l’utilisateur clique sur ce bouton.

iImage
Index de l’image à afficher avec le bouton de menu galerie. Les images sont stockées dans le paramètre imagesPalette .

lpszText
Texte à afficher sur le bouton de menu.

imagesPalette
Contient la liste des images à afficher dans la galerie.

uiImagesPaletteResID
ID de ressource de la liste d’images pour que les images s’affichent dans la galerie.

cxPaletteImage
Spécifie la largeur en pixels de l’image à afficher dans la galerie.

Notes

Le bouton du menu galerie s’affiche sous la forme d’un menu contextuel avec une flèche. Quand l'utilisateur clique sur ce bouton, une galerie d'images s'affiche.

Exemple

L’exemple suivant montre comment utiliser le constructeur de la CMFCRibbonGalleryMenuButton classe. Cet extrait de code fait partie de l’exemple de démonstration MS Office 2007.

// CMFCToolBarButton pExButton
CMFCRibbonGalleryMenuButton paletteBullet(pExButton->m_nID, pExButton->GetImage(), pExButton->m_strText);

CMFCRibbonGalleryMenuButton ::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Valeur de retour

Notes

CMFCRibbonGalleryMenuButton ::GetPalette

CMFCRibbonGallery& GetPalette();

Valeur de retour

Notes

CMFCRibbonGalleryMenuButton ::HasButton

virtual BOOL HasButton() const;

Valeur de retour

Notes

CMFCRibbonGalleryMenuButton ::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Valeur de retour

Notes

Voir aussi

Graphique hiérarchique
Classes
CMFCToolBarMenuButton, classe
CMFCRibbonGallery, classe