CMFCRibbonGalleryMenuButton-Klasse

Implementiert eine Menüband-Menüschaltfläche, die Menübandkataloge enthält. Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Syntax

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton Erstellt und initialisiert ein CMFCRibbonGalleryMenuButton-Objekt.

Öffentliche Methoden

Name Beschreibung
CMFCRibbonGalleryMenuButton::CopyFrom (Außerkraftsetzungen CMFCToolBarMenuButton::CopyFrom.)
CMFCRibbonGalleryMenuButton::CreatePopupMenu (Außerkraftsetzungen CMFCToolBarMenuButton::CreatePopupMenu.)
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton (Überschreibt CMFCToolBarMenuButton::HasButton.)
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed (Außerkraftsetzungen CMFCToolBarMenuButton::IsEmptyMenuAllowed.)

Hinweise

Die Katalogmenüschaltfläche wird als ein Popupmenü mit einem Pfeil angezeigt. Wenn der Benutzer auf diese Schaltfläche klickt, wird ein Katalog von Bildern angezeigt. Beim Erstellen einer Katalogmenüschaltfläche müssen Sie eine Bildliste angeben, die diese Bilder enthält.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie ein Katalog von Anführungszeichen in einer Menüschaltfläche angezeigt wird.

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);
    }
}

Vererbungshierarchie

CObject
└ CMFCToolBarButton
└ CMFCToolBarMenuButton
  └ CMFCRibbonGalleryMenuButton

Anforderungen

Kopfzeile: afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parameter

[in] Src

Hinweise

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

Erstellt und initialisiert ein CMFCRibbonGalleryMenuButton - Objekt.

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

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

Parameter

uiID
Die Befehls-ID der Schaltfläche. Dies ist der Wert, der in der WM_COMMAND Nachricht gesendet wird, wenn der Benutzer auf diese Schaltfläche klickt.

iImage
Der Index des Bilds, das mit der Menüschaltfläche "Katalog" angezeigt werden soll. Die Bilder werden im imagesPalette-Parameter gespeichert.

lpszText
Der Text, der auf der Menüschaltfläche angezeigt werden soll.

imagesPalette
Enthält die Liste der Bilder, die im Katalog angezeigt werden sollen.

uiImagesPaletteResID
Die Ressourcen-ID der Bildliste für die Bilder, die im Katalog angezeigt werden sollen.

cxPaletteImage
Gibt die Breite des Bilds in Pixel an, das im Katalog angezeigt werden soll.

Hinweise

Die Menüschaltfläche "Katalog" wird als Popupmenü mit einem Pfeil angezeigt. Wenn der Benutzer auf diese Schaltfläche klickt, wird ein Katalog von Bildern angezeigt.

Beispiel

Im folgenden Beispiel wird die Verwendung des Konstruktors der CMFCRibbonGalleryMenuButton Klasse veranschaulicht. Dieser Codeausschnitt ist Teil des MS Office 2007-Demobeispiels.

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

CMFCRibbonGalleryMenuButton::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Rückgabewert

Bemerkungen

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

Rückgabewert

Bemerkungen

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

Rückgabewert

Bemerkungen

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Rückgabewert

Bemerkungen

Weitere Informationen

Hierarchiediagramm
Klassen
CMFCToolBarMenuButton-Klasse
CMFCRibbonGallery-Klasse