Udostępnij za pośrednictwem


Klasa CMFCRibbonGalleryMenuButton

Implementuje przycisk menu wstążki zawierający galerie wstążki. Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

Składnia

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton Tworzy i inicjuje CMFCRibbonGalleryMenuButton obiekt.

Metody publiczne

Nazwa/nazwisko opis
CMFCRibbonGalleryMenuButton::CopyFrom (Przesłonięcia) CMFCToolBarMenuButton::CopyFrom.)
CMFCRibbonGalleryMenuButton::CreatePopupMenu (Przesłonięcia) CMFCToolBarMenuButton::CreatePopupMenu.
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton (Przesłania CMFCToolBarMenuButton::HasButton).
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed (Przesłonięcia) CMFCToolBarMenuButton::IsEmptyMenuAllowed.

Uwagi

Przycisk menu galerii jest wyświetlany jako menu podręczne ze strzałką. Gdy użytkownik kliknie ten przycisk, zostanie wyświetlona galeria obrazów. Podczas tworzenia przycisku menu galerii należy określić listę obrazów zawierającą te obrazy.

Przykład

W poniższym przykładzie pokazano, jak wyświetlić galerię punktorów w przycisku 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);
    }
}

Hierarchia dziedziczenia

Obiekt CObject
└ CMFCToolBarButton
└ CMFCToolBarMenuButton
  └ CMFCRibbonGalleryMenuButton

Wymagania

Nagłówek: afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametry

[in] Src

Uwagi

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

Tworzy i inicjuje obiekt CMFCRibbonGalleryMenuButton .

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

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

Parametry

identyfikator uiID
Identyfikator polecenia przycisku. Jest to wartość wysłana w komunikacie WM_COMMAND, gdy użytkownik kliknie ten przycisk.

iImage
Indeks obrazu do wyświetlenia za pomocą przycisku menu galerii. Obrazy są przechowywane w parametrze imagesPalette .

lpszText
Tekst do wyświetlenia na przycisku menu.

imagesPalette
Zawiera listę obrazów do wyświetlenia w galerii.

uiImagesPaletteResID
Identyfikator zasobu listy obrazów do wyświetlenia w galerii.

cxPaletteImage
Określa szerokość obrazu do wyświetlenia w galerii w pikselach.

Uwagi

Przycisk menu galerii jest wyświetlany jako menu podręczne zawierające strzałkę. Gdy użytkownik kliknie ten przycisk, zostanie wyświetlona galeria obrazów.

Przykład

W poniższym przykładzie pokazano, jak używać konstruktora CMFCRibbonGalleryMenuButton klasy . Ten fragment kodu jest częścią przykładu pokazowego pakietu MS Office 2007.

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

CMFCRibbonGalleryMenuButton::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Wartość zwracana

Uwagi

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

Wartość zwracana

Uwagi

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

Wartość zwracana

Uwagi

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Wartość zwracana

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCToolBarMenuButton
Klasa CMFCRibbonGallery