Partilhar via

CMFCRibbonGalleryMenuButton Class

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Implementa um botão de menu de fita que contém galerias de fitas. Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Membros

Construtores Públicos

Nome Description
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton Constrói e inicializa um CMFCRibbonGalleryMenuButton objeto.

Métodos Públicos

Nome Description
CMFCRibbonGalleryMenuButton::CopyFrom (Sobrepõe o CMFCToolBarMenuButton::CopyFrom.)
CMFCRibbonGalleryMenuButton::CriarMenuPopupMenu (Sobrepõe o CMFCToolBarMenuButton::CreatePopupMenu.)
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton (Anula CMFCToolBarMenuButton::HasButton.)
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed (Sobrepõe o CMFCToolBarMenuButton::IsEmptyMenuAllowed.)

Observações

O botão do menu da galeria é apresentado como um menu pop-up com uma seta. Quando o utilizador clica neste botão, é exibida uma galeria de imagens. Quando constrói um botão de menu de galeria, deve especificar uma lista de imagens que contenha essas imagens.

Example

O exemplo seguinte demonstra como exibir uma galeria de pontos num 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

Requerimentos

Cabeçalho: afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parâmetros

[dentro] src

Observações

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
O ID do comando do botão. Este é o valor enviado na mensagem WM_COMMAND quando o utilizador clica neste botão.

iImage
O índice da imagem para mostrar com o botão do menu da galeria. As imagens são armazenadas no parâmetro imagesPalette .

lpszText
O texto para mostrar no botão do menu.

imagesPalette
Contém a lista de imagens para exibir na galeria.

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

cxPaletteImage
Especifica a largura em píxeis da imagem a mostrar na galeria.

Observações

O botão do menu da galeria é apresentado como um menu pop-up com uma seta. Quando o utilizador clica neste botão, é exibida uma galeria de imagens.

Example

O exemplo seguinte demonstra como usar o construtor da CMFCRibbonGalleryMenuButton classe. Este excerto 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::CriarMenuPopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Valor de retorno

Observações

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

Valor de retorno

Observações

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

Valor de retorno

Observações

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Valor de retorno

Observações

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCToolBarMenuButton
Classe CMFCRibbonGaleria

  • Last updated on