다음을 통해 공유


CMFCRibbonCategory 클래스

클래스는 CMFCRibbonCategory 리본 패널 그룹을 포함하는 리본 탭을 구현합니다.

구문

class CMFCRibbonCategory : public CObject

멤버

보호된 생성자

속성 설명
CMFCRibbonCategory::CMFCRibbonCategory 생성자입니다.

공용 메서드

이름 설명
CMFCRibbonCategory::AddHidden 리본 범주에 숨겨진 요소를 추가합니다.
CMFCRibbonCategory::AddPanel 리본 범주에 새 패널을 추가합니다.
CMFCRibbonCategory::CopyFrom
CMFCRibbonCategory::FindByData
CMFCRibbonCategory::FindByID
CMFCRibbonCategory::FindPanelWithElem
CMFCRibbonCategory::GetContextID 리본 범주의 컨텍스트 ID를 반환합니다.
CMFCRibbonCategory::GetData 리본 범주와 연결된 사용자 정의 데이터를 반환합니다.
CMFCRibbonCategory::GetDroppedDown
CMFCRibbonCategory::GetElements
CMFCRibbonCategory::GetElementsByID
CMFCRibbonCategory::GetFirstVisibleElement 리본 범주에 속하는 첫 번째 표시 요소를 가져옵니다.
CMFCRibbonCategory::GetFocused 포커스가 지정된 요소를 반환합니다.
CMFCRibbonCategory::GetHighlighted 강조 표시된 요소를 반환합니다.
CMFCRibbonCategory::GetImageCount
CMFCRibbonCategory::GetImageSize
CMFCRibbonCategory::GetItemIDsList
CMFCRibbonCategory::GetLastVisibleElement 리본 범주에 속하는 마지막으로 표시되는 요소 가져오기
CMFCRibbonCategory::GetLargeImages 리본 범주에서 사용하는 큰 이미지 목록에 대한 참조를 반환합니다.
CMFCRibbonCategory::GetMaxHeight
CMFCRibbonCategory::GetName
CMFCRibbonCategory::GetPanel 지정된 인덱스 위치에 있는 리본 패널에 대한 포인터를 반환합니다.
CMFCRibbonCategory::GetPanelCount 리본 범주의 리본 패널 수를 반환합니다.
CMFCRibbonCategory::GetPanelFromPoint
CMFCRibbonCategory::GetPanelIndex 지정한 리본 패널의 인덱스 값을 반환합니다.
CMFCRibbonCategory::GetParentButton
CMFCRibbonCategory::GetParentMenuBar
CMFCRibbonCategory::GetParentRibbonBar
CMFCRibbonCategory::GetRect
CMFCRibbonCategory::GetSmallImages 범주에서 사용하는 작은 이미지 목록에 대한 참조를 반환합니다.
CMFCRibbonCategory::GetTabColor 리본 범주 탭의 현재 색을 반환합니다.
CMFCRibbonCategory::GetTabRect
CMFCRibbonCategory::GetTextTopLine
CMFCRibbonCategory::GetVisibleElements 리본 범주에 속하는 표시되는 모든 요소를 가져옵니다.
CMFCRibbonCategory::HighlightPanel
CMFCRibbonCategory::HitTest
CMFCRibbonCategory::HitTestEx
CMFCRibbonCategory::HitTestScrollButtons
CMFCRibbonCategory::IsActive
CMFCRibbonCategory::IsVisible 리본 범주가 표시되는지 여부를 결정합니다.
CMFCRibbonCategory::IsWindows7Look 부모 리본에 Windows 7 스타일 모양(작은 사각형 응용 프로그램 단추)이 있는지 여부를 나타냅니다.
CMFCRibbonCategory::NotifyControlCommand
CMFCRibbonCategory::OnCancelMode
CMFCRibbonCategory::OnDraw
CMFCRibbonCategory::OnDrawImage
CMFCRibbonCategory::OnDrawMenuBorder
CMFCRibbonCategory::OnKey 사용자가 키보드 단추를 누를 때 프레임워크에서 호출됩니다.
CMFCRibbonCategory::OnLButtonDown
CMFCRibbonCategory::OnLButtonUp
CMFCRibbonCategory::OnMouseMove
CMFCRibbonCategory::OnRTLChanged
CMFCRibbonCategory::OnScrollHorz
CMFCRibbonCategory::OnUpdateCmdUI
CMFCRibbonCategory::RecalcLayout
CMFCRibbonCategory::RemovePanel
CMFCRibbonCategory::ReposPanels
CMFCRibbonCategory::SetCollapseOrder 리본 범주에 있는 리본 패널의 축소 순서를 정의합니다.
CMFCRibbonCategory::SetData 리본 범주에 사용자 정의 데이터를 저장합니다.
CMFCRibbonCategory::SetKeys 리본 범주에 키 설명을 할당합니다.
CMFCRibbonCategory::SetName
CMFCRibbonCategory::SetTabColor 리본 범주의 색을 설정합니다.

설명

일반적으로 CMFCRibbonBar::AddCategory를 호출하여 리본 범주를 간접적으로 만듭니다. 이 범주는 새로 만든 리본 범주에 대한 포인터를 반환합니다. CMFCRibbonCategory::AddPanel을 호출하여 범주에 패널을 추가합니다.

클래스는 CMFCRibbonTab 리본 범주를 그립니다. CMFCRibbonBaseElement 클래스에서 파생됩니다.

다음 예제에서는 리본 범주를 만들고 패널을 추가하는 방법을 보여 줍니다.

// Create a new ribbon category and get a pointer to it`
CMFCRibbonCategory* pCategory = m_wndRibbonBar.AddCategory
    (_T("&Write"),           // Category name
    IDB_WRITE,               // Category small images (16 x 16)
    IDB_WRITE_LARGE);        // Category large images (32 x 32)

// Add a panel to the new category
CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"),                // Panel name
    m_PanelIcons.ExtractIcon (0));  // Panel icon

다음 다이어그램은 RibbonApp 샘플 애플리케이션의 홈 범주 그림을 보여 줍니다.

RibbonApp 샘플 애플리케이션의 홈 범주입니다.

상속 계층 구조

CObject

CMFCRibbonCategory

요구 사항

헤더: afxribboncategory.h

CMFCRibbonCategory::AddHidden

지정한 리본 요소를 사용자 지정 대화 상자에 표시되는 리본 요소 배열에 추가합니다.

void AddHidden(CMFCRibbonBaseElement* pElem);

매개 변수

pElem
[in] 리본 요소에 대한 포인터입니다.

설명

사용자 지정 대화 상자의 리본 요소는 빠른 실행 도구 모음에 추가할 수 있는 명령입니다.

CMFCRibbonCategory::AddPanel

리본 범주에 대한 리본 패널을 만듭니다.

CMFCRibbonPanel* AddPanel(
    LPCTSTR lpszPanelName,
    HICON hIcon = 0,
    CRuntimeClass* pRTI = NULL);

매개 변수

lpszPanelName
[in] 새 리본 패널의 이름에 대한 포인터입니다.

hIcon
[in] 새 리본 패널의 기본 아이콘에 대한 핸들입니다.

pRTI
[in] 사용자 지정 리본 패널에 대한 런타임 클래스 정보에 대한 포인터입니다.

Return Value

메서드가 성공한 경우 새 리본 패널에 대한 포인터입니다. 그렇지 않으면 패널이 만들어지지 않은 경우 NULL입니다.

설명

사용자 지정 리본 패널을 만들려면 pRTI에서 해당 런타임 클래스 정보를 지정해야 합니다. 사용자 지정 리본 패널 클래스는 클래스에서 CMFCRibbonPanel 파생되어야 합니다.

리본 메뉴 요소를 표시할 공간이 부족한 경우 리본 패널의 기본 아이콘이 표시됩니다.

예시

다음 예제에서는 클래스에서 메서드를 AddPanel 사용 하는 방법을 보여 줍니다 CMFCRibbonCategory .

// Create "Favorites" panel:
strTemp.LoadString(IDS_RIBBON_FAVORITES);
// CMFCRibbonCategory* pCategoryCustom
CMFCRibbonPanel *pPanelFavorites = pCategoryCustom->AddPanel(strTemp,
                                                             m_PanelImages.ExtractIcon(15));

CMFCRibbonCategory::CMFCRibbonCategory

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

CMFCRibbonCategory(
    CMFCRibbonBar* pParenrRibbonBar,
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32));

매개 변수

pParenrRibbonBar
[in] 리본 범주의 부모 리본 표시줄에 대한 포인터입니다.

lpszName
[in] 리본 범주의 이름입니다.

uiSmallImagesResID
[in] 리본 범주의 리본 요소에서 사용하는 작은 이미지에 대한 이미지 목록의 리소스 ID입니다.

uiLargeImagesResID
[in] 리본 범주의 리본 요소에서 사용되는 큰 이미지에 대한 이미지 목록의 리소스 ID입니다.

sizeSmallImage
[in] 리본 범주의 리본 요소에 대한 작은 이미지의 기본 크기입니다.

sizeLargeImage
[in] 리본 범주의 리본 요소에 대한 큰 이미지의 기본 크기입니다.

CMFCRibbonCategory::CopyFrom

지정된 CMFCRibbonCategory 의 상태를 현재 CMFCRibbonCategory 개체에 복사합니다.

virtual void CopyFrom(CMFCRibbonCategory& src);

매개 변수

src
[in] 원본 CMFCRibbonCategory 개체입니다.

설명

CMFCRibbonCategory::FindByData

지정된 데이터와 연결된 리본 요소를 검색합니다.

CMFCRibbonBaseElement* FindByData(
    DWORD_PTR dwData,
    BOOL bVisibleOnly = TRUE) const;

매개 변수

dwData
[in] 리본 요소와 연결된 데이터입니다.

bVisibleOnly
[in] 검색에 빠른 액세스 리본 요소를 포함하려면 TRUE입니다. 검색에서 빠른 액세스 리본 요소를 제외하려면 FALSE입니다.

Return Value

메서드가 성공한 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

CMFCRibbonCategory::FindByID

지정된 명령 ID와 연결된 리본 요소를 검색합니다.

CMFCRibbonBaseElement* FindByID(
    UINT uiCmdID,
    BOOL bVisibleOnly = TRUE) const;

매개 변수

uiCmdID
[in] 리본 요소와 연결된 명령 ID입니다.

bVisibleOnly
[in] 검색에 빠른 액세스 리본 요소를 포함하려면 TRUE입니다. 검색에서 빠른 액세스 리본 요소를 제외하려면 FALSE입니다.

Return Value

메서드가 성공한 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

CMFCRibbonCategory::FindPanelWithElem

지정된 리본 요소가 포함된 리본 패널을 검색합니다.

CMFCRibbonPanel* FindPanelWithElem(const CMFCRibbonBaseElement* pElement);

매개 변수

pElement
[in] 리본 요소에 대한 포인터입니다.

Return Value

메서드가 성공한 경우 리본 패널에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

CMFCRibbonCategory::GetContextID

리본 범주의 컨텍스트 ID를 검색합니다.

UINT GetContextID() const;

Return Value

리본 범주의 컨텍스트 ID입니다.

설명

리본 범주가 컨텍스트 리본 범주가 아닌 경우 컨텍스트 ID는 0입니다.

CMFCRibbonCategory::GetData

리본 범주와 연결된 사용자 정의 데이터를 검색합니다.

DWORD_PTR GetData() const;

Return Value

리본 범주와 연결된 사용자 정의 데이터입니다.

CMFCRibbonCategory::GetDroppedDown

현재 팝업 메뉴가 표시된 리본 요소에 대한 포인터를 검색합니다.

CMFCRibbonBaseElement* GetDroppedDown();

Return Value

메서드가 성공한 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

CMFCRibbonCategory::GetElements

리본 범주의 모든 리본 요소를 검색합니다.

void GetElements(
    CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

매개 변수

arElements
[in, out] 리본 요소의 CArray에 대한 참조입니다.

설명

빠른 실행 도구 모음에서 사용하도록 설계된 리본 요소가 배열에 포함됩니다.

CMFCRibbonCategory::GetElementsByID

지정된 명령 ID와 연결된 모든 리본 요소를 검색합니다.

void GetElementsByID(
    UINT uiCmdID,
    CArray <CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);

매개 변수

uiCmdID
[in] 리본 요소와 연결된 명령 ID입니다.

arElements
[in, out] 리본 요소의 CArray에 대한 참조입니다.

설명

빠른 실행 도구 모음에서 사용하도록 설계된 리본 요소가 배열에 포함됩니다.

CMFCRibbonCategory::GetFirstVisibleElement

리본 범주에 속하는 첫 번째 표시 요소를 검색합니다.

CMFCRibbonBaseElement* GetFirstVisibleElement() const;

Return Value

첫 번째 표시되는 요소에 대한 포인터입니다. 범주에 표시되는 요소가 없는 경우 NULL일 수 있습니다.

설명

CMFCRibbonCategory::GetFocused

포커스가 지정된 요소를 반환합니다.

CMFCRibbonBaseElement* GetFocused();

Return Value

포커스가 있는 요소 또는 NULL에 대한 포인터입니다.

설명

CMFCRibbonCategory::GetHighlighted

강조 표시된 요소를 반환합니다.

CMFCRibbonBaseElement* GetHighlighted();

Return Value

강조 표시된 요소에 대한 포인터이거나, 강조 표시된 요소가 없는 경우 NULL입니다.

설명

CMFCRibbonCategory::GetImageCount

리본 범주에 포함된 지정된 이미지 목록의 이미지 수를 검색합니다.

int GetImageCount(BOOL bIsLargeImage) const;

매개 변수

bIsLargeImage
[in] 큰 이미지 목록의 이미지 수에 대해 TRUE입니다. 작은 이미지 목록의 이미지 수에 대한 FALSE입니다.

Return Value

지정된 이미지 목록의 이미지 수입니다.

설명

CMFCRibbonCategory::GetImageSize

리본 범주에 포함된 지정된 이미지 목록에서 이미지의 크기를 검색합니다.

CSize GetImageSize(BOOL bIsLargeImage) const;

매개 변수

bIsLargeImage
[in] 큰 이미지의 크기에 대한 TRUE입니다. 작은 이미지의 크기에 대한 FALSE입니다.

Return Value

지정된 이미지 목록에 있는 이미지의 크기입니다.

설명

검색된 크기에는 전역 이미지 배율 인수가 포함됩니다.

CMFCRibbonCategory::GetItemIDsList

리본 범주에 포함된 리본 요소의 명령 ID를 검색합니다.

void GetItemIDsList(
    CList<UINT, UINT>& lstItems,
    BOOL bHiddenOnly = FALSE) const;

매개 변수

lstItems
[out] 리본 범주의 리본 요소에 대한 명령 ID 목록입니다.

bHiddenOnly
[in] TRUE이면 리본 메뉴 범주의 리본 패널에 표시되는 리본 요소를 제외합니다. FALSE- 리본 범주에 모든 리본 요소를 포함합니다.

설명

CMFCRibbonCategory::GetLargeImages

리본 범주에 포함된 큰 이미지 목록을 검색합니다.

CMFCToolBarImages& GetLargeImages();

Return Value

리본 범주에 포함된 큰 이미지 목록입니다.

CMFCRibbonCategory::GetLastVisibleElement

리본 범주에 속하는 마지막으로 표시되는 요소를 검색합니다.

CMFCRibbonBaseElement* GetLastVisibleElement() const;

Return Value

마지막으로 표시되는 요소에 대한 포인터입니다. 범주에 표시되는 요소가 없는 경우 NULL일 수 있습니다.

설명

CMFCRibbonCategory::GetMaxHeight

리본 범주에 포함된 리본 패널의 최대 높이를 검색합니다.

int GetMaxHeight(CDC* pDC);

매개 변수

pDC
[in] 리본 패널의 디바이스 컨텍스트에 대한 포인터입니다.

Return Value

리본 범주에 포함된 리본 패널의 최대 높이입니다.

설명

검색된 값에는 리본 패널의 위쪽 및 아래쪽 여백 높이가 포함됩니다.

CMFCRibbonCategory::GetName

리본 범주의 이름을 검색합니다.

LPCTSTR GetName() const;

Return Value

리본 범주의 이름입니다.

설명

CMFCRibbonCategory::GetPanel

지정된 인덱스 위치에 있는 리본 패널에 대한 포인터를 반환합니다.

CMFCRibbonPanel* GetPanel(int nIndex);

매개 변수

nIndex
[in] 리본 패널의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

지정된 인덱스 위치에 있는 리본 패널에 대한 포인터입니다.

설명

nIndex가 범위를 벗어나면 예외가 throw됩니다.

CMFCRibbonCategory::GetPanelCount

리본 범주의 리본 패널 수를 반환합니다.

int GetPanelCount() const;

Return Value

리본 범주의 리본 패널 수입니다.

CMFCRibbonCategory::GetPanelFromPoint

지정한 점이 있는 경우 리본 패널에 대한 포인터를 검색합니다.

CMFCRibbonPanel* GetPanelFromPoint(CPoint point) const;

매개 변수

point
[in] 창의 왼쪽 위 모서리를 기준으로 포인터의 x 및 y 좌표입니다.

Return Value

메서드가 성공한 경우 리본 패널에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

리본 범주에 포함된 리본 패널만 테스트됩니다.

CMFCRibbonCategory::GetPanelIndex

지정된 리본 패널의 인덱스(0부터 시작하는 인덱스)를 검색합니다.

int GetPanelIndex(const CMFCRibbonPanel* pPanel) const;

매개 변수

pPanel
[in] 리본 패널에 대한 포인터입니다.

Return Value

메서드가 성공한 경우 지정된 리본 패널의 인덱스(0부터 시작하는 인덱스)입니다. 그렇지 않으면 -1입니다.

설명

리본 범주에 포함된 리본 패널만 검색됩니다.

CMFCRibbonCategory::GetParentButton

리본 범주의 부모 리본 요소를 검색합니다.

CMFCRibbonBaseElement* GetParentButton() const;

Return Value

부모 리본 요소에 대한 포인터를 반환하거나 부모 요소가 없는 경우 NULL을 반환합니다.

설명

CMFCRibbonCategory::GetParentMenuBar

개체의 부모 메뉴 모음에 대한 포인터를 CMFCRibbonCategory 반환합니다.

CMFCRibbonPanelMenuBar* GetParentMenuBar() const;

Return Value

보호된 멤버의 m_pParentMenuBar 내용을 반환합니다.

설명

CMFCRibbonCategory::GetParentRibbonBar

리본 범주의 부모 리본 표시줄을 검색합니다.

CMFCRibbonBar* GetParentRibbonBar() const;

Return Value

리본 범주의 부모 리본 표시줄에 대한 포인터입니다.

설명

CMFCRibbonCategory::GetRect

리본 범주의 표시 사각형을 검색합니다.

CRect GetRect() const;

Return Value

리본 범주의 표시 사각형입니다.

설명

리본 범주의 표시 사각형에는 범주 탭이 포함되지 않습니다.

CMFCRibbonCategory::GetSmallImages

리본 범주에 포함된 작은 이미지 목록을 검색합니다.

CMFCToolBarImages& GetSmallImages();

Return Value

리본 범주에 포함된 작은 이미지 목록입니다.

CMFCRibbonCategory::GetTabColor

리본 범주 탭의 현재 색을 반환합니다.

AFX_RibbonCategoryColor GetTabColor() const;

Return Value

리본 범주 탭의 현재 색입니다.

설명

반환된 값은 다음 열거형 값 중 하나일 수 있습니다.

  • AFX_CategoryColor_Red

  • AFX_CategoryColor_Orange

  • AFX_CategoryColor_Yellow

  • AFX_CategoryColor_Green

  • AFX_CategoryColor_Blue

  • AFX_CategoryColor_Indigo

  • AFX_CategoryColor_Violet

CMFCRibbonCategory::GetTabRect

리본 범주 탭의 표시 사각형을 검색합니다.

CRect GetTabRect() const;

Return Value

리본 범주 탭의 표시 사각형입니다.

설명

CMFCRibbonCategory::GetTextTopLine

큰 이미지를 표시하는 리본 범주의 리본 단추에 있는 텍스트의 세로 위치를 검색합니다.

int GetTextTopLine() const;

Return Value

큰 이미지를 표시하는 리본 단추에 있는 텍스트의 세로 위치(픽셀)입니다.

설명

CMFCRibbonCategory::GetVisibleElements

리본 범주에 속하는 표시되는 모든 요소를 검색합니다.

void GetVisibleElements(
    CArray <CMFCRibbonBaseElement*,
    CMFCRibbonBaseElement*>& arElements);

매개 변수

arElements
표시되는 모든 요소의 배열입니다.

설명

CMFCRibbonCategory::HighlightPanel

지정한 리본 패널을 강조 표시합니다.

CMFCRibbonPanel* HighlightPanel(
    CMFCRibbonPanel* pHLPanel,
    CPoint point);

매개 변수

pHLPanel
[in] 강조 표시할 리본 패널에 대한 포인터입니다.

point
[in] 창의 왼쪽 위 모서리를 기준으로 포인터의 x 및 y 좌표입니다.

Return Value

이전에 강조 표시된 리본 패널에 대한 포인터입니다. 이 메서드를 호출할 때 리본 패널이 강조 표시되지 않으면 그렇지 않으면 NULL입니다.

설명

리본 패널을 강조 표시하는 방법에 대한 자세한 내용은 CMFCRibbonPanel::Highlight를 참조하세요.

CMFCRibbonCategory::HitTest

지정한 점이 있는 경우 리본 요소에 대한 포인터를 검색합니다.

CMFCRibbonBaseElement* HitTest(
    CPoint point,
    BOOL bCheckPanelCaption = FALSE) const;

매개 변수

point
[in] 창의 왼쪽 위 모서리를 기준으로 하는 마우스 포인터의 x 및 y 좌표입니다.

bCheckPanelCaption
[in] TRUE이면 리본 패널 캡션을 테스트합니다. 리본 패널 캡션을 제외하려면 FALSE입니다.

Return Value

메서드가 성공한 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

리본 범주에 포함된 리본 요소만 테스트됩니다.

CMFCRibbonCategory::HitTestEx

지정한 점이 있는 경우 리본 요소의 인덱스(0부터 시작하는 인덱스)를 검색합니다.

int HitTestEx(CPoint point) const;

매개 변수

point
[in] 창의 왼쪽 위 모서리를 기준으로 하는 마우스 포인터의 x 및 y 좌표입니다.

Return Value

메서드가 성공한 경우 리본 요소의 인덱스(0부터 시작하는 인덱스)입니다. 그렇지 않으면 -1입니다.

설명

리본 범주에 포함된 리본 요소만 테스트됩니다.

CMFCRibbonCategory::HitTestScrollButtons

점이 리본 범주의 왼쪽 또는 오른쪽 스크롤 단추에 속하는 경우 해당 단추에 대한 포인터를 반환합니다.

CMFCRibbonBaseElement* HitTestScrollButtons(CPoint point) const;

매개 변수

point
[in] 테스트할 지점입니다.

Return Value

지점이 리본 범주의 왼쪽 또는 오른쪽 스크롤 단추의 경계 사각형 내에 있으면 해당 단추에 대한 포인터를 반환하거나 그렇지 않으면 NULL을 반환합니다.

설명

CMFCRibbonCategory::IsActive

리본 메뉴 범주가 리본 표시줄의 활성 범주인지 여부를 나타냅니다.

BOOL IsActive() const;

Return Value

리본 범주가 활성 범주이면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

활성 리본 범주에는 리본 패널이 표시됩니다.

CMFCRibbonCategory::IsVisible

리본 범주가 표시되는지 여부를 나타냅니다.

BOOL IsVisible() const;

Return Value

리본 범주가 표시되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

표시되는 리본 범주에는 범주 탭이 표시됩니다.

CMFCRibbonCategory::IsWindows7Look

부모 리본에 Windows 7 모양(작은 사각형 응용 프로그램 단추)이 있는지 여부를 나타냅니다.

BOOL IsWindows7Look() const;

Return Value

부모 리본에 Windows 7 모양이 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonCategory::NotifyControlCommand

메시지가 처리될 때까지 WM_NOTIFY 명령 메시지를 모든 CMFCRibbonPanel 요소 CMFCRibbonCategory 에 전달합니다.

virtual BOOL NotifyControlCommand(
    BOOL bAccelerator,
    int nNotifyCode,
    WPARAM wParam,
    LPARAM lParam);

매개 변수

bAccelerator
[in] 이 명령이 가속기에서 시작된 경우 TRUE이거나, 그렇지 않으면 FALSE입니다.

nNotifyCode
[in] 알림 코드입니다.

wParam
[in] 메시지의 WPARAM 필드입니다.

lParam
[in] 메시지의 LPARAM 필드입니다.

Return Value

메시지가 처리된 경우 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

CMFCRibbonCategory::OnCancelMode

의 모든 요소에서 취소 모드를 CMFCRibbonPanel 호출합니다 CMFCRibbonCategory.

virtual void OnCancelMode();

설명

CMFCRibbonCategory::OnDraw

리본 범주를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDraw(CDC* pDC);

매개 변수

pDC
[in] 리본 범주에 대한 디바이스 컨텍스트에 대한 포인터입니다.

설명

CMFCRibbonCategory::OnDrawImage

리본 범주에 지정된 이미지를 그리기 위해 프레임워크에서 호출됩니다.

virtual BOOL OnDrawImage(
    CDC* pDC,
    CRect rect,
    CMFCRibbonBaseElement* pElement,
    BOOL bIsLargeImage,
    BOOL nImageIndex,
    BOOL bCenter);

매개 변수

pDC
[in] 이미지의 디바이스 컨텍스트에 대한 포인터입니다.

rect
[in] 이미지의 사각형을 표시합니다.

pElement
[in] 이미지를 포함하는 리본 요소에 대한 포인터입니다.

bIsLargeImage
[in] 이미지가 큰 크기이면 TRUE이고, 이미지가 작은 크기이면 FALSE입니다.

nImageIndex
[in] 리본 범주에 포함된 이미지 배열의 이미지 인덱스(0부터 시작하는 인덱스)입니다.

bCenter
[in] TRUE이면 이미지를 디스플레이 사각형의 가운데에 배치합니다. FALSE로 표시 사각형의 왼쪽 위 모서리에 이미지를 그립니다.

Return Value

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

설명

CMFCRibbonCategory::OnDrawMenuBorder

팝업 메뉴의 테두리를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawMenuBorder(
    CDC* pDC,
    CMFCRibbonPanelMenuBar* pMenuBar);

매개 변수

pDC
[in] 이 매개 변수는 사용되지 않습니다.

pMenuBar
[in] 이 매개 변수는 사용되지 않습니다.

설명

기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 팝업 메뉴의 테두리를 그리려면 이 메서드를 재정의합니다.

CMFCRibbonCategory::OnKey

사용자가 키보드 단추를 누를 때 프레임워크에서 호출됩니다.

virtual BOOL OnKey(UINT nChar);

매개 변수

nChar
사용자가 누른 키의 가상 키 코드입니다.

설명

CMFCRibbonCategory::OnLButtonDown

사용자가 왼쪽 마우스 단추를 누를 때 지정된 지점 아래의 리본 요소를 검색하기 위해 프레임워크에서 호출됩니다.

virtual CMFCRibbonBaseElement* OnLButtonDown(CPoint point);

매개 변수

point
[in] 창의 왼쪽 위 모서리를 기준으로 하는 마우스 포인터의 x 및 y 좌표입니다.

Return Value

메서드가 성공한 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

CMFCRibbonCategory::OnLButtonUp

사용자가 마우스 왼쪽 단추를 놓으면 프레임워크에서 호출되고 포인터가 리본 범주 위에 있습니다.

virtual void OnLButtonUp(CPoint point);

매개 변수

point
[in] 창의 왼쪽 위 모서리를 기준으로 포인터의 x 및 y 좌표입니다.

설명

CMFCRibbonCategory::OnMouseMove

리본 범주 표시를 업데이트하기 위해 포인터가 리본 표시줄에서 이동할 때 프레임워크에서 호출됩니다.

virtual void OnMouseMove(CPoint point);

매개 변수

point
[in] 창의 왼쪽 위 모서리를 기준으로 포인터의 x 및 y 좌표입니다.

설명

CMFCRibbonCategory::OnRTLChanged

레이아웃이 방향을 변경할 때 프레임워크에서 호출됩니다.

virtual void OnRTLChanged(BOOL bIsRTL);

매개 변수

bIsRTL
[in] 레이아웃이 오른쪽에서 왼쪽인 경우 TRUE입니다. 레이아웃이 왼쪽에서 오른쪽인 경우 FALSE입니다.

설명

이 메서드는 리본 메뉴 범주에 포함된 모든 리본 패널 및 리본 요소의 레이아웃을 조정합니다.

CMFCRibbonCategory::OnScrollHorz

리본 범주를 가로 방향으로 스크롤합니다.

virtual BOOL OnScrollHorz(
    BOOL bScrollLeft,
    int nScrollOffset = 0);

매개 변수

bScrollLeft
[in] TRUE이면 왼쪽으로 스크롤합니다. FALSE를 사용하여 오른쪽으로 스크롤합니다.

nScrollOffset
[in] 스크롤 거리(픽셀)입니다.

Return Value

리본 범주가 가로 방향으로 이동하면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonCategory::OnUpdateCmdUI

각 요소의 OnUpdateCmdUI 멤버 함수를 CMFCRibbonPanel 호출하여 해당 요소의 CMFCRibbonCategory 사용자 인터페이스 요소를 사용하거나 사용하지 않도록 설정합니다.

virtual void OnUpdateCmdUI(
    CMFCRibbonCmdUI* pCmdUI,
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

매개 변수

pCmdUI
[in] CMFCRibbonCmdUI 사용할 사용자 인터페이스 요소와 사용하지 않도록 설정할 사용자 인터페이스 요소를 지정하는 개체에 대한 포인터입니다.

pTarget
[in] 사용자 인터페이스 요소의 사용 또는 비활성화를 제어하는 창에 대한 포인터입니다.

bDisableIfNoHndler
[in] 메시지 맵에 처리기가 정의되지 않은 경우 사용자 인터페이스 항목을 사용하지 않도록 설정하려면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonCategory::RecalcLayout

리본 범주에 있는 모든 컨트롤의 레이아웃을 조정합니다.

virtual void RecalcLayout(CDC* pDC);

매개 변수

pDC
[in] 리본 범주에 대한 디바이스 컨텍스트에 대한 포인터입니다.

설명

CMFCRibbonCategory::RemovePanel

리본 범주에서 리본 패널을 제거합니다.

BOOL RemovePanel(
    int nIndex,
    BOOL bDelete = TRUE);

매개 변수

nIndex
[in] 제거할 패널의 인덱스 번호입니다. CMFCRibbonCategory::GetPanelIndex 메서드를 호출하여 가져옵니다.

bDelete
[in] TRUE이면 메모리에서 패널 개체를 삭제합니다. FALSE를 사용하여 패널 개체를 삭제하지 않고 제거합니다.

Return Value

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

CMFCRibbonCategory::ReposPanels

리본 메뉴 범주에 포함된 리본 패널의 모든 컨트롤 레이아웃을 조정합니다.

virtual void ReposPanels(CDC* pDC);

매개 변수

pDC
[in] 리본 메뉴 범주에 포함된 리본 패널의 디바이스 컨텍스트에 대한 포인터입니다.

설명

CMFCRibbonCategory::SetCollapseOrder

리본 범주의 리본 패널이 축소되는 순서를 정의합니다.

void SetCollapseOrder(const CArray<int,int>& arCollapseOrder);

매개 변수

arCollapseOrder
[in] 축소 순서를 지정합니다. 배열에는 리본 패널의 인덱스(0부터 시작하는 인덱스)가 포함되어 있습니다.

설명

라이브러리는 축소 순서를 정의합니다. 그러나 축소 순서를 지정하는 인덱스 목록을 범주에 제공하여 이 동작을 사용자 지정할 수 있습니다.

범주가 리본 패널을 축소해야 한다는 것을 감지하면 지정된 목록에서 다음 요소를 찾습니다. 목록이 비어 있거나 요소를 충분히 지정하지 않은 경우 범주는 내부 알고리즘을 사용합니다.

예를 들어 범주에는 세 개의 리본 패널이 있으며 모든 패널이 완전히 축소된 상태가 될 때까지 여러 번 축소할 수 있습니다. 0, 0, 2, 2의 축소 순서를 설정할 수 있습니다. 이 경우 범주는 패널 0을 두 번, 패널 2를 두 번 축소합니다. 인덱스가 1인 패널은 데이터 정렬되지 않은 상태로 유지됩니다.

예시

다음 예제에서는 클래스에서 메서드를 SetCollapseOrder 사용 하는 방법을 보여 줍니다 CMFCRibbonCategory . 이 예제에서는 축소 순서에 대한 배열을 생성하는 방법과 축소 순서를 리본 범주로 설정하는 방법을 보여 줍니다.

CArray<int, int> arCollapseOrder;
arCollapseOrder.Add(0);
arCollapseOrder.Add(1);
arCollapseOrder.Add(2);
// CMFCRibbonCategory* pCategoryHome
pCategoryHome->SetCollapseOrder(arCollapseOrder);

CMFCRibbonCategory::SetData

리본 범주와 연결할 사용자 정의 데이터를 설정합니다.

void SetData(DWORD_PTR dwData);

매개 변수

dwData
[in] 사용자 정의 데이터입니다.

CMFCRibbonCategory::SetKeys

리본 범주에 키 설명을 할당합니다.

void SetKeys(LPCTSTR lpszKeys);

매개 변수

lpszKeys
[in] 키 설명 텍스트입니다.

설명

사용자가 Alt 키 또는 F10 키를 누르면 키 설명이 표시됩니다.

CMFCRibbonCategory::SetName

리본 범주에 이름 및 키 설명을 할당합니다.

void SetName(LPCTSTR lpszName);

매개 변수

lpszName
[in] 리본 범주의 이름 및 키 설명입니다.

설명

리본 범주에 대한 키 설명을 설정하려면 줄 바꿈 이스케이프 시퀀스 뒤에 키 설명 문자를 lpszName추가합니다.

CMFCRibbonCategory::SetTabColor

리본 범주의 색을 설정합니다.

void SetTabColor(AFX_RibbonCategoryColor color);

매개 변수

color
[in] 리본 범주의 새 색을 지정합니다.

설명

색은 다음 값 중 하나일 수 있습니다.

  • AFX_CategoryColor_None

  • AFX_CategoryColor_Red

  • AFX_CategoryColor_Orange

  • AFX_CategoryColor_Yellow

  • AFX_CategoryColor_Green

  • AFX_CategoryColor_Blue

  • AFX_CategoryColor_Indigo

  • AFX_CategoryColor_Violet

참고 항목

계층 구조 차트
클래스
CObject 클래스