Clase CMFCRibbonGalleryMenuButton

Implementa un botón de menú de la cinta que contiene galerías de la cinta. Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

Sintaxis

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Miembros

Constructores públicos

Nombre	Descripción
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton	Construye e inicializa un objeto CMFCRibbonGalleryMenuButton.

Métodos públicos

Nombre	Descripción
CMFCRibbonGalleryMenuButton::CopyFrom	(Invalida CMFCToolBarMenuButton::CopyFrom).
CMFCRibbonGalleryMenuButton::CreatePopupMenu	(Invalida CMFCToolBarMenuButton::CreatePopupMenu).
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton	(Invalida CMFCToolBarMenuButton::HasButton).
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed	(Invalida CMFCToolBarMenuButton::IsEmptyMenuAllowed).

Comentarios

El botón de menú de la galería se muestra como un menú emergente con una flecha. Cuando el usuario hace clic en este botón, se abre una galería de imágenes. Cuando se crea un botón de menú de la galería, hay que especificar una lista de imágenes que contenga esas imágenes.

Ejemplo

En el siguiente ejemplo se muestra cómo mostrar una galería de viñetas en un botón de menú:

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

Jerarquía de herencia

CObject
└ CMFCToolBarButton
 └ CMFCToolBarMenuButton
  └ CMFCRibbonGalleryMenuButton

Requisitos

Encabezado: afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parámetros

[in] src

Comentarios

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

Construye e inicializa un 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
Identificador de comando del botón. Este es el valor enviado en el mensaje WM_COMMAND cuando el usuario hace clic en este botón.

iImage
Índice de la imagen que se va a mostrar con el botón de menú galería. Las imágenes se almacenan en el parámetro imagesPalette.

lpszText
Texto que se va a mostrar en el botón del menú.

imagesPalette
Contiene la lista de imágenes que se van a mostrar en la galería.

uiImagesPaletteResID
Identificador de recurso de la lista de las imágenes que se van a mostrar en la galería.

cxPaletteImage
Especifica el ancho en píxeles de la imagen que se va a mostrar en la galería.

Comentarios

El botón de menú de la galería se muestra como un menú emergente que tiene una flecha. Cuando el usuario hace clic en este botón, se abre una galería de imágenes.

Ejemplo

En el ejemplo siguiente, se muestra cómo se utiliza el constructor de la clase CMFCRibbonGalleryMenuButton. Este fragmento de código forma parte del ejemplo de demostración de MS Office 2007.

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

CMFCRibbonGalleryMenuButton::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Valor devuelto

Comentarios

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

Valor devuelto

Comentarios

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

Valor devuelto

Comentarios

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Valor devuelto

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CMFCToolBarMenuButton (clase)
CMFCRibbonGallery (clase)