Classe CMFCRibbonGalleryMenuButton

Implementa un pulsante di menu della barra multifunzione contenente raccolte della barra multifunzione. Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Sintassi

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Membri

Costruttori pubblici

Nome	Descrizione
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton	Costruisce e inizializza un oggetto CMFCRibbonGalleryMenuButton.

Metodi pubblici

Nome	Descrizione
CMFCRibbonGalleryMenuButton::CopyFrom	(sostituzioni )CMFCToolBarMenuButton::CopyFrom.
CMFCRibbonGalleryMenuButton::CreatePopupMenu	(sostituzioni )CMFCToolBarMenuButton::CreatePopupMenu.)
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton	Esegue l'override di CMFCToolBarMenuButton::HasButton.
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed	(sostituzioni )CMFCToolBarMenuButton::IsEmptyMenuAllowed.

Osservazioni:

Il pulsante di menu della raccolta viene visualizzato come un menu a comparsa con una freccia. Quando l'utente fa clic su questo pulsante, viene visualizzata una raccolta di immagini. Quando si crea un pulsante di menu della raccolta, è necessario specificare un elenco di immagini che contiene le immagini.

Esempio

Nell'esempio seguente viene illustrato come visualizzare una raccolta di elenchi puntati in un pulsante di 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);
    }
}

Gerarchia di ereditarietà

CObject
└ CMFCToolBarButton
 └ CMFCToolBarMenuButton
  └ CMFCRibbonGalleryMenuButton

Requisiti

Intestazione: afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametri

[in] Src

Osservazioni:

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

Costruisce e inizializza un oggetto CMFCRibbonGalleryMenuButton .

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

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

Parametri

uiID
ID del comando del pulsante. Questo è il valore inviato nel messaggio WM_COMMAND quando l'utente fa clic su questo pulsante.

iImage
Indice dell'immagine da visualizzare con il pulsante di menu della raccolta. Le immagini vengono archiviate nel parametro imagesPalette .

lpszText
Testo da visualizzare sul pulsante del menu.

imagesPalette
Contiene l'elenco di immagini da visualizzare nella raccolta.

uiImagesPaletteResID
ID risorsa dell'elenco di immagini da visualizzare nella raccolta.

cxPaletteImage
Specifica la larghezza in pixel dell'immagine da visualizzare nella raccolta.

Osservazioni:

Il pulsante del menu della raccolta viene visualizzato come menu a comparsa con una freccia. Quando l'utente fa clic su questo pulsante, viene visualizzata una raccolta di immagini.

Esempio

Nell'esempio seguente viene illustrato come usare il costruttore della CMFCRibbonGalleryMenuButton classe . Questo frammento di codice fa parte dell'esempio demo di MS Office 2007.

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

CMFCRibbonGalleryMenuButton::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Valore restituito

Osservazioni:

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

Valore restituito

Osservazioni:

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

Valore restituito

Osservazioni:

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Valore restituito

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCToolBarMenuButton
Classe CMFCRibbonGallery