참고 항목
MFC(Microsoft Foundation Classs) 라이브러리는 계속 지원됩니다. 그러나 더 이상 기능을 추가하거나 설명서를 업데이트하지 않습니다.
CMFCRibbonBaseElement 클래스는 리본 표시줄에 추가할 수 있는 모든 요소의 기본 클래스입니다. 리본 요소의 예를 들면 리본 단추, 리본 확인란 및 리본 콤보 상자가 있습니다.
구문
class CMFCRibbonBaseElement : public CObject
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
CMFCRibbonBaseElement |
CMFCRibbonBaseElement 개체를 생성합니다. |
공용 메서드
보호된 메서드
| 속성 | 설명 |
|---|---|
| CMFCRibbonBaseElement::OnProcessKey | 사용자가 바로 가기 키를 누를 때 프레임워크에서 호출됩니다. |
| CMFCRibbonBaseElement::OnSetFocus | 리본 요소가 입력 포커스를 받거나 잃을 때 프레임워크에서 호출됩니다. |
설명
클래스는 CMFCRibbonBaseElement 명령 ID, 텍스트 레이블, 도구 설명 텍스트, 요소 설명 및 상태를 포함하는 모든 리본 요소에 공통적인 속성을 정의합니다(포커스, 강조 표시, 누르기, 사용 안 함, 선택 또는 드롭다운될 수 있습니다).
리본 요소의 이미지 크기는 다음 값 중 하나일 수 있는 멤버에 의해 RibbonImageType 정의됩니다.
RibbonImageLargeRibbonImageSmall
리본 요소의 크기에 따라 작은 이미지나 큰 이미지가 표시됩니다.
예시
다음 예제에서는 CMFCRibbonBaseElement 클래스에서 다양한 메서드를 사용하는 방법을 보여 줍니다. 이 예제에서는 클래스에서 CMFCRibbonBaseElement 개체를 CMFCRibbonStatusBar 가져와서 리본 요소에 대한 설명을 설정하고, 텍스트를 설정하고, 키 설명을 설정하고, 리본 요소에 대한 도구 설명 텍스트를 설정하는 방법을 보여 줍니다. 이 코드 조각은 클라이언트 그리기 샘플의 일부입니다.
// 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] 이 매개 변수는 사용되지 않습니다.
반환 값
추가된 리본 요소의 인덱스(0부터 시작하는 인덱스)입니다.
설명
프레임워크는 사용자가 사용자 인터페이스를 사용자 지정할 수 있도록 명령 목록 상자에 리본 요소를 추가합니다.
CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar
리본 요소를 빠른 실행 도구 모음에 추가할 수 있는지 여부를 나타냅니다.
virtual BOOL CanBeAddedToQuickAccessToolBar() const;
반환 값
요소를 추가할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::CanBeCompacted
리본 요소의 크기를 압축할 수 있는지 여부를 나타냅니다.
virtual BOOL CanBeCompacted() const;
반환 값
리본 요소의 크기를 압축할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
리본 요소의 크기는 컴팩트, 중간 또는 큰 크기일 수 있습니다.
CMFCRibbonBaseElement::CanBeStretched
리본 메뉴 요소의 높이가 리본 행의 높이까지 세로로 증가할 수 있는지 여부를 나타냅니다.
virtual BOOL CanBeStretched();
반환 값
항상 TRUE를 반환합니다.
설명
기본적으로 이 메서드는 항상 TRUE를 반환합니다. 리본 메뉴 요소의 높이가 리본 행의 높이까지 세로로 증가할 수 있는지 여부를 나타내기 위해 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::CanBeStretchedHorizontally
리본 요소의 너비를 변경할 수 있는지 여부를 나타냅니다.
virtual BOOL CanBeStretchedHorizontally();
반환 값
항상 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] 리본 요소에 대한 포인터입니다.
반환 값
pElement가 현재 개체를 가리키는 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::FindByData
지정된 데이터가 포함된 경우 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* FindByData(DWORD_PTR dwData);
매개 변수
dwData
[in] 리본 요소와 연결된 데이터입니다.
반환 값
리본 요소에 지정된 데이터가 포함된 경우의 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::FindByID
해당 요소가 지정된 명령 ID로 식별되는 경우 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* FindByID(UINT uiCmdID);
매개 변수
uiCmdID
[in] 리본 요소의 명령 ID입니다.
반환 값
지정된 명령 ID로 해당 요소를 식별하는 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::FindByOriginal
원래 리본 요소가 지정된 리본 요소와 일치하는 경우 현재 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* FindByOriginal(CMFCRibbonBaseElement* pOriginal);
매개 변수
pOriginal
[in] 리본 요소에 대한 포인터입니다.
반환 값
원래 리본 요소가 지정된 리본 요소와 일치하는 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
다른 컨테이너에 복사되는 리본 요소는 원래 리본 요소에 대한 포인터를 유지합니다.
CMFCRibbonBaseElement::GetCompactSize
리본 요소의 압축 크기를 반환합니다.
virtual CSize GetCompactSize(CDC* pDC);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
반환 값
리본 요소의 압축 크기입니다.
참고 항목
압축 크기는 리본 요소가 잘리게 됨을 의미합니다(작은 이미지 또는 텍스트가 없는 이미지를 표시).
CMFCRibbonBaseElement::GetData
리본 요소와 연결된 사용자 정의 데이터를 검색합니다.
DWORD_PTR GetData() const;
반환 값
리본 요소와 연결된 사용자 정의 데이터입니다.
CMFCRibbonBaseElement::GetDescription
리본 요소에 대한 설명을 반환합니다.
virtual CString GetDescription() const;
반환 값
리본 요소 설명입니다. 설명은 상태 표시줄 또는 도구 설명에 표시되거나, 리본 요소가 CMFCRibbonMainPanel 클래스에 있는 경우 메뉴 단추 아래에 표시됩니다.
CMFCRibbonBaseElement::GetDroppedDown
팝업 메뉴가 드롭다운되면 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* GetDroppedDown();
반환 값
팝업 메뉴가 드롭다운된 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 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();
반환 값
리본 요소가 강조 표시된 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::GetID
리본 요소의 명령 ID를 반환합니다.
UINT GetID() const;
반환 값
리본 요소의 명령 ID입니다.
CMFCRibbonBaseElement::GetImageSize
리본 요소의 이미지 크기를 반환합니다.
virtual CSize GetImageSize(RibbonImageType R) const;
반환 값
리본 요소의 이미지 크기입니다.
CMFCRibbonBaseElement::GetIntermediateSize
중간 상태인 리본 요소의 크기를 반환합니다.
virtual CSize GetIntermediateSize(CDC* pDC);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
반환 값
중간 상태의 리본 요소 크기입니다.
CMFCRibbonBaseElement::GetKeys
리본 요소와 연결된 키 설명을 반환합니다.
LPCTSTR GetKeys() const;
반환 값
리본 요소와 연결된 키 설명입니다.
CMFCRibbonBaseElement::GetKeyTipRect
리본 요소의 키 설명 경계 사각형을 검색합니다.
virtual CRect GetKeyTipRect(
CDC* pDC,
BOOL bIsMenu);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
bIsMenu
[in] 리본 요소에 팝업 메뉴가 표시되면 TRUE입니다. 그렇지 않으면 FALSE입니다.
반환 값
항상 값이 0인 사각형을 반환합니다.
설명
키 설명 경계 사각형을 반환하려면 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::GetKeyTipSize
키 설명 텍스트의 크기를 검색합니다.
virtual CSize GetKeyTipSize(CDC* pDC);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
반환 값
키 설명 텍스트의 크기입니다.
설명
CMFCRibbonBaseElement::GetLocationInGroup
리본 그룹에 있는 리본 요소의 표시 위치를 나타냅니다.
RibbonElementLocation GetLocationInGroup() const;
반환 값
RibbonElementLocation 열거형 값입니다. 다음 표에서는 가능한 값을 나열합니다.
| 값 | 설명 |
|---|---|
RibbonElementNotInGroup |
리본 메뉴 요소가 리본 그룹에 포함되어 있지 않습니다. |
RibbonElementSingleInGroup |
리본 메뉴 요소는 리본 그룹의 유일한 항목으로 표시됩니다. |
RibbonElementFirstInGroup |
리본 메뉴 요소는 리본 그룹의 왼쪽 끝에 표시됩니다. |
RibbonElementLastInGroup |
리본 메뉴 요소는 리본 그룹의 오른쪽 끝에 표시됩니다. |
RibbonElementMiddleInGroup |
리본 메뉴 요소는 리본 그룹의 양쪽 끝에 표시되지 않습니다. |
설명
Ribbon 요소 그룹은 가로로만 정렬됩니다.
CMFCRibbonBaseElement::GetMenuKeys
리본 요소의 메뉴 키 설명을 반환합니다.
LPCTSTR GetMenuKeys() const;
반환 값
리본 요소와 연결된 메뉴 키 설명입니다.
설명
호출되면 메뉴 키 설명에 팝업 메뉴가 표시됩니다.
CMFCRibbonBaseElement::GetNotifyID
리본 요소에 대한 알림 명령 ID를 검색합니다.
virtual UINT GetNotifyID();
반환 값
알림 명령 ID입니다.
설명
CMFCRibbonBaseElement::GetOriginal
원래 리본 요소를 검색합니다.
CMFCRibbonBaseElement* GetOriginal() const;
반환 값
원래 리본 요소에 대한 포인터입니다.
설명
다른 컨테이너에 복사되는 리본 요소는 원래 리본 요소에 대한 포인터를 유지합니다.
CMFCRibbonBaseElement::GetParentCategory
리본 요소의 리본 범주를 검색합니다.
CMFCRibbonCategory* GetParentCategory() const;
반환 값
리본 범주에 대한 포인터입니다.
설명
CMFCRibbonBaseElement::GetParentPanel
리본 요소가 포함된 리본 패널을 검색합니다.
virtual CMFCRibbonPanel* GetParentPanel() const;
반환 값
리본 요소가 포함된 리본 패널에 대한 포인터입니다.
설명
CMFCRibbonBaseElement::GetParentRibbonBar
리본 요소의 부모 리본 표시줄을 검색합니다.
CMFCRibbonBar* GetParentRibbonBar() const;
반환 값
리본 요소의 부모 리본 표시줄에 대한 포인터입니다.
설명
CMFCRibbonBaseElement::GetParentWnd
리본 요소의 부모 창을 검색합니다.
virtual CWnd* GetParentWnd() const;
반환 값
메서드가 성공한 경우 리본 요소의 부모 창에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
리본 요소의 부모 창은 CMFCRibbonBar 클래스 또는 CMFCRibbonPanelMenuBar입니다.
CMFCRibbonBaseElement::GetPressed
사용자가 현재 리본 요소를 누르면 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* GetPressed();
반환 값
사용자가 현재 리본 요소를 누를 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::GetQuickAccessToolBarID
빠른 실행 도구 모음에 있을 때 리본 요소의 명령 ID를 검색합니다.
virtual UINT GetQuickAccessToolBarID() const;
반환 값
빠른 실행 도구 모음에 있는 경우 리본 요소의 명령 ID입니다.
설명
CMFCRibbonBaseElement::GetRect
리본 요소의 경계 사각형을 반환합니다.
CRect GetRect() const;
반환 값
리본 요소의 경계 사각형입니다. 사각형의 위치는 부모 리본 컨트롤의 좌표에 있습니다.
CMFCRibbonBaseElement::GetRegularSize
리본 요소의 보통 크기를 반환합니다.
virtual CSize GetRegularSize(CDC* pDC) = 0;
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
반환 값
리본 요소의 일반 크기입니다.
설명
참고 항목
일반 크기는 리본 요소의 최대 가능한 크기입니다.
CMFCRibbonBaseElement::GetSize
리본 요소의 현재 크기를 반환합니다.
virtual CSize GetSize(CDC* pDC);
매개 변수
pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.
반환 값
리본 요소의 현재 크기입니다.
CMFCRibbonBaseElement::GetText
리본 요소와 연결된 텍스트를 반환합니다.
LPCTSTR GetText() const;
반환 값
리본 요소와 연결된 텍스트입니다.
CMFCRibbonBaseElement::GetToolTipText
리본 요소의 도구 설명 텍스트를 반환합니다.
virtual CString GetToolTipText() const;
반환 값
리본 요소의 도구 설명 텍스트입니다.
CMFCRibbonBaseElement::GetTopLevelRibbonBar
리본 요소의 최상위 리본 표시줄을 검색합니다.
CMFCRibbonBar* GetTopLevelRibbonBar() const;
반환 값
메서드가 성공한 경우 리본 요소의 최상위 리본 표시줄에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCRibbonBaseElement::HasCompactMode
리본 요소에 압축 모드가 있는지 여부를 지정합니다.
virtual BOOL HasCompactMode() const;
반환 값
리본 요소에 압축 모드가 있는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
참고 항목
압축 모드에서 요소는 작은 이미지만 표시합니다.
CMFCRibbonBaseElement::HasIntermediateMode
리본 요소에 중간 모드가 있는지 여부를 지정합니다.
virtual BOOL HasIntermediateMode() const;
반환 값
리본 요소에 중간 모드가 있으면 TRUE이고, 그렇지 않으면 FALSE입니다. 중간 모드에서 요소는 이미지 오른쪽에 작은 이미지와 텍스트를 표시합니다.
설명
CMFCRibbonBaseElement::HasLargeMode
리본 요소에 큰 모드가 있는지 여부를 결정합니다.
virtual BOOL HasLargeMode() const;
반환 값
리본 요소에 큰 모드가 있는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
큰 모드에서 요소는 부모 패널의 전체 높이를 취할 수 있습니다.
CMFCRibbonBaseElement::HasMenu
리본 요소에 메뉴가 있는지 여부를 나타냅니다.
virtual BOOL HasMenu() const;
반환 값
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 리본 요소에 메뉴가 있는지 여부를 나타내기 위해 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::HitTest
지정한 점이 있는 경우 리본 요소에 대한 포인터를 검색합니다.
virtual CMFCRibbonBaseElement* HitTest(CPoint point);
매개 변수
point
[in] 이 매개 변수는 사용되지 않습니다.
반환 값
리본 요소에 대한 포인터(있는 경우)입니다. 그렇지 않으면 FALSE입니다.
설명
기본적으로 이 메서드는 리본 요소가 있을 때 항상 유효한 포인터를 반환합니다. 이 메서드를 재정의하여 점이 리본 요소에 있는지 여부를 나타냅니다.
CMFCRibbonBaseElement::IsAlignByColumn
리본 요소가 다른 리본 요소와 세로로 정렬되는지 여부를 나타냅니다.
virtual BOOL IsAlignByColumn() const;
반환 값
항상 TRUE를 반환합니다.
설명
기본적으로 이 메서드는 항상 TRUE를 반환합니다. 파생된 리본 요소가 다른 리본 요소와 세로로 정렬되는지 여부를 나타내기 위해 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::IsAlwaysLargeImage
리본 요소 이미지 크기가 항상 큰지 여부를 나타냅니다.
virtual BOOL IsAlwaysLargeImage() const;
반환 값
리본 요소 이미지 크기가 항상 크면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
큰 이미지 크기는 32 x 32 픽셀입니다.
CMFCRibbonBaseElement::IsAutoRepeatMode
리본 요소가 자동 반복 모드인지 여부를 나타냅니다.
virtual BOOL IsAutoRepeatMode(int& nDelay) const;
매개 변수
nDelay
[in] 이 매개 변수는 사용되지 않습니다.
반환 값
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 리본 요소가 자동 반복 모드에 있는지 여부를 나타내려면 이 메서드를 재정의합니다.
자동 반복 모드에서 리본 요소는 설정된 간격(밀리초)으로 응답하여 지속적인 사용자 입력에 응답합니다.
CMFCRibbonBaseElement::IsChecked
리본 요소의 선택 여부를 지정합니다.
virtual BOOL IsChecked() const;
반환 값
리본 요소가 선택되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsCompactMode
리본 요소가 압축 모드에 있는지 여부를 지정합니다.
BOOL IsCompactMode() const;
반환 값
리본 요소가 압축 모드인 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsDefaultMenuLook
리본 요소가 팝업 명령으로 표시되도록 설정되어 있는지 여부를 나타냅니다.
BOOL IsDefaultMenuLook() const;
반환 값
리본 요소가 팝업 명령으로 표시되도록 설정된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsDisabled
리본 요소를 사용하지 않도록 설정할지 여부를 지정합니다.
virtual BOOL IsDisabled() const;
반환 값
리본 요소를 사용할 수 없으면 TRUE이고, 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsDroppedDown
리본 요소에 팝업 메뉴가 표시되고 드롭다운되는지 여부를 지정합니다.
virtual BOOL IsDroppedDown() const;
반환 값
리본 메뉴 요소가 드롭다운되고 팝업 메뉴가 표시되면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsFocused
리본 요소에 포커스가 있는지 여부를 지정합니다.
virtual BOOL IsFocused() const;
반환 값
리본 요소에 포커스가 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsGalleryIcon
리본 갤러리에 리본 요소가 포함되어 있는지 여부를 나타냅니다.
virtual BOOL IsGalleryIcon() const;
반환 값
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 리본 갤러리에 리본 요소가 포함되어 있는지 여부를 나타내기 위해 파생 클래스에서 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::IsHighlighted
리본 요소의 강조 표시 여부를 지정합니다.
virtual BOOL IsHighlighted() const;
반환 값
리본 요소가 강조 표시된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsIntermediateMode
리본 요소의 현재 이미지가 중간 크기인지 여부를 나타냅니다.
BOOL IsIntermediateMode() const;
반환 값
리본 요소의 이미지가 중간 크기이면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
중간 이미지 크기는 16 x 16 픽셀입니다.
CMFCRibbonBaseElement::IsLargeMode
리본 요소의 현재 이미지가 큰지 여부를 나타냅니다.
BOOL IsLargeMode() const;
반환 값
리본 요소의 이미지가 큰 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
큰 이미지 크기는 32 x 32 픽셀입니다.
CMFCRibbonBaseElement::IsMenuMode
리본 요소가 메뉴에 포함되어 있는지 여부를 나타냅니다.
BOOL IsMenuMode() const;
반환 값
메뉴에 리본 요소가 포함되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsPressed
사용자가 리본 요소를 클릭했는지 여부를 나타냅니다.
virtual BOOL IsPressed() const;
반환 값
사용자가 리본 요소를 클릭한 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCRibbonBaseElement::IsQATMode
리본 요소가 빠른 실행 도구 모음에 포함되어 있는지 여부를 나타냅니다.
BOOL IsQATMode() const;
반환 값
빠른 실행 도구 모음에 리본 요소가 포함되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsSeparator
리본 요소가 표시 구분 기호인지 여부를 나타냅니다.
virtual BOOL IsSeparator() const;
반환 값
리본 요소가 표시 구분 기호이면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsShowGroupBorder
리본 요소가 공통 테두리를 표시하는 그룹에 포함되어 있는지 여부를 나타냅니다.
BOOL IsShowGroupBorder() const;
반환 값
리본 메뉴 요소가 공통 테두리를 표시하는 그룹에 포함되어 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsShowTooltipOnBottom
도구 설명이 리본 요소 아래에 표시되는지 여부를 나타냅니다.
virtual BOOL IsShowTooltipOnBottom() const;
반환 값
도구 설명이 리본 요소 아래에 표시되면 TRUE이고, 포인터 근처에 도구 설명이 표시되면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsTabStop
키보드를 사용하여 리본 요소를 선택할 수 있는지 여부를 나타냅니다.
virtual BOOL IsTabStop() const;
반환 값
항상 TRUE를 반환합니다.
설명
기본적으로 이 메서드는 항상 TRUE를 반환합니다. 키보드를 사용하여 리본 요소를 선택할 수 있는지 여부를 나타내기 위해 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::IsTextAlwaysOnRight
리본 요소의 텍스트가 오른쪽에 표시되는지 여부를 나타냅니다.
BOOL IsTextAlwaysOnRight() const;
반환 값
리본 요소의 텍스트가 오른쪽에 표시되면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsVisible
리본 요소가 현재 표시되는지 여부를 나타냅니다.
BOOL IsVisible() const;
반환 값
리본 요소가 현재 표시되는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::IsWholeRowHeight
리본 요소의 표시 높이가 리본 패널이 포함된 리본 패널의 표시 높이와 같은지 여부를 나타냅니다.
virtual BOOL IsWholeRowHeight() const;
반환 값
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 리본 요소의 표시 높이가 포함된 리본 패널의 표시 높이와 같은지 여부를 나타내려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::NotifyCommand
리본 요소의 부모 창에 명령 알림을 보냅니다.
BOOL NotifyCommand(BOOL bWithDelay = FALSE);
매개 변수
bWithDelay
[in] TRUE이면 부모 창의 메시지 큐에 명령 알림을 추가합니다. 부모 창에 메시지를 즉시 보내려면 FALSE입니다.
반환 값
메시지가 전송된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::NotifyHighlightListItem
사용자가 목록에 있는 리본 요소를 강조 표시할 때 리본 표시줄의 부모 창에 알립니다.
virtual void NotifyHighlightListItem(int nIndex);
매개 변수
nIndex
[in] 목록에 있는 리본 요소의 인덱스입니다.
설명
CMFCRibbonBaseElement::OnAddToQAToolbar
리본 요소를 지정된 빠른 실행 도구 모음에 추가합니다.
virtual BOOL OnAddToQAToolbar(CMFCRibbonQuickAccessToolBar& qat);
매개 변수
qat
[in] 빠른 실행 도구 모음입니다.
반환 값
리본 요소가 빠른 실행 도구 모음에 추가되었음을 나타내는 TRUE를 항상 반환합니다.
설명
CMFCRibbonBaseElement::OnAfterChangeRect
리본 요소의 도구 설명을 업데이트합니다.
virtual void OnAfterChangeRect(CDC* pDC);
매개 변수
pDC
[in] 이 매개 변수는 사용되지 않습니다.
설명
기본적으로 이 메서드는 리본 요소의 도구 설명을 업데이트합니다. 표시 사각형이 변경된 후 리본 요소를 업데이트하려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnAutoRepeat
지속적인 사용자 입력에 대한 응답으로 리본 요소를 업데이트합니다.
virtual BOOL OnAutoRepeat();
반환 값
항상 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] 메뉴 이미지 사각형입니다.
반환 값
항상 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입니다.
반환 값
이벤트가 처리되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonBaseElement::OnMenuKey
사용자가 주 패널에서 메뉴 키 설명을 누를 때 프레임워크에서 호출됩니다.
virtual BOOL OnMenuKey(UINT nUpperChar);
매개 변수
nUpperChar
[in] 이 매개 변수는 사용되지 않습니다.
반환 값
항상 FALSE를 반환합니다.
설명
기본적으로 이 메서드는 항상 FALSE를 반환합니다. 사용자가 주 패널에서 메뉴 키 설명을 누를 때 응답하도록 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::OnProcessKey
사용자가 바로 가기 키를 누를 때 프레임워크에서 호출됩니다.
virtual BOOL OnProcessKey(UINT nChar);
매개 변수
nChar
[in] 이 매개 변수는 사용되지 않습니다.
반환 값
항상 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
리본 요소에 대한 내게 필요한 옵션 데이터입니다.
반환 값
항상 TRUE를 반환합니다.
설명
기본적으로 이 메서드는 리본 요소에 대한 접근성 데이터를 설정하고 항상 TRUE를 반환합니다. 내게 필요한 옵션 데이터를 설정하고 성공 또는 실패를 나타내는 값을 반환하려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::SetCompactMode
리본 요소의 표시 크기를 설정합니다.
virtual void SetCompactMode(BOOL bCompactMode = TRUE);
매개 변수
bCompactMode
[in] 리본 요소의 표시 크기를 줄이려면 TRUE입니다. FALSE를 사용하여 리본 요소의 표시 크기를 늘입니다.
설명
다음 표에서는 이 메서드의 논리를 요약합니다.
| bCompactMode | 현재 리본 요소 크기 | 새 리본 요소 크기 |
|---|---|---|
| TRUE | Compact | 변경되지 않았습니다. |
| TRUE | Intermediate | 가능하면 압축합니다. |
| TRUE | 대형 | 가능하면 중간입니다. |
| 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] 행의 높이입니다.
반환 값
표시 높이가 설정된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
리본 요소의 표시 높이를 지정된 행 높이로 변경하려면 이 메서드를 재정의합니다.
CMFCRibbonBaseElement::UpdateTooltipInfo
리본 요소에 대한 명령 리소스를 사용하여 도구 설명 텍스트를 업데이트합니다.
virtual void UpdateTooltipInfo();
설명
CMFCRibbonBaseElement::HasFocus
부모 요소에 키보드 포커스가 있는지 여부를 나타냅니다.
virtual BOOL HasFocus() const;
반환 값
리본 요소에 포커스가 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.