CMFCRibbonBaseElement 클래스
CMFCRibbonBaseElement 클래스는 리본 표시줄에 추가할 수 있는 모든 요소의 기본 클래스입니다. 리본 요소의 예를 들면 리본 단추, 리본 확인란 및 리본 콤보 상자가 있습니다.
구문
class CMFCRibbonBaseElement : public CObject
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
CMFCRibbonBaseElement |
CMFCRibbonBaseElement 개체를 생성합니다. |
공용 메서드
보호된 메서드
| 속성 | 설명 |
|---|---|
| CMFCRibbonBaseElement::OnProcessKey | 사용자가 바로 가기 키를 누를 때 프레임워크에서 호출됩니다. |
| CMFCRibbonBaseElement::OnSetFocus | 리본 요소가 입력 포커스를 받거나 잃을 때 프레임워크에서 호출됩니다. |
설명
클래스는 CMFCRibbonBaseElement 명령 ID, 텍스트 레이블, 도구 설명 텍스트, 요소 설명 및 상태를 포함하는 모든 리본 요소에 공통적인 속성을 정의합니다(포커스, 강조 표시, 누르기, 사용 안 함, 선택 또는 드롭다운될 수 있습니다).
리본 요소의 이미지 크기는 다음 값 중 하나일 수 있는 멤버에 의해 RibbonImageType 정의됩니다.
RibbonImageLargeRibbonImageSmall
리본 요소의 크기에 따라 작은 이미지나 큰 이미지가 표시됩니다.
예시
다음 예제에서는 CMFCRibbonBaseElement 클래스에서 다양한 메서드를 사용하는 방법을 보여 줍니다. 이 예제에서는 클래스에서 CMFCRibbonStatusBar 개체를 CMFCRibbonBaseElement 가져와서 리본 요소에 대한 설명을 설정하고, 텍스트를 설정하고, 키 설명을 설정하고, 리본 요소에 대한 도구 설명 텍스트를 설정하는 방법을 보여 줍니다. 이 코드 조각은 클라이언트 그리기 샘플의 일부입니다.
// CMFCRibbonStatusBar m_wndStatusBar
CMFCRibbonBaseElement *pPane = m_wndStatusBar.FindByID(nID);
pPane->SetDescription(_T("a pane"));
// CString strText
pPane->SetText(strText);
pPane->SetKeys(_T("p"));
pPane->SetToolTipText(_T("this is a pane"));
상속 계층 구조
요구 사항
헤더: afxbaseribbonelement.h
CMFCRibbonBaseElement::AddToKeyList
리본 요소의 키 설명을 키 설명 배열에 추가합니다.
virtual void AddToKeyList(
CArray<CMFCRibbonKeyTip*, CMFCRibbonKeyTip*>& arElems);
매개 변수
arElems
[in] 키 설명의 CArray 에 대한 참조입니다.
설명
리본 키 설명 기능을 사용하도록 설정하면 사용자가 ALT 키 또는 F10 키를 누를 때 프레임워크에 리본 키 설명이 표시됩니다.
CMFCRibbonBaseElement::AddToListBox
지정한 리본 명령 목록 상자에 리본 요소를 추가합니다.
virtual int AddToListBox(
CMFCRibbonCommandsListBox* pWndListBox,
BOOL bDeep);
매개 변수
pWndListBox
[in] 명령 목록 상자에 대한 포인터입니다.
bDeep
[in] 이 매개 변수는 사용되지 않습니다.
Return Value
추가된 리본 요소의 인덱스(0부터 시작하는 인덱스)입니다.
설명
프레임워크는 사용자가 사용자 인터페이스를 사용자 지정할 수 있도록 명령 목록 상자에 리본 요소를 추가합니다.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar
리본 요소를 빠른 실행 도구 모음에 추가할 수 있는지 여부를 나타냅니다.
virtual BOOL CanBeAddedToQuickAccessToolBar() const;
Return Value
요소를 추가할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::CanBeCompacted
리본 요소의 크기를 압축할 수 있는지 여부를 나타냅니다.
virtual BOOL CanBeCompacted() const;
Return Value
리본 요소의 크기를 압축할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
리본 요소의 크기는 컴팩트, 중간 또는 큰 크기일 수 있습니다.
CMFCRibbonBaseElement::CanBeStretched
리본 메뉴 요소의 높이가 리본 행의 높이까지 세로로 증가할 수 있는지 여부를 나타냅니다.
virtual BOOL CanBeStretched();
Return Value
항상 TRUE를 반환합니다.
설명
기본적으로 이 메서드는 항상 TRUE를 반환합니다. 리본 메뉴 요소의 높이가 리본 행의 높이까지 세로로 증가할 수 있는지 여부를 나타내기 위해 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::CanBeStretchedHorizontally
리본 요소의 너비를 변경할 수 있는지 여부를 나타냅니다.
virtual BOOL CanBeStretchedHorizontally();
Return Value
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 리본 요소의 너비를 변경할 수 있는지 여부를 나타내려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::CleanUpSizes
리본 요소의 차원 설정을 정리합니다.
virtual void CleanUpSizes();
설명
기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 파생 클래스에서 이 메서드를 재정의하여 리본 요소의 차원 설정을 다시 설정합니다.
CMFCRibbonBaseElement::ClosePopupMenu
리본 요소의 팝업 메뉴를 닫습니다.
virtual void ClosePopupMenu();
설명
CMFCRibbonBaseElement::CopyFrom
지정된 CMFCRibbonBaseElement 의 상태를 현재 개체에 복사합니다.
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
매개 변수
src
[in] 원본 CMFCRibbonBaseElement 개체입니다.
설명
CMFCRibbonBaseElement::DestroyCtrl
리본 요소를 제거합니다.
virtual void DestroyCtrl();
설명
기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 파생 클래스에서 이 메서드를 재정의하여 리본 요소를 삭제합니다.
CMFCRibbonBaseElement::DrawImage
리본 요소에 대한 이미지를 그립니다.
virtual void DrawImage(
CDC* pDC,
RibbonImageType type,
CRect rectImage);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
type
[in] 이미지 형식 열거형 값입니다. 가능한 값 목록은 설명 섹션을 참조하세요.
rectImage
[in] 이미지 사각형입니다.
설명
기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 파생 클래스에서 이 메서드를 재정의하여 리본 요소의 이미지를 그립니다.
다음 표에서는 형식 매개 변수에 대해 가능한 값을 나열합니다.
| 값 | 설명 |
|---|---|
RibbonImageLarge |
큰 32x32 픽셀 이미지 크기입니다. |
RibbonImageSmall |
작은 16x16 픽셀 이미지 크기입니다. |
CMFCRibbonBaseElement::Find
현재 개체를 가리키는 경우 지정한 포인터를 반환합니다.
virtual CMFCRibbonBaseElement* Find(const CMFCRibbonBaseElement* pElement);
매개 변수
pElement
[in] 리본 요소에 대한 포인터입니다.
Return Value
pElement가 현재 개체를 가리키는 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::FindByData
지정된 데이터가 포함된 경우 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);
매개 변수
dwData
[in] 리본 요소와 연결된 데이터입니다.
Return Value
리본 요소에 지정된 데이터가 포함된 경우의 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::FindByID
해당 요소가 지정된 명령 ID로 식별되는 경우 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);
매개 변수
uiCmdID
[in] 리본 요소의 명령 ID입니다.
Return Value
지정된 명령 ID로 해당 요소를 식별하는 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::FindByOriginal
원래 리본 요소가 지정된 리본 요소와 일치하는 경우 현재 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);
매개 변수
pOriginal
[in] 리본 요소에 대한 포인터입니다.
Return Value
원래 리본 요소가 지정된 리본 요소와 일치하는 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
다른 컨테이너에 복사되는 리본 요소는 원래 리본 요소에 대한 포인터를 유지합니다.
CMFCRibbonBaseElement::GetCompactSize
리본 요소의 압축 크기를 반환합니다.
virtual CSize GetCompactSize(CDC* pDC);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
Return Value
리본 요소의 압축 크기입니다.
참고 항목
압축 크기는 리본 요소가 잘리게 됨을 의미합니다(작은 이미지 또는 텍스트가 없는 이미지를 표시).
CMFCRibbonBaseElement::GetData
리본 요소와 연결된 사용자 정의 데이터를 검색합니다.
DWORD_PTR GetData() const;
Return Value
리본 요소와 연결된 사용자 정의 데이터입니다.
CMFCRibbonBaseElement::GetDescription
리본 요소에 대한 설명을 반환합니다.
virtual CString GetDescription() const;
Return Value
리본 요소 설명입니다. 설명은 상태 표시줄 또는 도구 설명에 표시되거나, 리본 요소가 CMFCRibbonMainPanel 클래스에 있는 경우 메뉴 단추 아래에 표시됩니다.
CMFCRibbonBaseElement::GetDroppedDown
팝업 메뉴가 드롭다운되면 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* GetDroppedDown();
Return Value
팝업 메뉴가 드롭다운된 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::GetElements
지정된 배열에 현재 리본 요소를 추가합니다.
virtual void GetElements(
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
매개 변수
arElements
[in, out] 리본 요소의 배열입니다.
설명
CMFCRibbonBaseElement::GetElementsByID
현재 리본 요소에 지정된 명령 ID가 포함된 경우 지정된 배열에 현재 리본 요소를 추가합니다.
virtual void GetElementsByID(
UINT uiCmdID,
CArray<CMFCRibbonBaseElement*, CMFCRibbonBaseElement*>& arElements);
매개 변수
uiCmdID
[in] 리본 요소의 명령 ID입니다.
arElements
[in] 리본 요소의 배열입니다.
설명
CMFCRibbonBaseElement::GetHighlighted
강조 표시된 경우 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* GetHighlighted();
Return Value
리본 요소가 강조 표시된 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::GetID
리본 요소의 명령 ID를 반환합니다.
UINT GetID() const;
Return Value
리본 요소의 명령 ID입니다.
CMFCRibbonBaseElement::GetImageSize
리본 요소의 이미지 크기를 반환합니다.
virtual CSize GetImageSize(RibbonImageType R) const;
Return Value
리본 요소의 이미지 크기입니다.
CMFCRibbonBaseElement::GetIntermediateSize
중간 상태인 리본 요소의 크기를 반환합니다.
virtual CSize GetIntermediateSize(CDC* pDC);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
Return Value
중간 상태의 리본 요소 크기입니다.
CMFCRibbonBaseElement::GetKeys
리본 요소와 연결된 키 설명을 반환합니다.
LPCTSTR GetKeys() const;
Return Value
리본 요소와 연결된 키 설명입니다.
CMFCRibbonBaseElement::GetKeyTipRect
리본 요소의 키 설명 경계 사각형을 검색합니다.
virtual CRect GetKeyTipRect(
CDC* pDC,
BOOL bIsMenu);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
bIsMenu
[in] 리본 요소에 팝업 메뉴가 표시되면 TRUE입니다. 그렇지 않으면 FALSE입니다.
Return Value
항상 값이 0인 사각형을 반환합니다.
설명
키 설명 경계 사각형을 반환하려면 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::GetKeyTipSize
키 설명 텍스트의 크기를 검색합니다.
virtual CSize GetKeyTipSize(CDC* pDC);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
Return Value
키 설명 텍스트의 크기입니다.
설명
CMFCRibbonBaseElement::GetLocationInGroup
리본 그룹에 있는 리본 요소의 표시 위치를 나타냅니다.
RibbonElementLocation GetLocationInGroup() const;
Return Value
RibbonElementLocation 열거형 값입니다. 다음 표에서는 가능한 값을 나열합니다.
| 값 | 설명 |
|---|---|
RibbonElementNotInGroup |
리본 메뉴 요소가 리본 그룹에 포함되어 있지 않습니다. |
RibbonElementSingleInGroup |
리본 메뉴 요소는 리본 그룹의 유일한 항목으로 표시됩니다. |
RibbonElementFirstInGroup |
리본 메뉴 요소는 리본 그룹의 왼쪽 끝에 표시됩니다. |
RibbonElementLastInGroup |
리본 메뉴 요소는 리본 그룹의 오른쪽 끝에 표시됩니다. |
RibbonElementMiddleInGroup |
리본 메뉴 요소는 리본 그룹의 양쪽 끝에 표시되지 않습니다. |
설명
Ribbon 요소 그룹은 가로로만 정렬됩니다.
CMFCRibbonBaseElement::GetMenuKeys
리본 요소의 메뉴 키 설명을 반환합니다.
LPCTSTR GetMenuKeys() const;
Return Value
리본 요소와 연결된 메뉴 키 설명입니다.
설명
호출되면 메뉴 키 설명에 팝업 메뉴가 표시됩니다.
CMFCRibbonBaseElement::GetNotifyID
리본 요소에 대한 알림 명령 ID를 검색합니다.
virtual UINT GetNotifyID();
Return Value
알림 명령 ID입니다.
설명
CMFCRibbonBaseElement::GetOriginal
원래 리본 요소를 검색합니다.
CMFCRibbonBaseElement* GetOriginal() const;
Return Value
원래 리본 요소에 대한 포인터입니다.
설명
다른 컨테이너에 복사되는 리본 요소는 원래 리본 요소에 대한 포인터를 유지합니다.
CMFCRibbonBaseElement::GetParentCategory
리본 요소의 리본 범주를 검색합니다.
CMFCRibbonCategory* GetParentCategory() const;
Return Value
리본 범주에 대한 포인터입니다.
설명
CMFCRibbonBaseElement::GetParentPanel
리본 요소가 포함된 리본 패널을 검색합니다.
virtual CMFCRibbonPanel* GetParentPanel() const;
Return Value
리본 요소가 포함된 리본 패널에 대한 포인터입니다.
설명
CMFCRibbonBaseElement::GetParentRibbonBar
리본 요소의 부모 리본 표시줄을 검색합니다.
CMFCRibbonBar* GetParentRibbonBar() const;
Return Value
리본 요소의 부모 리본 표시줄에 대한 포인터입니다.
설명
CMFCRibbonBaseElement::GetParentWnd
리본 요소의 부모 창을 검색합니다.
virtual CWnd* GetParentWnd() const;
Return Value
메서드가 성공한 경우 리본 요소의 부모 창에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
리본 요소의 부모 창은 CMFCRibbonBar 클래스 또는 CMFCRibbonPanelMenuBar입니다.
CMFCRibbonBaseElement::GetPressed
사용자가 현재 리본 요소를 누르면 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* GetPressed();
Return Value
사용자가 현재 리본 요소를 누를 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::GetQuickAccessToolBarID
빠른 실행 도구 모음에 있을 때 리본 요소의 명령 ID를 검색합니다.
virtual UINT GetQuickAccessToolBarID() const;
Return Value
빠른 실행 도구 모음에 있는 경우 리본 요소의 명령 ID입니다.
설명
CMFCRibbonBaseElement::GetRect
리본 요소의 경계 사각형을 반환합니다.
CRect GetRect() const;
Return Value
리본 요소의 경계 사각형입니다. 사각형의 위치는 부모 리본 컨트롤의 좌표에 있습니다.
CMFCRibbonBaseElement::GetRegularSize
리본 요소의 보통 크기를 반환합니다.
virtual CSize GetRegularSize(CDC* pDC) = 0;
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
Return Value
리본 요소의 일반 크기입니다.
설명
참고 항목
일반 크기는 리본 요소의 최대 가능한 크기입니다.
CMFCRibbonBaseElement::GetSize
리본 요소의 현재 크기를 반환합니다.
virtual CSize GetSize(CDC* pDC);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
Return Value
리본 요소의 현재 크기입니다.
CMFCRibbonBaseElement::GetText
리본 요소와 연결된 텍스트를 반환합니다.
LPCTSTR GetText() const;
Return Value
리본 요소와 연결된 텍스트입니다.
CMFCRibbonBaseElement::GetToolTipText
리본 요소의 도구 설명 텍스트를 반환합니다.
virtual CString GetToolTipText() const;
Return Value
리본 요소의 도구 설명 텍스트입니다.
CMFCRibbonBaseElement::GetTopLevelRibbonBar
리본 요소의 최상위 리본 표시줄을 검색합니다.
CMFCRibbonBar* GetTopLevelRibbonBar() const;
Return Value
메서드가 성공한 경우 리본 요소의 최상위 리본 표시줄에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::HasCompactMode
리본 요소에 압축 모드가 있는지 여부를 지정합니다.
virtual BOOL HasCompactMode() const;
Return Value
리본 요소에 압축 모드가 있는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
참고 항목
압축 모드에서 요소는 작은 이미지만 표시합니다.
CMFCRibbonBaseElement::HasIntermediateMode
리본 요소에 중간 모드가 있는지 여부를 지정합니다.
virtual BOOL HasIntermediateMode() const;
Return Value
리본 요소에 중간 모드가 있으면 TRUE이고, 그렇지 않으면 FALSE입니다. 중간 모드에서 요소는 이미지 오른쪽에 작은 이미지와 텍스트를 표시합니다.
설명
CMFCRibbonBaseElement::HasLargeMode
리본 요소에 큰 모드가 있는지 여부를 결정합니다.
virtual BOOL HasLargeMode() const;
Return Value
리본 요소에 큰 모드가 있는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
큰 모드에서 요소는 부모 패널의 전체 높이를 취할 수 있습니다.
CMFCRibbonBaseElement::HasMenu
리본 요소에 메뉴가 있는지 여부를 나타냅니다.
virtual BOOL HasMenu() const;
Return Value
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 리본 요소에 메뉴가 있는지 여부를 나타내기 위해 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::HitTest
지정한 점이 있는 경우 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* HitTest(CPoint point);
매개 변수
point
[in] 이 매개 변수는 사용되지 않습니다.
Return Value
리본 요소에 대한 포인터(있는 경우)입니다. 그렇지 않으면 FALSE입니다.
설명
기본적으로 이 메서드는 리본 요소가 있을 때 항상 유효한 포인터를 반환합니다. 이 메서드를 재정의하여 점이 리본 요소에 있는지 여부를 나타냅니다.
CMFCRibbonBaseElement::IsAlignByColumn
리본 요소가 다른 리본 요소와 세로로 정렬되는지 여부를 나타냅니다.
virtual BOOL IsAlignByColumn() const;
Return Value
항상 TRUE를 반환합니다.
설명
기본적으로 이 메서드는 항상 TRUE를 반환합니다. 파생된 리본 요소가 다른 리본 요소와 세로로 정렬되는지 여부를 나타내기 위해 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::IsAlwaysLargeImage
리본 요소 이미지 크기가 항상 큰지 여부를 나타냅니다.
virtual BOOL IsAlwaysLargeImage() const;
Return Value
리본 요소 이미지 크기가 항상 크면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
큰 이미지 크기는 32 x 32 픽셀입니다.
CMFCRibbonBaseElement::IsAutoRepeatMode
리본 요소가 자동 반복 모드인지 여부를 나타냅니다.
virtual BOOL IsAutoRepeatMode(int& nDelay) const;
매개 변수
nDelay
[in] 이 매개 변수는 사용되지 않습니다.
Return Value
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 리본 요소가 자동 반복 모드에 있는지 여부를 나타내려면 이 메서드를 재정의합니다.
자동 반복 모드에서 리본 요소는 설정된 간격(밀리초)으로 응답하여 지속적인 사용자 입력에 응답합니다.
CMFCRibbonBaseElement::IsChecked
리본 요소의 선택 여부를 지정합니다.
virtual BOOL IsChecked() const;
Return Value
리본 요소가 선택되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsCompactMode
리본 요소가 압축 모드에 있는지 여부를 지정합니다.
BOOL IsCompactMode() const;
Return Value
리본 요소가 압축 모드인 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsDefaultMenuLook
리본 요소가 팝업 명령으로 표시되도록 설정되어 있는지 여부를 나타냅니다.
BOOL IsDefaultMenuLook() const;
Return Value
리본 요소가 팝업 명령으로 표시되도록 설정된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsDisabled
리본 요소를 사용하지 않도록 설정할지 여부를 지정합니다.
virtual BOOL IsDisabled() const;
Return Value
리본 요소를 사용할 수 없으면 TRUE이고, 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsDroppedDown
리본 요소에 팝업 메뉴가 표시되고 드롭다운되는지 여부를 지정합니다.
virtual BOOL IsDroppedDown() const;
Return Value
리본 메뉴 요소가 드롭다운되고 팝업 메뉴가 표시되면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsFocused
리본 요소에 포커스가 있는지 여부를 지정합니다.
virtual BOOL IsFocused() const;
Return Value
리본 요소에 포커스가 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsGalleryIcon
리본 갤러리에 리본 요소가 포함되어 있는지 여부를 나타냅니다.
virtual BOOL IsGalleryIcon() const;
Return Value
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 리본 갤러리에 리본 요소가 포함되어 있는지 여부를 나타내기 위해 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::IsHighlighted
리본 요소의 강조 표시 여부를 지정합니다.
virtual BOOL IsHighlighted() const;
Return Value
리본 요소가 강조 표시된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsIntermediateMode
리본 요소의 현재 이미지가 중간 크기인지 여부를 나타냅니다.
BOOL IsIntermediateMode() const;
Return Value
리본 요소의 이미지가 중간 크기이면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
중간 이미지 크기는 16 x 16 픽셀입니다.
CMFCRibbonBaseElement::IsLargeMode
리본 요소의 현재 이미지가 큰지 여부를 나타냅니다.
BOOL IsLargeMode() const;
Return Value
리본 요소의 이미지가 큰 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
큰 이미지 크기는 32 x 32 픽셀입니다.
CMFCRibbonBaseElement::IsMenuMode
리본 요소가 메뉴에 포함되어 있는지 여부를 나타냅니다.
BOOL IsMenuMode() const;
Return Value
메뉴에 리본 요소가 포함되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsPressed
사용자가 리본 요소를 클릭했는지 여부를 나타냅니다.
virtual BOOL IsPressed() const;
Return Value
사용자가 리본 요소를 클릭한 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsQATMode
리본 요소가 빠른 실행 도구 모음에 포함되어 있는지 여부를 나타냅니다.
BOOL IsQATMode() const;
Return Value
빠른 실행 도구 모음에 리본 요소가 포함되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsSeparator
리본 요소가 표시 구분 기호인지 여부를 나타냅니다.
virtual BOOL IsSeparator() const;
Return Value
리본 요소가 표시 구분 기호이면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsShowGroupBorder
리본 요소가 공통 테두리를 표시하는 그룹에 포함되어 있는지 여부를 나타냅니다.
BOOL IsShowGroupBorder() const;
Return Value
리본 메뉴 요소가 공통 테두리를 표시하는 그룹에 포함되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsShowTooltipOnBottom
도구 설명이 리본 요소 아래에 표시되는지 여부를 나타냅니다.
virtual BOOL IsShowTooltipOnBottom() const;
Return Value
도구 설명이 리본 요소 아래에 표시되면 TRUE이고, 포인터 근처에 도구 설명이 표시되면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsTabStop
키보드를 사용하여 리본 요소를 선택할 수 있는지 여부를 나타냅니다.
virtual BOOL IsTabStop() const;
Return Value
항상 TRUE를 반환합니다.
설명
기본적으로 이 메서드는 항상 TRUE를 반환합니다. 키보드를 사용하여 리본 요소를 선택할 수 있는지 여부를 나타내기 위해 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::IsTextAlwaysOnRight
리본 요소의 텍스트가 오른쪽에 표시되는지 여부를 나타냅니다.
BOOL IsTextAlwaysOnRight() const;
Return Value
리본 요소의 텍스트가 오른쪽에 표시되면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsVisible
리본 요소가 현재 표시되는지 여부를 나타냅니다.
BOOL IsVisible() const;
Return Value
리본 요소가 현재 표시되는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsWholeRowHeight
리본 요소의 표시 높이가 리본 패널이 포함된 리본 패널의 표시 높이와 같은지 여부를 나타냅니다.
virtual BOOL IsWholeRowHeight() const;
Return Value
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 리본 요소의 표시 높이가 포함된 리본 패널의 표시 높이와 같은지 여부를 나타내려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::NotifyCommand
리본 요소의 부모 창에 명령 알림을 보냅니다.
BOOL NotifyCommand(BOOL bWithDelay = FALSE);
매개 변수
bWithDelay
[in] TRUE이면 부모 창의 메시지 큐에 명령 알림을 추가합니다. 부모 창에 메시지를 즉시 보내려면 FALSE입니다.
Return Value
메시지가 전송된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::NotifyHighlightListItem
사용자가 목록에 있는 리본 요소를 강조 표시할 때 리본 표시줄의 부모 창에 알립니다.
virtual void NotifyHighlightListItem(int nIndex);
매개 변수
nIndex
[in] 목록에 있는 리본 요소의 인덱스입니다.
설명
CMFCRibbonBaseElement::OnAddToQAToolbar
리본 요소를 지정된 빠른 실행 도구 모음에 추가합니다.
virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);
매개 변수
qat
[in] 빠른 실행 도구 모음입니다.
Return Value
리본 요소가 빠른 실행 도구 모음에 추가되었음을 나타내는 TRUE를 항상 반환합니다.
설명
CMFCRibbonBaseElement::OnAfterChangeRect
리본 요소의 도구 설명을 업데이트합니다.
virtual void OnAfterChangeRect(CDC* pDC);
매개 변수
pDC
[in] 이 매개 변수는 사용되지 않습니다.
설명
기본적으로 이 메서드는 리본 요소의 도구 설명을 업데이트합니다. 표시 사각형이 변경된 후 리본 요소를 업데이트하려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnAutoRepeat
지속적인 사용자 입력에 대한 응답으로 리본 요소를 업데이트합니다.
virtual BOOL OnAutoRepeat();
Return Value
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 이 메서드를 재정의하여 지속적인 사용자 입력을 처리합니다.
CMFCRibbonBaseElement::OnCalcTextSize
리본 요소의 텍스트 크기를 계산합니다.
virtual void OnCalcTextSize(CDC* pDC);
매개 변수
pDC
[in] 이 매개 변수는 사용되지 않습니다.
설명
기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 리본 요소의 텍스트 크기를 계산하려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnChangeMenuHighlight
메뉴에 있는 리본 요소의 강조 표시가 변경되면 프레임워크에서 호출됩니다.
virtual void OnChangeMenuHighlight(CMFCRibbonPanelMenuBar* pPanelMenuBar
CMFCRibbonBaseElement* pHot);
매개 변수
pPanelMenuBar
[in] 이 매개 변수는 사용되지 않습니다.
pHot
[in] 이 매개 변수는 사용되지 않습니다.
설명
기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 강조 표시가 변경되면 메뉴에 있는 리본 요소를 업데이트하려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnDraw
리본 요소를 그리기 위해 프레임워크에서 호출됩니다.
virtual void OnDraw(CDC* pDC) = 0;
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
설명
특정 리본 요소의 그리기를 사용자 지정하려는 경우 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnDrawKeyTip
리본 요소의 키 설명을 그리기 위해 프레임워크에서 호출됩니다.
virtual void OnDrawKeyTip(
CDC* pDC,
const CRect& rect,
BOOL bIsMenu);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
rect
[in] 키 설명의 경계 사각형입니다.
bIsMenu
[in] 팝업 메뉴 단추에 대한 키 설명인 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::OnDrawMenuImage
리본 요소의 메뉴 이미지를 그릴 때 프레임워크에서 호출됩니다.
virtual BOOL OnDrawMenuImage(
CDC* pDC,
CRect rect);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
rect
[in] 메뉴 이미지 사각형입니다.
Return Value
항상 TRUE를 반환하여 이미지가 그려졌음을 나타냅니다.
설명
CMFCRibbonBaseElement::OnDrawOnList
명령 목록 상자에 리본 요소를 그리기 위해 프레임워크에서 호출됩니다.
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
매개 변수
pDC
[in] 리본 요소의 디바이스 컨텍스트에 대한 포인터입니다.
strText
[in] 표시 텍스트입니다.
nTextOffset
[in] 목록 상자의 왼쪽에서 표시 텍스트까지의 거리(픽셀)입니다.
rect
[in] 리본 요소의 표시 사각형입니다.
bIsSelected
[in] 이 매개 변수는 사용되지 않습니다.
bHighlighted
[in] 이 매개 변수는 사용되지 않습니다.
설명
명령 목록 상자에는 사용자가 빠른 실행 도구 모음을 사용자 지정할 수 있는 리본 요소가 표시됩니다.
CMFCRibbonBaseElement::OnKey
사용자가 키 설명을 누르고 리본 요소에 포커스가 있을 때 프레임워크에서 호출됩니다.
virtual BOOL OnKey(BOOL bIsMenuKey);
매개 변수
bIsMenuKey
[in] 키 설명에 팝업 메뉴가 표시되면 TRUE입니다. 그렇지 않으면 FALSE입니다.
Return Value
이벤트가 처리되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::OnMenuKey
사용자가 주 패널에서 메뉴 키 설명을 누를 때 프레임워크에서 호출됩니다.
virtual BOOL OnMenuKey(UINT nUpperChar);
매개 변수
nUpperChar
[in] 이 매개 변수는 사용되지 않습니다.
Return Value
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 사용자가 주 패널에서 메뉴 키 설명을 누를 때 응답하도록 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnProcessKey
사용자가 바로 가기 키를 누를 때 프레임워크에서 호출됩니다.
virtual BOOL OnProcessKey(UINT nChar);
매개 변수
nChar
[in] 이 매개 변수는 사용되지 않습니다.
Return Value
항상 FALSE를 반환합니다.
설명
리본 요소에서 바로 가기 키를 처리하려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnRTLChanged
레이아웃이 방향을 변경할 때 프레임워크에서 호출됩니다.
virtual void OnRTLChanged(BOOL bIsRTL);
매개 변수
bIsRTL
[in] 이 매개 변수는 사용되지 않습니다.
설명
기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 레이아웃이 방향을 변경할 때 리본 요소를 조정하려면 이 메서드를 재정의합니다. 기본 레이아웃 방향은 왼쪽에서 오른쪽입니다.
CMFCRibbonBaseElement::OnSetFocus
리본 요소가 입력 포커스를 받거나 잃을 때 프레임워크에서 호출됩니다.
virtual void OnSetFocus(BOOL B);
설명
애플리케이션에서 리본 요소의 포커스 변경 내용을 처리하려는 경우 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnShow
리본 요소를 표시하거나 숨기기 위해 프레임워크에서 호출됩니다.
virtual void OnShow(BOOL bShow);
매개 변수
bShow
[in] 이 매개 변수는 사용되지 않습니다.
설명
기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 리본 요소를 표시하거나 숨기려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnShowPopupMenu
리본 요소에 팝업 메뉴가 표시되기 전에 프레임워크에서 호출됩니다.
virtual void OnShowPopupMenu();
설명
이 메서드는 리본 메뉴 모음의 부모 창에 리본 요소에 팝업 메뉴가 표시되도록 알립니다.
CMFCRibbonBaseElement::PostMenuCommand
리본 요소의 팝업 메뉴를 닫고 부모 메뉴에 닫기 메시지를 보냅니다.
void PostMenuCommand(UINT uiCmdId);
매개 변수
uiCmdId
[in] 매개 변수가 사용되지 않습니다.
설명
닫기 메시지는 리본 요소가 팝업 메뉴에 있는 경우에만 전송됩니다.
CMFCRibbonBaseElement::Redraw
리본 요소의 표시를 업데이트합니다.
virtual void Redraw();
설명
이 메서드는 RDW_INVALIDATE, RDW_ERASE 및 RDW_UPDATENOW 플래그 집합을 사용하여 CWnd::RedrawWindow를 호출하여 리본 요소의 표시 사각형을 다시 그립니다.
CMFCRibbonBaseElement::SetACCData
리본 요소에 대한 내게 필요한 옵션 데이터를 설정합니다.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
매개 변수
pParent
리본 요소에 대한 부모 창입니다.
data
리본 요소에 대한 내게 필요한 옵션 데이터입니다.
Return Value
항상 TRUE를 반환합니다.
설명
기본적으로 이 메서드는 리본 요소에 대한 접근성 데이터를 설정하고 항상 TRUE를 반환합니다. 내게 필요한 옵션 데이터를 설정하고 성공 또는 실패를 나타내는 값을 반환하려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::SetCompactMode
리본 요소의 표시 크기를 설정합니다.
virtual void SetCompactMode(BOOL bCompactMode = TRUE);
매개 변수
bCompactMode
[in] 리본 요소의 표시 크기를 줄이려면 TRUE입니다. FALSE를 사용하여 리본 요소의 표시 크기를 늘입니다.
설명
다음 표에서는 이 메서드의 논리를 요약합니다.
| bCompactMode | 현재 리본 요소 크기 | 새 리본 요소 크기 |
|---|---|---|
| TRUE | Compact | 변경되지 않았습니다. |
| TRUE | Intermediate | 가능하면 압축합니다. |
| TRUE | Large | 가능하면 중간입니다. |
| FALSE | Compact | 가능하면 중간; 그렇지 않으면 큼. |
CMFCRibbonBaseElement::SetData
데이터 항목을 리본 요소와 연결합니다.
void SetData(DWORD_PTR dwData);
매개 변수
dwData
[in] 데이터 값입니다.
CMFCRibbonBaseElement::SetDefaultMenuLook
팝업 명령으로 표시할 리본 요소를 설정합니다.
void SetDefaultMenuLook(BOOL bIsDefaultMenuLook = TRUE);
매개 변수
bIsDefaultMenuLook
[in] TRUE이면 리본 요소가 팝업 명령으로 표시되도록 설정합니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::SetDescription
리본 요소에 대한 설명을 설정합니다.
virtual void SetDescription(LPCTSTR lpszText);
매개 변수
lpszText
[in] 리본 요소에 대한 설명입니다.
설명
프레임워크는 상태 표시줄이나 도구 설명 또는 메뉴 단추 아래에 새 설명을 표시합니다.
CMFCRibbonBaseElement::SetID
리본 요소의 명령 ID를 설정합니다.
virtual void SetID(UINT nID);
매개 변수
nID
[in] 명령 ID입니다.
CMFCRibbonBaseElement::SetInitialMode
리본 요소의 초기 표시 크기를 설정합니다.
virtual void SetInitialMode(BOOL bOneRow = FALSE);
매개 변수
bOneRow
[in] TRUE이면 리본 요소의 표시 크기를 압축하거나 중간 크기로 제한합니다. 그렇지 않으면 FALSE입니다.
설명
리본 요소의 표시 크기는 컴팩트, 중간 또는 큰 크기일 수 있습니다.
CMFCRibbonBaseElement::SetKeys
리본 요소의 키 설명을 설정합니다.
virtual void SetKeys(
LPCTSTR lpszKeys,
LPCTSTR lpszMenuKeys=NULL);
매개 변수
lpszKeys
[in] 리본 요소의 키 설명입니다.
lpszMenuKeys
[in] 리본 요소의 팝업 메뉴에 대한 키 설명입니다.
CMFCRibbonBaseElement::SetOriginal
리본 요소의 원래 리본 요소를 설정합니다.
virtual void SetOriginal(CMFCRibbonBaseElement* pOriginal);
매개 변수
pOriginal
[in] 리본 요소에 대한 포인터입니다.
설명
다른 컨테이너에 복사되는 리본 요소는 원래 리본 요소에 대한 포인터를 유지합니다.
CMFCRibbonBaseElement::SetParentCategory
리본 요소의 부모 범주를 설정합니다.
virtual void SetParentCategory(CMFCRibbonCategory* pParent);
매개 변수
pParent
[in] 리본 범주에 대한 포인터입니다.
설명
리본 컨트롤의 탭 그룹을 범주라고 합니다.
CMFCRibbonBaseElement::SetParentMenu
리본 요소의 부모 메뉴 컨테이너를 설정합니다.
virtual void SetParentMenu(CMFCRibbonPanelMenuBar* pMenuBar);
매개 변수
pMenuBar
[in] 부모 메뉴입니다.
설명
CMFCRibbonBaseElement::SetParentRibbonBar
리본 요소의 부모 리본 표시줄을 설정합니다.
virtual void SetParentRibbonBar(CMFCRibbonBar* pRibbonBar);
매개 변수
pRibbonBar
[in] 부모 리본 메뉴 모음에 대한 포인터입니다.
설명
CMFCRibbonBaseElement::SetRect
리본 요소의 표시 사각형 크기를 설정합니다.
void SetRect(CRect rect);
매개 변수
rect
[in] 사각형의 차원입니다.
설명
CMFCRibbonBaseElement::SetText
리본 요소의 텍스트와 키 설명을 설정합니다.
virtual void SetText(LPCTSTR lpszText);
매개 변수
lpszText
[in] 리본 요소의 텍스트 및 키 설명입니다.
설명
리본 요소의 키 설명을 설정하려면 줄 바꿈 이스케이프 시퀀스 뒤에 키 설명 문자를 lpszText에 추가합니다.
예시
//Set the text for the ribbon element
SetText(_T("Margins"))
//Set the text and a single-letter keytip
SetText(_T("Margins\nm"))
//Set the text and a multiple-letter keytip
SetText(_T("Line Numbers\nln"))
CMFCRibbonBaseElement::SetTextAlwaysOnRight
오른쪽에 표시할 리본 요소의 텍스트를 설정합니다.
virtual void SetTextAlwaysOnRight(BOOL bSet = TRUE);
매개 변수
bSet
[in] 오른쪽에 텍스트를 표시하려면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::SetToolTipText
리본 요소의 도구 설명 텍스트를 설정합니다.
virtual void SetToolTipText(LPCTSTR lpszText);
매개 변수
lpszText
[in] 도구 설명 텍스트입니다.
CMFCRibbonBaseElement::SetVisible
리본 요소의 표시 유형을 설정합니다.
void SetVisible(BOOL bIsVisible);
매개 변수
bIsVisible
[in] TRUE이면 리본 요소를 표시합니다. 리본 요소를 숨기려면 FALSE입니다.
설명
CMFCRibbonBaseElement::StretchHorizontally
리본 요소의 너비를 늘입니다.
virtual void StretchHorizontally();
설명
기본적으로 이 메서드는 디버그 빌드에서 어설션 오류를 생성하므로 호출하면 안 됩니다. 리본 요소의 너비를 늘리려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::StretchToWholeRow
리본 요소의 표시 높이를 지정된 행 높이로 변경합니다.
virtual BOOL StretchToWholeRow(
CDC* pDC,
int nHeight);
매개 변수
pDC
[in] 이 매개 변수는 사용되지 않습니다.
nHeight
[in] 행의 높이입니다.
Return Value
표시 높이가 설정된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
리본 요소의 표시 높이를 지정된 행 높이로 변경하려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::UpdateTooltipInfo
리본 요소에 대한 명령 리소스를 사용하여 도구 설명 텍스트를 업데이트합니다.
virtual void UpdateTooltipInfo();
설명
CMFCRibbonBaseElement::HasFocus
부모 요소에 키보드 포커스가 있는지 여부를 나타냅니다.
virtual BOOL HasFocus() const;
Return Value
리본 요소에 포커스가 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.