CMFCRibbonGallery 클래스

Office 2007 스타일의 리본 갤러리를 구현합니다. 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

구문

class CMFCRibbonGallery : public CMFCRibbonButton

멤버

공용 생성자

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

공용 메서드

이름	설명
CMFCRibbonGallery::AddGroup	갤러리에 새 그룹을 추가합니다.
CMFCRibbonGallery::AddSubItem	드롭다운 메뉴에 새 메뉴 항목을 추가합니다.
CMFCRibbonGallery::Clear	갤러리의 콘텐츠를 지웁니다.
CMFCRibbonGallery::EnableMenuResize	메뉴 패널의 크기 조정을 사용하거나 사용하지 않도록 설정합니다.
CMFCRibbonGallery::EnableMenuSideBar	팝업 메뉴 왼쪽의 사이드바를 사용하거나 사용하지 않도록 설정합니다.
CMFCRibbonGallery::GetCompactSize	(재정의 CMFCRibbonButton::GetCompactSize.)
CMFCRibbonGallery::GetDroppedDown	(재정의 CMFCRibbonBaseElement::GetDroppedDown.)
CMFCRibbonGallery::GetGroupName	지정된 인덱스 위치에 있는 그룹의 이름을 반환합니다.
CMFCRibbonGallery::GetGroupOffset
CMFCRibbonGallery::GetIconsInRow	리본 갤러리의 행에 있는 항목 수를 반환합니다.
CMFCRibbonGallery::GetItemToolTip	갤러리의 항목과 연결된 도구 설명 텍스트를 반환합니다.
CMFCRibbonGallery::GetLastSelectedItem	사용자가 선택한 갤러리의 마지막 항목 인덱스입니다.
CMFCRibbonGallery::GetPaletteID	현재 갤러리의 명령 ID를 반환합니다.
CMFCRibbonGallery::GetRegularSize	(재정의 CMFCRibbonButton::GetRegularSize.)
CMFCRibbonGallery::GetSelectedItem
CMFCRibbonGallery::HasMenu	(재정의 CMFCRibbonButton::HasMenu.)
CMFCRibbonGallery::IsButtonMode	갤러리 단추에 갤러리가 포함되는지 여부를 지정합니다.
CMFCRibbonGallery::IsMenuResizeEnabled	메뉴 크기 조정을 사용할지 여부를 지정합니다.
CMFCRibbonGallery::IsMenuResizeVertical
CMFCRibbonGallery::IsMenuSideBar	사이드바를 사용할지 여부를 지정합니다.
CMFCRibbonGallery::OnAfterChangeRect	( CMFCRibbonButton::OnAfterChangeRect을 재정의합니다.)
CMFCRibbonGallery::OnDraw	(재정의 CMFCRibbonButton::OnDraw.)
CMFCRibbonGallery::OnEnable	( CMFCRibbonBaseElement::OnEnable을 재정의합니다.)
CMFCRibbonGallery::OnRTLChanged	(재정의 CMFCRibbonBaseElement::OnRTLChanged.)
CMFCRibbonGallery::RedrawIcons	갤러리를 다시 그어 줍니다.
CMFCRibbonGallery::RemoveItemTool팁	갤러리의 모든 항목에서 도구 설명을 제거합니다.
CMFCRibbonGallery::SelectItem
CMFCRibbonGallery::SetACCData	(재정의 CMFCRibbonButton::SetACCData.)
CMFCRibbonGallery::SetButtonMode	리본 갤러리를 드롭다운 단추로 표시할지 또는 리본에 직접 색상표로 표시할지를 지정합니다.
CMFCRibbonGallery::SetGroupName	그룹의 이름을 설정합니다.
CMFCRibbonGallery::SetIconsInRow	갤러리의 행당 항목 수를 정의합니다.
CMFCRibbonGallery::SetItemToolTip	갤러리의 항목에 대한 도구 설명 텍스트를 설정합니다.
CMFCRibbonGallery::SetPalette	리본 갤러리에 색상표를 연결합니다.
CMFCRibbonGallery::SetPaletteID	갤러리 항목을 선택할 때 WM_COMMAND 메시지에서 전송되는 명령 ID를 정의합니다.

보호된 메서드

속성	설명
CMFCRibbonGallery::OnDrawPaletteIcon	갤러리 아이콘을 그릴 때 프레임워크에서 호출됩니다.

설명

갤러리 단추는 사용자가 갤러리를 열 때 갤러리를 표시한다는 점을 제외하고 일반 메뉴 단추처럼 동작합니다. 갤러리에서 항목을 선택하면 프레임워크는 단추의 명령 ID와 함께 WM_COMMAND 메시지를 보냅니다. 메시지를 처리할 때 CMFCRibbonGallery::GetLastSelectedItem을 호출하여 갤러리에서 선택한 항목을 결정해야 합니다.

예시

다음 예제에서는 클래스의 다양한 메서드를 사용하여 개체를 CMFCRibbonGalleryCMFCRibbonGallery 구성하는 방법을 보여 줍니다. 이 예제에서는 갤러리에서 행당 항목 수를 지정하고, 메뉴 패널의 크기를 조정할 수 있도록 설정하고, 팝업 메뉴 왼쪽에 사이드바를 사용하도록 설정하고, 리본 갤러리를 리본 표시줄에 직접 색상표로 표시하는 방법을 보여 줍니다. 이 코드 조각은 클라이언트 그리기 샘플의 일부입니다.

CMFCRibbonGallery *pBtnStyles = new CMFCRibbonGallery(ID_OBJECT_STYLES, _T("Styles\nk"), 0, 0, IDB_STYLES, 40);
pBtnStyles->SetIconsInRow(7);
pBtnStyles->EnableMenuResize(TRUE, TRUE);
pBtnStyles->EnableMenuSideBar();
pBtnStyles->SetButtonMode(false);
pBtnStyles->RedrawIcons();

상속 계층 구조

CObject
└ CMFCRibbonBaseElement
 └ CMFCRibbonButton
  └ CMFCRibbonGallery

요구 사항

헤더: afxRibbonPaletteGallery.h

CMFCRibbonGallery::AddGroup

갤러리에 새 그룹을 추가합니다.

void AddGroup(
    LPCTSTR lpszGroupName,
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

void AddGroup(
    LPCTSTR lpszGroupName,
    CMFCToolBarImages& imagesGroup);

void AddGroup(
    LPCTSTR lpszGroupName,
    int nIconsNum);

매개 변수

lpszGroupName
[in] 그룹의 이름을 지정합니다.

uiImagesPaletteResID
[in] 그룹에 대한 이미지가 포함된 이미지 목록의 리소스 ID를 지정합니다.

cxPaletteImage
[in] 이미지의 너비를 픽셀 단위로 지정합니다.

imagesGroup
[in] 그룹 이미지를 포함하는 이미지 목록에 대한 참조입니다.

nIconsNum
[in] 그룹의 아이콘 수를 지정합니다. 이 매개 변수는 사용자 지정(소유자 그리기) 그룹에 대해서만 지정해야 합니다.

설명

이 메서드를 호출하여 리본 갤러리의 항목을 여러 그룹으로 나눌 수 있습니다. 각 그룹에는 캡션 있을 수 있습니다.

CMFCRibbonGallery::AddSubItem

드롭다운 메뉴에 새 메뉴 항목을 추가합니다.

void AddSubItem(
    CMFCRibbonBaseElement* pSubItem,
    int nIndex=-1,
    BOOL bOnTop=FALSE);

매개 변수

pSubItem
[in] 메뉴에 추가할 항목에 대한 포인터입니다.

nIndex
[in] 항목을 삽입할 위치의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

bOnTop
[in] TRUE이면 리본 갤러리 앞에 항목을 삽입해야 합니다. 그렇지 않으면 FALSE입니다.

설명

이 메서드를 호출하여 팝업 갤러리를 팝업 메뉴 항목과 결합할 수 있습니다. 메뉴 항목은 갤러리 전후에 배치할 수 있습니다.

갤러리 앞에 항목을 삽입하려면 bOnTop을 TRUE로 설정합니다. 갤러리 아래에 항목을 삽입하려면 bOnTop을 FALSE로 설정합니다.

참고 항목

nIndex 매개 변수는 갤러리의 맨 위와 갤러리 맨 아래에 있는 삽입 인덱스를 지정합니다. 예를 들어 갤러리 앞에 항목 한 위치를 삽입해야 하는 경우 nIndex를 1로, bOnTop을 TRUE로 설정합니다. 마찬가지로 갤러리 아래에 항목 한 위치를 삽입해야 하는 경우 nIndex를 1로 설정하고 bOnTop을 FALSE로 설정합니다.

CMFCRibbonGallery::Clear

갤러리의 콘텐츠를 지웁니다.

virtual void Clear();

설명

리본 갤러리에서 모든 콘텐츠를 제거하려면 이 메서드를 호출합니다. 새 리본 갤러리 또는 그룹 집합을 리본 갤러리에 연결하기 전에 이 작업을 수행해야 합니다.

CMFCRibbonGallery::CMFCRibbonGallery

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

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CMFCToolBarImages& imagesPalette);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    UINT uiImagesPaletteResID=0,
    int cxPaletteImage=0);

CMFCRibbonGallery (
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    int nLargeImageIndex,
    CSize sizeIcon,
    int nIconsNum,
    BOOL bDefaultButtonStyle=TRUE);

매개 변수

nID
사용자가 단추를 클릭할 때 실행할 명령의 명령 ID를 지정합니다.

lpszText
단추에 표시할 텍스트를 지정합니다.

nSmallImageIndex
단추에 표시할 작은 이미지의 인덱스(0부터 시작하는 인덱스)입니다.

nLargeImageIndex
단추에 표시할 큰 이미지의 인덱스(0부터 시작하는 인덱스)입니다.

imagesPalette
갤러리에 표시할 이미지를 포함하는 CMFCToolBarImages 개체에 대한 참조입니다.

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

cxPaletteImage
갤러리에 있는 이미지의 너비(픽셀)를 지정합니다.

sizeIcon
갤러리 이미지의 크기를 픽셀 단위로 지정합니다.

nIconsNum
갤러리의 아이콘 수를 지정합니다.

bDefaultButtonStyle
기본값 또는 소유자가 그린 단추 스타일을 사용할지 여부를 지정합니다.

설명

CMFCRibbonGallery::EnableMenuResize

메뉴 패널의 크기 조정을 사용하거나 사용하지 않도록 설정합니다.

void EnableMenuResize(
    BOOL bEnable = TRUE,
    BOOL bVertcalOnly = FALSE);

매개 변수

bEnable
[in] TRUE이면 메뉴 크기를 조정할 수 있습니다. 그렇지 않으면 FALSE입니다.

bVertcalOnly
[in] TRUE이면 갤러리의 크기를 세로로만 조정할 수 있습니다. FALSE를 사용하여 갤러리의 크기를 세로 및 가로로 조정할 수 있습니다.

설명

리본 갤러리의 크기 조정을 사용하거나 사용하지 않도록 설정하려면 이 메서드를 사용합니다. 크기 조정을 사용하도록 설정하면 리본 갤러리에 사용자가 크기를 조정하는 데 사용할 수 있는 그리퍼가 표시됩니다.

CMFCRibbonGallery::EnableMenuSideBar

팝업 메뉴 왼쪽의 사이드바를 사용하거나 사용하지 않도록 설정합니다.

void EnablMenuSideBar(BOOL bEnable=TRUE);

매개 변수

bEnable
[in] 사이드바를 사용하도록 지정하려면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

메뉴 왼쪽에서 Office XP 스타일 사이드바를 사용하거나 사용하지 않도록 설정하려면 이 메서드를 호출합니다.

CMFCRibbonGallery::GetCompactSize

virtual CSize GetCompactSize(CDC* pDC);

매개 변수

[in] Pdc

Return Value

설명

CMFCRibbonGallery::GetDroppedDown

virtual CMFCRibbonBaseElement* GetDroppedDown();

Return Value

설명

CMFCRibbonGallery::GetGroupName

지정된 인덱스 위치에 있는 그룹의 이름을 반환합니다.

LPCTSTR GetGroupName(int nGroupIndex) const;

매개 변수

nGroupIndex
[in] 검색할 이름을 가진 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

Return Value

지정된 인덱스 위치에 있는 그룹의 이름입니다. 잘못된 인덱스가 전달되면 어설션이 실패합니다.

설명

CMFCRibbonGallery::GetGroupOffset

virtual int GetGroupOffset() const;

Return Value

설명

CMFCRibbonGallery::GetIconsInRow

리본 갤러리의 행에 있는 항목 수를 반환합니다.

int GetIconsInRow() const;

Return Value

행의 항목 수입니다.

설명

CMFCRibbonGallery::GetItemToolTip

갤러리의 항목과 연결된 도구 설명 텍스트를 반환합니다.

LPCTSTR GetItemToolTip(int nItemIndex) const;

매개 변수

nItemIndex
[in] 도구 설명 텍스트를 검색할 항목의 인덱스(0부터 시작)를 지정합니다.

Return Value

리본 갤러리의 항목에 할당된 도구 설명 문자열에 대한 포인터입니다. 해당 항목에 도구 설명이 할당되지 않은 경우 NULL일 수 있습니다.

설명

CMFCRibbonGallery::GetLastSelectedItem

사용자가 선택한 리본 갤러리의 마지막 항목 인덱스입니다.

static int GetLastSelectedItem(UINT uiCmdID);

매개 변수

uiCmdID
[in] 리본 갤러리를 연 메뉴 항목의 명령 ID를 지정합니다.

Return Value

사용자가 리본 갤러리에서 항목을 선택하면 라이브러리는 리본 갤러리를 연 메뉴 단추의 명령 ID와 함께 WM_COMMAND 메시지를 보냅니다.

설명

CMFCRibbonGallery::GetPaletteID

현재 색상표의 명령 ID를 반환합니다.

int GetPaletteID() const;

Return Value

현재 선택한 색상표의 명령 ID입니다.

설명

CMFCRibbonGallery::GetRegularSize

virtual CSize GetRegularSize(CDC* pDC);

매개 변수

[in] Pdc

Return Value

설명

CMFCRibbonGallery::GetSelectedItem

int GetSelectedItem() const;

Return Value

설명

CMFCRibbonGallery::HasMenu

virtual BOOL HasMenu() const;

Return Value

설명

CMFCRibbonGallery::IsButtonMode

색상표가 갤러리 단추에 포함되는지 여부를 지정합니다.

BOOL IsButtonMode() const;

Return Value

색상표가 드롭다운 메뉴 단추로 표시되는 경우 TRUE입니다. 색상표가 리본에 직접 표시되는 경우 FALSE입니다.

설명

CMFCRibbonGallery::IsMenuResizeEnabled

메뉴 크기 조정을 사용할지 여부를 지정합니다.

BOOL IsMenuResizeEnabled() const;

Return Value

메뉴 크기 조정이 설정된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonGallery::IsMenuResizeVertical

BOOL IsMenuResizeVertical() const;

Return Value

설명

CMFCRibbonGallery::IsMenuSideBar

사이드바를 사용할지 여부를 지정합니다.

BOOL IsMenuSideBar() const;

Return Value

True이면 Office XP 스타일 사이드바가 팝업 메뉴의 왼쪽에 그려집니다. 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonGallery::OnAfterChangeRect

virtual void OnAfterChangeRect(CDC* pDC);

매개 변수

[in] Pdc

설명

CMFCRibbonGallery::OnDraw

virtual void OnDraw(CDC* pDC);

매개 변수

[in] Pdc

설명

CMFCRibbonGallery::OnDrawPaletteIcon

갤러리 아이콘을 그릴 때 프레임워크에서 호출됩니다.

virtual void OnDrawPaletteIcon(
    CDC* pDC,
    CRect rectIcon,
    int nIconIndex,
    CMFCRibbonGalleryIcon* pIcon,
    COLORREF clrText);

매개 변수

pDC
[in] 그리기에 사용되는 디바이스 컨텍스트에 대한 포인터입니다.

rectIcon
[in] 그릴 아이콘의 경계 사각형을 지정합니다.

nIconIndex
[in] 그릴 아이콘의 갤러리 아이콘 이미지 목록에서 인덱스(0부터 시작하는 인덱스)를 지정합니다.

pIcon
[in] 그려지는 아이콘에 대한 포인터입니다.

clrText
[in] 그릴 항목의 텍스트 색을 지정합니다.

설명

파생 클래스에서 이 메서드를 재정의하여 리본 갤러리의 모양을 사용자 지정할 수 있습니다.

CMFCRibbonGallery::OnEnable

virtual void OnEnable(BOOL bEnable);

매개 변수

[in] bEnable

설명

CMFCRibbonGallery::OnRTLChanged

virtual void OnRTLChanged(BOOL bIsRTL);

매개 변수

[in] bIsRTL

설명

CMFCRibbonGallery::RedrawIcons

갤러리를 다시 그어 줍니다.

void RedrawIcons();

설명

갤러리를 다시 그리려면 이 함수를 호출합니다. 런타임에 갤러리의 콘텐츠를 변경한 경우 이 메서드를 호출해야 합니다.

CMFCRibbonGallery::RemoveItemTool팁

갤러리의 모든 항목에서 도구 설명을 제거합니다.

void RemoveItemToolTips();

설명

CMFCRibbonGallery::SelectItem

void SelectItem(int nItemIndex);

매개 변수

[in] nItemIndex

설명

CMFCRibbonGallery::SetACCData

리본 갤러리에서 내게 필요한 옵션 데이터를 사용하여 지정된 CAccessibilityData 개체를 채웁니다.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

매개 변수

pParent
[in] 리본 갤러리 창의 부모 창입니다.

data
[out] CAccessibilityData 리본 갤러리에서 접근성 데이터를 받는 개체입니다.

Return Value

설명

메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.

CMFCRibbonGallery::SetButtonMode

리본 갤러리를 드롭다운 단추로 표시할지 또는 리본에 직접 색상표로 표시할지 여부를 결정합니다.

void SetButtonMode(BOOL bSet=TRUE);

매개 변수

bSet
[in] TRUE이면 리본 갤러리를 드롭다운 메뉴 단추로 표시합니다. 리본 메뉴에 리본 갤러리의 내용을 직접 표시하려면 FALSE입니다.

설명

CMFCRibbonGallery::SetGroupName

그룹의 이름을 설정합니다.

void SetGroupName(
    int nGroupIndex,
    LPCTSTR lpszGroupName);

매개 변수

nGroupIndex
[in] 이름이 변경되는 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

lpszGroupName
[in] 그룹의 새 이름을 지정합니다.

설명

이름이 변경되는 그룹은 CMFCRibbonGallery::AddGroup 메서드를 사용하여 추가되어야 합니다.

CMFCRibbonGallery::SetIconsInRow

갤러리의 행당 항목 수를 지정합니다.

void SetIconsInRow(int nIconsInRow);

매개 변수

nIconsInRow
[in] 갤러리의 각 행에 표시할 항목 수를 지정합니다.

설명

리본 갤러리의 너비를 지정하려면 이 메서드를 사용합니다.

CMFCRibbonGallery::SetItemToolTip

갤러리의 항목에 대한 도구 설명 텍스트를 설정합니다.

void SetItemToolTip(
    int nItemIndex,
    LPCTSTR lpszToolTip);

매개 변수

nItemIndex
[in] 도구 설명을 연결할 색상표 항목의 인덱스(0부터 시작)입니다.

lpszToolTip
[in] 도구 설명에 표시할 텍스트입니다.

설명

CMFCRibbonGallery::SetPalette

리본 갤러리에 색상표를 연결합니다.

void SetPalette(CMFCToolBarImages& imagesPalette);

void SetPalette(
    UINT uiImagesPaletteResID,
    int cxPaletteImage);

매개 변수

imagesPalette
[in] 갤러리에 표시할 아이콘이 포함된 이미지 목록을 지정합니다.

uiImagesPaletteResID
[in] 갤러리에 표시할 아이콘이 포함된 이미지 목록의 리소스 ID를 지정합니다.

cxPaletteImage
[in] 갤러리에 있는 이미지의 너비(픽셀)를 지정합니다.

설명

CMFCRibbonGallery::SetPaletteID

사용자가 갤러리 항목을 선택할 때 WM_COMMAND 메시지에 전송되는 명령 ID를 정의합니다.

void SetPaletteID(UINT nID);

매개 변수

nID
[in] 사용자가 갤러리 항목을 선택할 때 WM_COMMAND 메시지에서 전송되는 명령 ID를 지정합니다.

설명

사용자가 갤러리에서 선택한 특정 항목을 확인하려면 CMFCRibbonGallery::GetLastSelectedItem 정적 메서드를 호출합니다.

참고 항목

계층 구조 차트
클래스
CMFCRibbonButton 클래스
CMFCRibbonGalleryMenuButton 클래스