다음을 통해 공유


CMFCRibbonGalleryMenuButton 클래스

리본 갤러리가 포함된 리본 메뉴 단추를 구현합니다. 더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

구문

class CMFCRibbonGalleryMenuButton : public CMFCToolBarMenuButton

멤버

공용 생성자

속성 설명
CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton CMFCRibbonGalleryMenuButton 개체를 생성하고 초기화합니다.

공용 메서드

이름 설명
CMFCRibbonGalleryMenuButton::CopyFrom (재정의 CMFCToolBarMenuButton::CopyFrom.)
CMFCRibbonGalleryMenuButton::CreatePopupMenu (재정의 CMFCToolBarMenuButton::CreatePopupMenu.)
CMFCRibbonGalleryMenuButton::GetPalette
CMFCRibbonGalleryMenuButton::HasButton ( CMFCToolBarMenuButton::HasButton을 재정의합니다.)
CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed (재정의 CMFCToolBarMenuButton::IsEmptyMenuAllowed.)

설명

갤러리 메뉴 단추가 팝업 메뉴로 화살표와 함께 표시됩니다. 사용자가 이 단추를 클릭하면 이미지 갤러리가 표시됩니다. 갤러리 메뉴 단추를 생성하는 경우 이러한 이미지를 포함하는 이미지 목록을 지정해야 합니다.

예시

다음 예제에서는 메뉴 단추에 글머리 기호 갤러리를 표시하는 방법을 보여 줍니다.

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

상속 계층 구조

CObject
└ CMFCToolBarButton
└ CMFCToolBarMenuButton
  └ CMFCRibbonGalleryMenuButton

요구 사항

헤더: afxRibbonPaletteGallery.h

CMFCRibbonGalleryMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

매개 변수

[in] src

설명

CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton

CMFCRibbonGalleryMenuButton 개체를 생성하고 초기화합니다.

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

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

매개 변수

uiID
단추의 명령 ID입니다. 이 값은 사용자가 이 단추를 클릭할 때 WM_COMMAND 메시지에 전송되는 값입니다.

iImage
갤러리 메뉴 단추와 함께 표시할 이미지의 인덱스입니다. 이미지는 imagesPalette 매개 변수에 저장됩니다.

lpszText
메뉴 단추에 표시할 텍스트입니다.

imagesPalette
갤러리에 표시할 이미지 목록을 포함합니다.

uiImagesPaletteResID
갤러리에 표시할 이미지에 대한 이미지 목록의 리소스 ID입니다.

cxPaletteImage
갤러리에 표시할 이미지의 너비를 픽셀 단위로 지정합니다.

설명

갤러리 메뉴 단추는 화살표가 있는 팝업 메뉴로 표시됩니다. 사용자가 이 단추를 클릭하면 이미지 갤러리가 표시됩니다.

예시

다음 예제에서는 클래스의 생성자를 사용 하는 방법을 보여 줍니다 CMFCRibbonGalleryMenuButton . 이 코드 조각은 MS Office 2007 데모 샘플일부입니다.

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

CMFCRibbonGalleryMenuButton::CreatePopupMenu

virtual CMFCPopupMenu* CreatePopupMenu();

Return Value

설명

CMFCRibbonGalleryMenuButton::GetPalette

CMFCRibbonGallery& GetPalette();

Return Value

설명

CMFCRibbonGalleryMenuButton::HasButton

virtual BOOL HasButton() const;

Return Value

설명

CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed

virtual BOOL IsEmptyMenuAllowed() const;

Return Value

설명

참고 항목

계층 구조 차트
클래스
CMFCToolBarMenuButton 클래스
CMFCRibbonGallery 클래스