CMFCRibbonGalleryMenuButton Sınıfı

Uyarı

Microsoft Foundation Sınıfları (MFC) kitaplığına destek verilmeye devam ediliyor. Ancak artık özellik eklemeyeceğiz veya belgeleri güncelleştirmeyeceğiz.

Şerit galerileri içeren bir şerit menü düğmesi uygular. Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

Sözdizimi

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

Üyeler

Ortak Oluşturucular

Veri Akışı Adı Açıklama
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton Bir CMFCRibbonGalleryMenuButton nesneyi oluşturur ve başlatır.

Genel Yöntemler

Veri Akışı Adı Açıklama
CMFCRibbonGalleryMenuButton::CopyFrom (Geçersiz Kılmalar CMFCToolBarMenuButton::CopyFrom.)
CMFCRibbonGalleryMenuButton::CreatePopupMenu (Geçersiz Kılmalar CMFCToolBarMenuButton::CreatePopupMenu.)
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton (Geçersiz Kılmalar CMFCToolBarMenuButton::HasButton.)
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed (Geçersiz Kılmalar CMFCToolBarMenuButton::IsEmptyMenuAllowed.)

Açıklamalar

Galeri menü düğmesi, oklu bir açılır menü olarak görüntülenir. Kullanıcı bu düğmeye tıkladığında bir resim galerisi görüntülenir. Galeri menü düğmesi oluştururken, bu görüntüleri içeren bir resim listesi belirtmeniz gerekir.

Örnek

Aşağıdaki örnekte, menü düğmesinde madde işaretleri galerisinin nasıl görüntüleneceği gösterilmektedir:

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

Devralma Hiyerarşisi

CObject
└ CMFCToolBarButton
└ CMFCToolBarMenuButton
   └ CMFCRibbonGalleryMenuButton

Gereksinimler

Üst bilgi: afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametreler

[in] Src

Açıklamalar

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

CMFCRibbonGalleryMenuButton nesnesini oluşturur ve başlatır.

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

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

Parametreler

uiID
Düğmenin komut kimliği. Bu, kullanıcı bu düğmeye tıkladığında WM_COMMAND iletisinde gönderilen değerdir.

iImage
Galeri menü düğmesiyle görüntülenecek görüntünün dizini. Görüntüler imagesPalette parametresinde depolanır.

lpszText
Menü düğmesinde görüntülenecek metin.

imagesPalette
Galeride görüntülenecek görüntülerin listesini içerir.

uiImagesPaletteResID
Galeride görüntülenecek görüntülerin görüntü listesinin kaynak kimliği.

cxPaletteImage
Galeride görüntülenecek görüntünün piksel genişliğini belirtir.

Açıklamalar

Galeri menüsü düğmesi, oku olan bir açılır menü olarak görüntülenir. Kullanıcı bu düğmeye tıkladığında bir resim galerisi görüntülenir.

Örnek

Aşağıdaki örnekte sınıfının oluşturucusunun nasıl kullanılacağı gösterilmektedir CMFCRibbonGalleryMenuButton . Bu kod parçacığı MS Office 2007 Tanıtım örneğinin bir parçasıdır.

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

CMFCRibbonGalleryMenuButton::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Dönüş Değeri

Açıklamalar

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

Dönüş Değeri

Açıklamalar

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

Dönüş Değeri

Açıklamalar

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Dönüş Değeri

Açıklamalar

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCToolBarMenuButton Sınıfı
CMFCRibbonGallery Sınıfı