Compartilhar via

Classe CMFCRibbonGalleryMenuButton

  • Artigo

Implementa um botão de menu da faixa de opções que contém galerias de faixa de opções. Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Sintaxe

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Membros

Construtores públicos

Nome Descrição
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton Constrói e inicializa um objeto CMFCRibbonGalleryMenuButton.

Métodos públicos

Nome Descrição
CMFCRibbonGalleryMenuButton::CopyFrom (Substitui CMFCToolBarMenuButton::CopyFrom.)
CMFCRibbonGalleryMenuButton::CreatePopupMenu (Substitui CMFCToolBarMenuButton::CreatePopupMenu.)
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton (Substitui CMFCToolBarMenuButton::HasButton.)
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed (Substitui CMFCToolBarMenuButton::IsEmptyMenuAllowed.)

Comentários

O botão de menu da galeria é exibido como um menu pop-up com uma seta. Quando o usuário clica nesse botão, uma galeria de imagens é exibida. Ao construir um botão de menu da galeria, você deve especificar uma lista de imagens que contenha essas imagens.

Exemplo

O exemplo a seguir demonstra como exibir uma galeria de marcadores em um botão 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);
    }
}

Hierarquia de herança

CObject
└ CMFCToolBarButton
 └ CMFCToolBarMenuButton
  └ CMFCRibbonGalleryMenuButton

Requisitos

Cabeçalho: afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parâmetros

[in] src

Comentários

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

Constrói e inicializa um objeto CMFCRibbonGalleryMenuButton.

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

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

Parâmetros

uiID
A ID de comando do botão. Esse é o valor enviado na mensagem WM_COMMAND quando o usuário clica nesse botão.

iImage
O índice da imagem a ser exibida com o botão de menu da galeria. As imagens são armazenadas no parâmetro imagesPalette.

lpszTexto
O texto a ser exibido no item de menu.

imagesPalette
Contém a lista de imagens a serem exibidas na galeria.

uiImagesPaletteResID
A ID do recurso da lista de imagens para as imagens a serem exibidas na galeria.

cxPaletteImage
Especifica a largura em pixels da imagem a ser exibida na galeria.

Comentários

O botão de menu da galeria é exibido como um menu pop-up com uma seta. Quando o usuário clica nesse botão, uma galeria de imagens é exibida.

Exemplo

O exemplo a seguir demonstra como usar o construtor da classe CMFCRibbonGalleryMenuButton. Este snippet de código faz parte do exemplo de Demonstração do MS Office 2007.

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

CMFCRibbonGalleryMenuButton::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Valor de retorno

Comentários

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

Valor de retorno

Comentários

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

Valor de retorno

Comentários

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Valor de retorno

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CMFCToolBarMenuButton
Classe CMFCRibbonGallery