CMFCRibbonBar 클래스

CMFCRibbonBar 클래스는 Office 2007에서 사용한 것과 비슷한 리본 표시줄을 구현합니다.

자세한 내용은 Visual Studio 설치 폴더에 mfc 있는 소스 코드를 참조하세요. 예: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

구문

class CMFCRibbonBar : public CPane

멤버

공용 생성자

속성	설명
CMFCRibbonBar::CMFCRibbonBar	기본 생성자입니다.

공용 메서드

이름	설명
CMFCRibbonBar::ActivateContextCategory	이미 표시된 컨텍스트 범주를 활성화합니다.
CMFCRibbonBar::AddCategory	리본 메뉴에 새 리본 범주를 추가합니다.
CMFCRibbonBar::AddContextCategory	컨텍스트 범주를 추가합니다.
CMFCRibbonBar::AddMainCategory	새 기본 리본 범주를 추가합니다.
CMFCRibbonBar::AddPrintPreviewCategory
CMFCRibbonBar::AddQATOnlyCategory
CMFCRibbonBar::AddToTabs	리본 표시줄 오른쪽에 리본 요소를 추가합니다.
CMFCRibbonBar::CreateEx	컨트롤 막대를 만들어 개체에 CPane 연결합니다. ( CPane::CreateEx을 재정의합니다.)
CMFCRibbonBar::Create	리본 표시줄 컨트롤을 만들고 리본 표시줄에 연결합니다.
CMFCRibbonBar::DeactivateKeyboardFocus
CMFCRibbonBar::DrawMenuImage
CMFCRibbonBar::DWMCompositionChanged
CMFCRibbonBar::EnableKeyTips	리본 컨트롤에 대한 키 팁을 사용하거나 사용하지 않도록 설정합니다.
CMFCRibbonBar::EnablePrintPreview	인쇄 미리 보기 탭을 사용하도록 설정합니다.
CMFCRibbonBar::EnableToolTips	리본 표시줄에서 도구 설명 및 도구 설명에 대한 설명을 사용하거나 사용하지 않도록 설정합니다.
CMFCRibbonBar::FindByData	사용자가 지정하는 데이터를 사용하여 리본 요소를 찾습니다.
CMFCRibbonBar::FindByID	지정된 명령 ID가 있는 리본 요소를 찾습니다.
CMFCRibbonBar::FindCategoryIndexByData	사용자 정의 데이터를 포함하는 리본 범주의 인덱스를 찾습니다.
CMFCRibbonBar::ForceRecalcLayout
CMFCRibbonBar::GetActiveCategory	활성 범주에 대한 포인터를 가져옵니다.
CMFCRibbonBar::GetCaptionHeight	캡션 높이를 반환합니다. ( CBasePane::GetCaptionHeight을 재정의합니다.)
CMFCRibbonBar::GetCategory	지정된 인덱스에 있는 범주에 대한 포인터를 가져옵니다.
CMFCRibbonBar::GetCategoryCount	리본 표시줄에서 리본 범주 수를 가져옵니다.
CMFCRibbonBar::GetCategoryHeight
CMFCRibbonBar::GetCategoryIndex	리본 범주의 인덱스를 반환합니다.
CMFCRibbonBar::GetContextName	ID를 사용하여 지정한 컨텍스트 범주 캡션 이름을 검색합니다.
CMFCRibbonBar::GetDroppedDown
CMFCRibbonBar::GetElementsByID	지정된 ID를 가진 모든 리본 요소에 대한 포인터를 포함하는 배열을 가져옵니다.
CMFCRibbonBar::GetApplicationButton	리본 단추에 대한 포인터를 가져옵니다.
CMFCRibbonBar::GetFocused	포커스가 지정된 요소를 반환합니다.
CMFCRibbonBar::GetHideFlags
CMFCRibbonBar::GetItemIDsList
CMFCRibbonBar::GetKeyboardNavigationLevel
CMFCRibbonBar::GetKeyboardNavLevelCurrent
CMFCRibbonBar::GetKeyboardNavLevelParent
CMFCRibbonBar::GetMainCategory	현재 선택된 리본 범주에 대한 포인터를 반환합니다.
CMFCRibbonBar::GetQATCommandsLocation
CMFCRibbonBar::GetQATDroppedDown
CMFCRibbonBar::GetQuickAccessCommands	빠른 실행 도구 모음에 나타나는 모든 요소의 명령 ID를 포함하는 목록을 채웁니다.
CMFCRibbonBar::GetQuickAccessToolbarLocation
CMFCRibbonBar::GetTabTrancateRatio
CMFCRibbonBar::GetTooltipFixedWidthLargeImage
CMFCRibbonBar::GetTooltipFixedWidthRegular
CMFCRibbonBar::GetVisibleCategoryCount
CMFCRibbonBar::HideAllContextCategories	표시되고 활성 상태인 모든 범주를 숨깁니다.
CMFCRibbonBar::HideKeyTips
CMFCRibbonBar::HitTest	리본 표시줄 클라이언트 좌표의 지정된 지점에 있는 리본 요소에 대한 포인터를 찾습니다.
CMFCRibbonBar::IsKeyTipEnabled	키 팁을 사용할지 결정합니다.
CMFCRibbonBar::IsMainRibbonBar
CMFCRibbonBar::IsPrintPreviewEnabled	인쇄 미리 보기 탭을 사용할 수 있는지 여부를 확인합니다.
CMFCRibbonBar::IsQATEmpty
CMFCRibbonBar::IsQuickAccessToolbarOnTop	빠른 실행 도구 모음을 리본 표시줄 위에 표시할지 지정합니다.
CMFCRibbonBar::IsReplaceFrameCaption	리본 표시줄이 주 프레임 캡션을 대체할지, 아니면 프레임 캡션 아래에 추가할지를 결정합니다.
CMFCRibbonBar::IsShowGroupBorder
CMFCRibbonBar::IsToolTipDescrEnabled	도구 설명에 대한 설명을 사용하도록 설정할지 결정합니다.
CMFCRibbonBar::IsToolTipEnabled	리본 표시줄에 대한 도구 설명을 사용하도록 설정할지 결정합니다.
CMFCRibbonBar::IsTransparentCaption
CMFCRibbonBar::IsWindows7Look	리본 메뉴에 Windows 7 스타일 모양(작은 사각형 애플리케이션 단추)이 있는지 여부를 나타냅니다.
CMFCRibbonBar::LoadFromResource	오버로드됨. 애플리케이션 리소스에서 리본 표시줄을 로드합니다.
CMFCRibbonBar::OnClickButton
CMFCRibbonBar::OnEditContextMenu
CMFCRibbonBar::OnRTLChanged	( CPane::OnRTLChanged을 재정의합니다.)
CMFCRibbonBar::OnSetAccData	( CBasePane::OnSetAccData을 재정의합니다.)
CMFCRibbonBar::OnShowRibbonContextMenu
CMFCRibbonBar::OnShowRibbonQATMenu
CMFCRibbonBar::OnSysKeyDown
CMFCRibbonBar::OnSysKeyUp
CMFCRibbonBar::PopTooltip
CMFCRibbonBar::PreTranslateMessage	( CBasePane::PreTranslateMessage을 재정의합니다.)
CMFCRibbonBar::RecalcLayout	( CPane::RecalcLayout을 재정의합니다.)
CMFCRibbonBar::RemoveAllCategories	리본 표시줄에서 모든 리본 범주를 제거합니다.
CMFCRibbonBar::RemoveAllFromTabs	탭 영역에서 모든 리본 요소를 제거합니다.
CMFCRibbonBar::RemoveCategory	지정된 인덱스에 있는 리본 범주를 제거합니다.
CMFCRibbonBar::SaveToXMLBuffer	리본 표시줄을 버퍼에 저장합니다.
CMFCRibbonBar::SaveToXMLFile	리본 표시줄을 XML 파일에 저장합니다.
CMFCRibbonBar::SetActiveCategory	지정된 리본 범주를 활성으로 설정합니다.
CMFCRibbonBar::SetActiveMDIChild
CMFCRibbonBar::SetElementKeys	지정된 명령 ID를 가진 모든 리본 요소에 대해 지정된 키 팁을 설정합니다.
CMFCRibbonBar::SetApplicationButton	리본 표시줄에 애플리케이션 리본 단추를 할당합니다.
CMFCRibbonBar::SetKeyboardNavigationLevel
CMFCRibbonBar::SetMaximizeMode
CMFCRibbonBar::SetQuickAccessCommands	빠른 실행 도구 모음에 하나 이상의 리본 요소를 추가합니다.
CMFCRibbonBar::SetQuickAccessDefaultState	빠른 실행 도구 모음에 대한 기본 상태를 지정합니다.
CMFCRibbonBar::SetQuickAccessToolbarOnTop	QAT(빠른 실행 도구 모음)를 리본 표시줄 위 또는 아래에 배치합니다.
CMFCRibbonBar::SetTooltipFixedWidth
CMFCRibbonBar::SetWindows7Look	리본 Windows 7 스타일 모양(작은 사각형 애플리케이션 단추)을 사용하거나 사용하지 않도록 설정합니다.
CMFCRibbonBar::ShowCategory	지정된 리본 범주를 표시하거나 숨깁니다.
CMFCRibbonBar::ShowContextCategories	지정된 ID를 가진 컨텍스트 범주를 표시하거나 숨깁니다.
CMFCRibbonBar::ShowKeyTips
CMFCRibbonBar::ToggleMimimizeState	리본 표시줄을 최소화 상태 또는 최대화 상태로 표시합니다.
CMFCRibbonBar::TranslateChar

설명

Microsoft에서는 Microsoft Office 2007을 릴리스할 때 동시에 Office Fluent 리본을 도입했습니다. 이 리본 메뉴 모음은 새 컨트롤이 아닙니다. 새로운 사용자 인터페이스 패러다임을 나타냅니다. 리본은 범주라는 탭 집합을 포함하는 창입니다. 각 범주는 논리적으로 리본 패널로 구분되고 각 패널에는 다양한 컨트롤과 명령 단추가 포함됩니다.

리본 표시줄에 표시되는 요소가 사용 가능한 공간에 가장 적합한 크기로 확장 및 축소됩니다. 예를 들어 리본 패널에 해당 요소를 표시할 공간이 부족하면 리본 메뉴는 하위 항목을 팝업 메뉴에 표시하는 메뉴 단추가 됩니다. 리본 표시줄은 정적(부동화되지 않음) 컨트롤 막대로 동작하고 프레임의 위쪽에 도킹될 수 있습니다.

CMFCRibbonStatusBar 클래스를 사용하여 Office 2007에서 사용된 것과 비슷한 상태 표시줄을 구현할 수 있습니다. 리본 범주에는 리본 패널 그룹이 포함되고 표시됩니다. 각 리본 패널에는 .에서 CMFCRibbonBaseElement파생된 하나 이상의 리본 요소가 포함되어 있습니다.

기존 MFC 애플리케이션에 리본 표시줄을 추가하는 방법에 대한 자세한 내용은 연습: MFC Scribble 애플리케이션 업데이트 방법을 참조하세요.

상속 계층 구조

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCRibbonBar

요구 사항

헤더afxribbonbar.h:

CMFCRibbonBar::ActivateContextCategory

이미 표시된 컨텍스트 범주를 활성화합니다.

BOOL ActivateContextCategory(UINT uiContextID);

매개 변수

uiContextID
[in] 컨텍스트 범주 ID입니다.

Return Value

TRUE 컨텍스트 범주를 찾아서 활성화하면 uiContextID 이고, 그렇지 않으면 FALSE.

CMFCRibbonBar::AddCategory

리본 표시줄에 대한 새 리본 범주를 만들고 초기화합니다.

CMFCRibbonCategory* AddCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage= CSize(16,
    16),
    CSize sizeLargeImage= CSize(32,
    32),
    int nInsertAt = -1,
    CRuntimeClass* pRTI= NULL);

매개 변수

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

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

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

sizeSmallImage
[in] 리본 범주에 대한 작은 이미지의 크기를 지정합니다.

sizeLargeImage
[in] 리본 범주에 대한 큰 이미지의 크기를 지정합니다.

nInsertAt
[in] 범주 위치의 인덱스(0부터 시작하는 인덱스)입니다.

pRTI
[in] 런타임에 리본 범주를 CMFCRibbonCategory 동적으로 만드는 클래스 런타임 클래스에 대한 포인터입니다.

Return Value

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

설명

매개 변수가 pRTI 없 NULL으면 런타임 클래스를 사용하여 새 리본 범주가 동적으로 만들어집니다.

예시

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

// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory *pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
                                                               IDB_WRITESMALL, IDB_WRITELARGE);

CMFCRibbonBar::AddContextCategory

리본 표시줄에 대한 새 컨텍스트 범주를 만들고 초기화합니다.

CMFCRibbonCategory* AddContextCategory(
    LPCTSTR lpszName,
    LPCTSTR lpszContextName,
    UINT uiContextID,
    AFX_RibbonCategoryColor clrContext,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32),
    CRuntimeClass* pRTI = NULL);

매개 변수

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

lpszContextName
[in] 컨텍스트 범주 캡션 이름입니다.

uiContextID
[in] 컨텍스트 ID입니다.

clrContext
[in] 컨텍스트 범주 캡션 색입니다.

uiSmallImagesResID
[in] 컨텍스트 범주의 작은 이미지에 대한 리소스 ID입니다.

uiLargeImagesResID
[in] 컨텍스트 범주의 큰 이미지에 대한 리소스 ID입니다.

sizeSmallImage
[in] 작은 이미지의 크기입니다.

sizeLargeImage
[in] 큰 이미지의 크기입니다.

pRTI
[in] 런타임 클래스에 대한 포인터입니다.

Return Value

새로 만든 범주에 대한 포인터이거나 NULL 메서드가 CreateObjectpRTI 지정된 범주를 만들 수 없는 경우

설명

이 함수를 사용하여 컨텍스트 범주를 추가합니다. 컨텍스트 범주는 현재 애플리케이션 컨텍스트에 따라 런타임에 표시되거나 숨겨질 수 있는 특수한 유형의 범주입니다. 예를 들어 사용자가 개체를 선택하면 컨텍스트 범주가 있는 특수 탭을 표시할 수 있습니다. 이 탭은 선택한 특정 개체를 변경하는 데 사용합니다.

컨텍스트 범주의 색은 다음 값 중 하나일 수 있습니다.

• AFX_CategoryColor_None

• AFX_CategoryColor_Red

• AFX_CategoryColor_Orange

• AFX_CategoryColor_Yellow

• AFX_CategoryColor_Green

• AFX_CategoryColor_Blue

• AFX_CategoryColor_Indigo

• AFX_CategoryColor_Violet

CMFCRibbonBar::AddMainCategory

리본 표시줄에 대한 새 기본 리본 범주를 만듭니다.

CMFCRibbonMainPanel* AddMainCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32));

매개 변수

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

uiSmallImagesResID
[in] 작은 이미지의 리소스 ID입니다.

uiLargeImagesResID
[in] 큰 이미지의 리소스 ID입니다.

sizeSmallImage
[in] 작은 이미지의 크기입니다.

sizeLargeImage
[in] 큰 이미지의 크기입니다.

Return Value

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

설명

기본 리본 범주가 이미 있는 경우 삭제됩니다.

예시

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

// m_wndRibbonBar is declared as a protected member variable
// CMFCRibbonBar m_wndRibbonBar.
// strTemp is a CString variable.
strTemp.LoadString(IDS_RIBBON_FILE);
CMFCRibbonMainPanel *pMainPanel = m_wndRibbonBar.AddMainCategory(strTemp,
                                                                 IDB_FILESMALL, IDB_FILELARGE);

CMFCRibbonBar::AddPrintPreviewCategory

리본 표시줄에 인쇄 미리 보기 범주를 만듭니다.

CMFCRibbonCategory* AddPrintPreviewCategory();

Return Value

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

설명

이 메서드는 인쇄 미리 보기를 제공하기 위해 리본 범주 및 필요한 컨트롤을 만듭니다.

CMFCRibbonBar::AddQATOnlyCategory

빠른 실행 도구 모음 리본 범주를 만듭니다.

CMFCRibbonCategory* AddQATOnlyCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    CSize sizeSmallImage = CSize(16,
    16));

매개 변수

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

uiSmallImagesResID
[in] 범주에 대한 이미지 목록의 리소스 ID입니다.

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

Return Value

메서드가 성공한 경우 새 범주에 대한 포인터입니다. 그렇지 않으면 . NULL

설명

빠른 실행 도구 모음 리본 범주는 빠른 실행 도구 모음 사용자 지정 대화 상자에서만 사용됩니다.

CMFCRibbonBar::AddToTabs

리본 표시줄의 탭 행에 지정된 리본 요소를 추가합니다.

void AddToTabs(CMFCRibbonBaseElement* pElement);

매개 변수

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

설명

리본 요소는 시스템 단추 앞에 배치됩니다.

CMFCRibbonBar::CMFCRibbonBar

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

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

매개 변수

bReplaceFrameCaption
[in] TRUE 리본 표시줄이 기본 프레임 창의 캡션 바꾸려면 이고, FALSE 기본 프레임 창의 캡션 아래에 있는 리본 표시줄을 찾습니다.

설명

CMFCRibbonBar::Create

리본 표시줄에 대한 창을 만듭니다.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

매개 변수

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

dwStyle
[in] 새 창에 대한 스타일의 논리적 조합입니다.

nID
[in] 새 창의 ID입니다.

Return Value

TRUE 창이 만들어졌으면 FALSE.

설명

예시

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

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.Create(this, WS_CHILD | CBRS_TOP);

CMFCRibbonBar::CreateEx

리본 표시줄에 대한 창을 만듭니다.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = 0,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

매개 변수

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

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

dwStyle
[in] 새 창에 대한 스타일의 논리적 조합입니다.

nID
[in] 새 창의 ID입니다.

Return Value

TRUE 창이 만들어졌으면 FALSE.

설명

CMFCRibbonBar::DeactivateKeyboardFocus

리본 표시줄의 모든 키 설명 컨트롤을 닫습니다.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

매개 변수

bSetFocus
[in] TRUE 리본 표시줄의 부모 창에 포커스를 설정합니다.

설명

CMFCRibbonBar::DrawMenuImage

메뉴 단추에 대한 이미지를 그립니다.

BOOL DrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuItem,
    const CRect& rectImage);

매개 변수

pDC
[in] 메뉴 단추의 디바이스 컨텍스트에 대한 포인터입니다.

pMenuItem
[in] 도구 모음 메뉴 단추에 대한 포인터입니다.

rectImage
[in] 메뉴 단추의 표시 사각형입니다.

Return Value

TRUE 이미지가 그려졌으면 FALSE.

설명

CMFCRibbonBar::DWMCompositionChanged

DWM(데스크톱 창 관리자) 컴퍼지션을 사용하거나 사용하지 않도록 설정할 때 리본 표시줄의 표시를 조정합니다.

virtual void DWMCompositionChanged();

설명

CMFCRibbonBar::EnableKeyTips

리본 표시줄에 대한 키 설명 기능을 사용하거나 사용하지 않도록 설정합니다.

void EnableKeyTips(BOOL bEnable = TRUE);

매개 변수

bEnable
[in] TRUE 키 설명 기능을 사용하도록 설정하려면 다음을 실행합니다. FALSE 키 설명 기능을 사용하지 않도록 설정합니다.

설명

이 기능을 사용하도록 설정하면 사용자가 ALT 또는 F10 키를 누를 때 키 팁이 표시됩니다. 사용자가 ALT 키를 누르면 키 팁이 200밀리초 지연으로 표시됩니다. 이 지연을 사용하면 누른 ALT 키가 ALT 키를 포함하는 다른 조합을 방해하지 않도록 바로 가기를 실행할 수 있습니다.

CMFCRibbonBar::EnablePrintPreview

인쇄 미리 보기 기능을 사용하거나 사용하지 않도록 설정합니다.

void EnablePrintPreview(BOOL bEnable = TRUE);

매개 변수

bEnable
[in] TRUE 인쇄 미리 보기 기능을 사용하도록 설정하려면 인쇄 미리 보기 기능을 FALSE 사용하지 않도록 설정합니다.

설명

있는 FALSE 경우 bEnable 인쇄 미리 보기 범주가 있으면 삭제됩니다.

기본적으로 인쇄 미리 보기 기능은 사용하도록 설정되어 있습니다.

CMFCRibbonBar::EnableToolTips

리본 표시줄에서 도구 설명 및 선택적 도구 설명 설명을 사용하거나 사용하지 않도록 설정합니다.

void EnableToolTips(
    BOOL bEnable = TRUE,
    BOOL bEnableDescr = TRUE);

매개 변수

bEnable
[in] TRUE 리본 표시줄에서 도구 설명을 사용하도록 설정하려면 입니다. FALSE 리본 표시줄에서 도구 설명을 사용하지 않도록 설정합니다.

bEnableDescr
[in] TRUE 도구 설명에서 도구 설명 설명을 사용하도록 설정하려면 다음을 실행합니다. FALSE 도구 설명에서 도구 설명 설명을 사용하지 않도록 설정합니다.

설명

매개 변수는 bEnable 마우스가 리본 요소 위에 마우스를 놓을 때 도구 설명이 표시되는지 여부를 결정합니다. 매개 변수는 bEnableDescr 추가 설명 텍스트가 도구 설명 텍스트와 함께 표시되는지 여부를 결정합니다.

CMFCRibbonBar::FindByData

지정된 데이터 및 표시 유형이 있는 경우 리본 요소에 대한 포인터를 검색합니다.

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

매개 변수

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

bVisibleOnly
[in] TRUE 표시되는 리본 요소만 검색하려면 입니다. FALSE 모든 리본 요소를 검색합니다.

Return Value

리본 요소에 지정된 데이터 및 표시 유형이 있는 경우의 포인터입니다. 그렇지 않으면 NULL.

설명

리본 요소는 리본 단추, 리본 범주 또는 리본 슬라이더와 같이 리본 메뉴에 추가할 수 있는 컨트롤입니다.

CMFCRibbonBar::FindByID

지정된 명령 ID 및 검색 값이 있는 리본 요소에 대한 포인터를 검색합니다.

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

매개 변수

uiCmdID
[in] 리본 요소의 명령 ID입니다.

bVisibleOnly
[in] TRUE 표시되는 리본 요소만 검색하려면 입니다. FALSE 모든 리본 요소를 검색합니다.

bExcludeQAT
[in] TRUE 빠른 실행 도구 모음 요소를 검색에서 제외하려면 입니다. 그렇지 않으면 . FALSE

Return Value

지정된 명령 ID 및 검색 값이 있는 경우 리본 요소에 대한 포인터입니다. 그렇지 않으면 . NULL

설명

리본 요소는 리본 단추, 리본 범주 또는 리본 슬라이더와 같이 리본 메뉴에 추가할 수 있는 모든 리본 컨트롤입니다.

일반적으로 명령 ID가 동일한 리본 요소가 둘 이상 있을 수 있습니다. 지정된 명령 ID를 사용하는 모든 리본 요소에 대한 포인터를 가져오려면 이 메서드를 CMFCRibbonBar::GetElementsByID 사용합니다.

CMFCRibbonBar::FindCategoryIndexByData

지정된 데이터가 포함된 리본 범주의 인덱스를 검색합니다.

int FindCategoryIndexByData(DWORD dwData) const;

매개 변수

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

Return Value

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

CMFCRibbonBar::ForceRecalcLayout

리본 표시줄 및 부모 창에 있는 모든 항목의 레이아웃을 조정하고 전체 창을 다시 그립니다.

void ForceRecalcLayout();

설명

CMFCRibbonBar::GetActiveCategory

활성 리본 범주에 대한 포인터를 검색합니다.

CMFCRibbonCategory* GetActiveCategory() const;

Return Value

활성 리본 범주에 대한 포인터입니다. 또는 NULL 활성 상태인 범주가 없는 경우

설명

포커스가 있는 경우 범주가 활성화됩니다. 기본적으로 활성 범주는 리본 표시줄의 왼쪽에 있는 첫 번째 범주입니다.

사용자가 애플리케이션 단추를 누르면 기본 범주가 표시되며 활성 범주가 될 수 없습니다.

CMFCRibbonBar::GetApplicationButton

애플리케이션 단추에 대한 포인터를 검색합니다.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Return Value

애플리케이션 단추에 대한 포인터입니다. 또는 NULL 단추가 설정되지 않은 경우

CMFCRibbonBar::GetCaptionHeight

리본 표시줄에 대한 캡션 영역의 높이를 검색합니다.

int GetCaptionHeight() const;

Return Value

리본 표시줄에 대한 캡션 영역의 높이(픽셀)입니다.

설명

CMFCRibbonBar::GetCategory

지정된 인덱스에서 리본 범주에 대한 포인터를 검색합니다.

CMFCRibbonCategory* GetCategory(int nIndex) const;

매개 변수

nIndex
[in] 리본 메뉴 모음에 포함된 리본 범주 목록에 있는 리본 범주의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

지정된 인덱스에서 리본 범주에 대한 포인터입니다. 그렇지 않으면 NULLnIndex 범위를 벗어났습니다.

CMFCRibbonBar::GetCategoryCount

리본 표시줄에서 리본 범주 수를 검색합니다.

int GetCategoryCount() const;

Return Value

리본 표시줄에 있는 리본 범주의 수입니다.

CMFCRibbonBar::GetCategoryHeight

범주의 높이를 검색합니다.

int GetCategoryHeight() const;

Return Value

범주의 높이입니다.

설명

범주 높이에는 범주 탭의 높이가 포함됩니다.

CMFCRibbonBar::GetCategoryIndex

지정된 리본 범주의 인덱스를 검색합니다.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

매개 변수

pCategory
[in] 리본 범주에 대한 포인터입니다.

Return Value

로 지정된 pCategory리본 범주의 인덱스(0부터 시작하는 인덱스) 또는 리본 범주를 찾을 수 없는 경우 -1입니다.

CMFCRibbonBar::GetContextName

컨텍스트 ID로 지정된 캡션 컨텍스트 범주의 이름을 검색합니다.

BOOL GetContextName(
    UINT uiContextID,
    CString& strName) const;

매개 변수

uiContextID
[in] 리본 범주 컨텍스트 ID입니다.

strName
[out] 컨텍스트 범주의 이름이 캡션.

Return Value

TRUE메서드가 성공하면 이고, 그렇지 않으면 FALSEuiContextID 0이거나 컨텍스트 범주 캡션 찾을 수 없습니다.

CMFCRibbonBar::GetDroppedDown

현재 드롭다운된 리본 요소를 검색합니다.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Return Value

현재 드롭다운된 리본 요소입니다. 또는 NULL 현재 드롭다운된 리본 요소가 없는 경우

설명

CMFCRibbonBar::GetElementsByID

특정 명령 ID가 있는 모든 리본 요소에 대한 포인터 배열을 검색합니다.

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

매개 변수

uiCmdID
[in] 리본 요소의 명령 ID입니다.

arButtons
[out] 리본 요소에 대한 포인터 배열입니다.

설명

일부 리본 요소를 빠른 실행 도구 모음에 복사할 수 있으므로 여러 리본 요소의 명령 ID가 같을 수 있습니다.

CMFCRibbonBar::GetHideFlags

표시되는 리본 표시줄의 양을 나타내는 플래그를 검색합니다.

DWORD GetHideFlags() const;

Return Value

표시되는 리본 표시줄의 양을 나타내는 플래그입니다.

설명

다음 표에서는 반환 값에 사용할 수 있는 플래그 조합을 나열합니다.

플래그	설명
AFX_RIBBONBAR_HIDE_ELEMENTS	리본 표시줄은 세로로 최소화되며 범주 탭, 기본 단추 및 빠른 실행 도구 모음만 표시됩니다.
AFX_RIBBONBAR_HIDE_ALL	리본 표시줄의 너비가 최소 너비보다 작으며 완전히 숨겨집니다.

CMFCRibbonBar::GetItemIDsList

리본 표시줄에서 리본 요소의 지정된 컬렉션에 대한 명령 ID를 검색합니다.

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

매개 변수

lstItems
[out] 리본 표시줄에 포함된 리본 요소에 대한 명령 ID 목록입니다.

bHiddenOnly
[in] TRUE 표시되는 리본 요소를 제외하려면 이고, FALSE 리본 표시줄에 모든 리본 요소를 포함하려면

설명

CMFCRibbonBar::GetKeyboardNavigationLevel

사용자가 리본 표시줄에 포함된 키 설명을 누르면 현재 탐색 수준을 검색합니다.

int GetKeyboardNavigationLevel() const;

Return Value

사용자가 리본 표시줄에 포함된 키 설명을 누를 때의 현재 탐색 수준입니다. 다음 표에서는 가능한 반환 값을 나열합니다.

값	설명
-1	키 설명이 표시되지 않습니다.
0	키 설명이 표시됩니다.
1	사용자가 표시된 키 설명을 눌렀습니다.

설명

CMFCRibbonBar::GetKeyboardNavLevelCurrent

리본 표시줄에서 현재 키보드 탐색 개체를 검색합니다.

CObject* GetKeyboardNavLevelCurrent() const;

Return Value

리본 표시줄의 현재 키보드 탐색 개체입니다. 현재 키 설명을 표시하는 개체가 없으면 이고, 그렇지 않으면 NULL 입니다.

설명

현재 키 설명을 표시하는 개체는 현재 키보드 탐색 개체입니다.

CMFCRibbonBar::GetKeyboardNavLevelParent

리본 표시줄에서 부모 키보드 탐색 개체를 검색합니다.

CObject* GetKeyboardNavLevelParent() const;

Return Value

리본 표시줄의 부모 키보드 탐색 개체입니다. 그렇지 않으면 NULL.

설명

사용자가 리본 표시줄에서 키 설명을 누르면 현재 키보드 탐색 개체가 부모 키보드 탐색 개체가 됩니다.

CMFCRibbonBar::GetMainCategory

기본 리본 범주에 대한 포인터를 검색합니다.

CMFCRibbonCategory* GetMainCategory() const;

Return Value

기본 리본 범주에 대한 포인터입니다.

설명

기본 리본 범주에는 기본 리본 패널이 포함되어 있습니다.

CMFCRibbonBar::GetQATCommandsLocation

빠른 실행 도구 모음의 명령 섹션에 대한 표시 사각형을 검색합니다.

CRect GetQATCommandsLocation() const;

Return Value

빠른 실행 도구 모음의 명령 섹션에 대한 표시 사각형입니다.

설명

표시 사각형의 명령 섹션에는 사용자 지정 단추가 포함되지 않습니다.

CMFCRibbonBar::GetQATDroppedDown

팝업 메뉴가 드롭다운된 빠른 실행 도구 모음의 리본 요소에 대한 포인터를 검색합니다.

CMFCRibbonBaseElement* GetQATDroppedDown();

Return Value

팝업 메뉴가 드롭다운된 빠른 실행 도구 모음의 리본 요소에 대한 포인터입니다.

설명

CMFCRibbonBar::GetQuickAccessCommands

빠른 실행 도구 모음의 리본 요소에 대한 명령 ID 목록을 검색합니다.

void GetQuickAccessCommands(CList<UINT,UINT>& lstCommands);

매개 변수

lstCommands
[out] 빠른 실행 도구 모음의 리본 요소에 대한 명령 ID 목록입니다.

설명

목록에 컨트롤 구분 기호인 리본 요소가 포함되어 있지 않습니다.

CMFCRibbonBar::GetQuickAccessToolbarLocation

빠른 실행 도구 모음의 표시 사각형을 검색합니다.

CRect GetQuickAccessToolbarLocation() const;

Return Value

빠른 실행 도구 모음의 표시 사각형입니다.

설명

CMFCRibbonBar::GetTabTrancateRatio

범주 탭의 표시 너비에서 백분율 크기 감소를 검색합니다.

int GetTabTrancateRatio() const;

Return Value

범주 탭의 표시 너비에서 백분율 크기 감소입니다.

설명

리본 표시줄에 너비가 충분하지 않으면 범주 탭의 너비가 줄어듭니다.

CMFCRibbonBar::GetTooltipFixedWidthLargeImage

리본 표시줄의 큰 도구 설명 너비를 검색합니다.

int GetTooltipFixedWidthLargeImage() const;

Return Value

큰 크기의 도구 설명 너비(픽셀)입니다.

설명

도구 설명 너비의 큰 크기가 0이면 너비가 달라집니다.

CMFCRibbonBar::GetTooltipFixedWidthRegular

리본 표시줄에 대한 도구 설명 너비의 일반 크기를 검색합니다.

int GetTooltipFixedWidthRegular() const;

Return Value

도구 설명 너비의 일반 크기(픽셀)입니다.

설명

도구 설명 너비의 일반 크기가 0이면 너비가 달라집니다.

CMFCRibbonBar::GetVisibleCategoryCount

리본 표시줄에 표시되는 범주의 수를 검색합니다.

int GetVisibleCategoryCount() const;

Return Value

리본 표시줄에 표시되는 범주의 수입니다.

설명

CMFCRibbonBar::HideAllContextCategories

리본 표시줄의 모든 컨텍스트 범주를 숨깁니다.

BOOL HideAllContextCategories();

Return Value

TRUE하나 이상의 컨텍스트 범주가 숨겨져 있으면 이고, 그렇지 않으면 . FALSE

설명

컨텍스트 범주가 활성 상태이면 활성 범주가 범주 목록의 첫 번째 표시 범주로 다시 설정됩니다.

CMFCRibbonBar::HideKeyTips

리본 표시줄의 모든 키 설명을 숨깁니다.

void HideKeyTips();

설명

CMFCRibbonBar::HitTest

지점의 위치에 지정된 리본 요소에 대한 포인터를 검색합니다.

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

매개 변수

point
[in] 리본 표시줄 좌표에 있는 점의 위치입니다.

bCheckActiveCategory
[in] TRUE 활성 범주를 검색하려면 입니다. FALSE 활성 범주를 검색하지 않습니다.

bCheckPanelCaption
[in] TRUE 리본 패널에 있는 FALSE 점을 사용하여 리본 패널의 캡션 테스트하려면 리본 패널의 캡션 테스트하지 않습니다. 자세한 내용은 설명 부분을 참조하세요.

Return Value

지정된 지점에 있는 리본 요소에 대한 포인터입니다. 그렇지 않으면 NULL 점이 리본 요소에 없는 경우입니다.

설명

매개 변수TRUE가 아닌 경우 bCheckActiveCategory 리본 패널에 있는 지점이 있는 리본 패널의 캡션 테스트되지 않습니다.

CMFCRibbonBar::IsKeyTipEnabled

키 설명 기능을 사용할 수 있는지 여부를 나타냅니다.

BOOL IsKeyTipEnabled() const;

Return Value

TRUE 키 설명 기능을 사용하도록 설정하면 FALSE.

CMFCRibbonBar::IsMainRibbonBar

리본 표시줄이 기본 리본 표시줄인지 여부를 나타냅니다.

virtual BOOL IsMainRibbonBar() const;

Return Value

항상 TRUE를 반환합니다.

설명

기본적으로 이 메서드는 항상 .TRUE 리본 표시줄이 기본 리본 표시줄인지 여부를 나타내려면 이 메서드를 재정의합니다.

CMFCRibbonBar::IsPrintPreviewEnabled

인쇄 미리 보기 기능을 사용할 수 있는지 여부를 나타냅니다.

BOOL IsPrintPreviewEnabled() const;

Return Value

TRUE인쇄 미리 보기 기능을 사용하도록 설정하면 /&A이고, 그렇지 않으면 FALSE.입니다.

CMFCRibbonBar::IsQATEmpty

빠른 실행 도구 모음에 명령 단추가 포함되어 있는지 여부를 나타냅니다.

BOOL IsQATEmpty() const;

Return Value

TRUE 빠른 실행 도구 모음에 명령 단추가 포함되어 있으면 이고, 그렇지 않으면 FALSE.

설명

CMFCRibbonBar::IsQuickAccessToolbarOnTop

빠른 실행 도구 모음이 리본 표시줄 위에 있는지 또는 아래에 있는지 여부를 나타냅니다.

BOOL IsQuickAccessToolbarOnTop() const;

Return Value

TRUE 빠른 실행 도구 모음이 리본 표시줄 위에 있으면 이고, FALSE 빠른 실행 도구 모음이 리본 표시줄 아래에 있으면 입니다.

CMFCRibbonBar::IsReplaceFrameCaption

리본 표시줄이 기본 프레임 창의 캡션 바꿉니다.

BOOL IsReplaceFrameCaption() const;

Return Value

TRUE리본 표시줄이 기본 프레임 창의 캡션 바꾸면 이고, FALSE 리본 표시줄이 기본 프레임 창의 캡션 아래에 있으면 입니다.

CMFCRibbonBar::IsShowGroupBorder

리본 표시줄에 있는 단추 그룹에 그룹 테두리가 표시되는지 여부를 나타냅니다.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

매개 변수

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

Return Value

항상 FALSE를 반환합니다.

설명

기본적으로 이 메서드는 항상 .FALSE 리본 표시줄에 있는 단추 그룹에 그룹 테두리가 표시되는지 여부를 나타내려면 이 메서드를 재정의합니다.

CMFCRibbonBar::IsToolTipDescrEnabled

도구 설명 설명을 사용할 수 있는지 여부를 나타냅니다.

BOOL IsToolTipDescrEnabled() const;

Return Value

TRUE 도구 설명 설명을 사용하도록 설정하면 FALSE 도구 설명 설명을 사용할 수 없으면

설명

도구 설명 설명은 도구 설명 텍스트와 함께 표시되는 추가 설명 텍스트입니다.

CMFCRibbonBar::IsToolTipEnabled

리본 표시줄에 대해 도구 설명이 사용하도록 설정되었는지 여부를 나타냅니다.

BOOL IsToolTipEnabled() const;

Return Value

TRUE 도구 설명이 사용되면 FALSE 도구 설명을 사용할 수 없으면 입니다.

CMFCRibbonBar::IsTransparentCaption

디스플레이가 Windows Aero 색 구성표에 대해 설정되었는지 여부를 나타냅니다.

BOOL IsTransparentCaption() const;

Return Value

TRUE 색 구성표가 Windows Aero인 경우 그렇지 않으면 FALSE.

설명

CMFCRibbonBar::OnClickButton

이 메서드는 기존 애플리케이션과의 이전 버전과의 호환성을 위해 유지되며 새 개발에 사용하면 안 됩니다.

virtual void OnClickButton(
    CMFCRibbonButton* pButton,
    CPoint point);

매개 변수

pButton
[in] 클릭한 단추에 대한 포인터입니다.

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

설명

CMFCRibbonBar::OnEditContextMenu

virtual void OnEditContextMenu(
    CMFCRibbonRichEditCtrl* pEdit,
    CPoint point);

매개 변수

[in] pEdit
[in] point\

설명

CMFCRibbonBar::OnRTLChanged

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

virtual void OnRTLChanged(BOOL bIsRTL);

매개 변수

bIsRTL
[in] TRUE 레이아웃이 오른쪽에서 왼쪽이면 FALSE 레이아웃이 왼쪽에서 오른쪽이면

설명

이 메서드는 새 레이아웃 방향에 대 한 리본 표시줄에 있는 모든 컨트롤의 레이아웃을 조정 합니다.

CMFCRibbonBar::OnSetAccData

이 메서드는 프레임워크 내부이며 사용자 코드에서 호출할 수 없습니다.

BOOL OnSetAccData(long lVal);

매개 변수

long lVal 액세스 가능한 개체의 인덱스입니다.

Return Value

S_OK 성공하면 FALSE . S_FALSE입니다.

설명

CMFCRibbonBar::OnShowRibbonContextMenu

virtual BOOL OnShowRibbonContextMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

매개 변수

[in] pWnd
[in] x
[in] y
[in] pHit\

Return Value

설명

CMFCRibbonBar::OnShowRibbonQATMenu

virtual BOOL OnShowRibbonQATMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

매개 변수

[in] pWnd
[in] x
[in] y
[in] pHit\

Return Value

설명

CMFCRibbonBar::OnSysKeyDown

사용자가 F10 키를 누르거나 ALT 키를 누른 다음 다른 키를 누를 때 프레임워크에서 호출됩니다.

BOOL OnSysKeyDown(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

매개 변수

pFrameWnd
[in] 리본 표시줄의 부모 기본 프레임 창에 대한 포인터입니다.

wParam
[in] 누를 키의 가상 키 코드입니다.

lParam
[in] 키를 누를 때 키보드 상태 플래그입니다.

Return Value

TRUE 키 입력 이벤트가 처리되었으면 이고, 그렇지 않으면 FALSE.

설명

CMFCRibbonBar::OnSysKeyUp

사용자가 F10 키, ALT 키 또는 ALT 키를 누를 때 누른 키를 해제할 때 프레임워크에서 호출됩니다.

BOOL OnSysKeyUp(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

매개 변수

pFrameWnd
[in] 리본 표시줄의 부모 기본 프레임 창에 대한 포인터입니다.

wParam
[in] 릴리스되는 키의 가상 키 코드입니다.

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

Return Value

TRUE 키 입력 이벤트가 처리되었으면 이고, 그렇지 않으면 FALSE.

설명

CMFCRibbonBar::PopTooltip

보기에서 도구 설명을 제거합니다.

void PopTooltip();

설명

CMFCRibbonBar::PreTranslateMessage

지정한 메시지가 리본 표시줄에서 처리되는지 여부를 확인합니다.

virtual BOOL PreTranslateMessage(MSG* pMsg);

매개 변수

pMsg
[in] 메시지에 대한 포인터입니다.

Return Value

TRUE 리본 표시줄에 의해 메시지가 처리되었으면 이고, 그렇지 않으면 FALSE.

설명

CMFCRibbonBar::RecalcLayout

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

virtual void RecalcLayout();

설명

레이아웃 조정 후 리본 표시줄의 표시가 업데이트됩니다.

CMFCRibbonBar::RemoveAllCategories

리본 표시줄에서 모든 리본 범주를 삭제합니다.

void RemoveAllCategories();

설명

이 메서드는 메모리 및 범주 목록에서 모든 리본 범주를 삭제합니다.

CMFCRibbonBar::RemoveAllFromTabs

탭 영역에서 모든 리본 요소를 제거합니다.

void RemoveAllFromTabs();

설명

메서드를 사용하여 탭 영역에 추가한 모든 요소를 제거하려면 이 함수를 사용합니다 CMFCRibbonBar::AddToTabs .

CMFCRibbonBar::RemoveCategory

리본 표시줄에서 지정된 리본 범주를 삭제합니다.

BOOL RemoveCategory(int nIndex);

매개 변수

nIndex
[in] 리본 메뉴 모음에 포함된 리본 범주 목록에 있는 범주의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

TRUE 지정한 리본 범주가 삭제되었으면 이고, 그렇지 않으면 FALSE.

설명

지정된 리본 범주는 메모리 및 범주 목록에서 삭제됩니다.

CMFCRibbonBar::SetActiveCategory

지정된 리본 범주를 활성 범주로 설정합니다.

BOOL SetActiveCategory(
    CMFCRibbonCategory* pCategory,
    BOOL bForceRestore= FALSE);

매개 변수

pCategory
[in] 리본 표시줄에 포함된 리본 범주입니다.

bForceRestore
[in] TRUE 최소화된 경우 리본 표시줄을 최대화하려면 입니다. FALSE 리본 표시줄이 최소화된 경우 팝업 창에 활성 범주를 표시합니다.

Return Value

TRUE 지정된 범주가 활성 범주로 설정되었으면 이고, 그렇지 않으면 FALSE.

설명

기본 리본 범주는 활성 범주일 수 없습니다.

지정된 pCategory 범주가 표시되지 않으면 활성 범주로 설정할 수 없습니다.

CMFCRibbonBar::SetActiveMDIChild

MDI(다중 문서 인터페이스) 자식 창에 속하는 리본 표시줄의 시스템 단추를 지정된 MDI 자식 창에 연결합니다.

void SetActiveMDIChild(CWnd* pWnd);

매개 변수

pWnd
[in] MDI 자식 창에 대한 포인터입니다.

설명

CMFCRibbonBar::SetApplicationButton

리본 표시줄에 애플리케이션 리본 단추를 할당합니다.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

매개 변수

pButton
[in] 애플리케이션 리본 단추에 대한 포인터입니다.

sizeButton
[in] 애플리케이션 리본 단추의 크기입니다.

설명

애플리케이션 리본 단추는 리본 컨트롤의 왼쪽 위 모서리에 있는 큰 둥근 단추입니다.

예시

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

// Init main button:
// CMFCRibbonApplicationButton m_MainButton
m_MainButton.SetImage(IDB_MAIN);
m_MainButton.SetText(_T("\nf"));
m_MainButton.SetToolTipText(strTemp);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetApplicationButton(&m_MainButton, CSize(45, 45));

CMFCRibbonBar::SetElementKeys

지정된 명령 ID를 가진 모든 리본 요소의 키 설명을 설정합니다.

BOOL SetElementKeys(
    UINT uiCmdID,
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys= NULL);

매개 변수

uiCmdID
[in] 리본 요소의 명령 ID입니다.

lpszKeys
[in] 키 설명입니다.

lpszMenuKeys
[in] 메뉴 키 설명입니다.

Return Value

TRUE 하나 이상의 리본 요소의 키 설명을 설정하면 이고, 그렇지 않으면 FALSE.

설명

선택적 메뉴 키 설명은 팝업 메뉴를 여는 분할 단추가 있는 리본 요소에 대한 것입니다.

CMFCRibbonBar::SetKeyboardNavigationLevel

사용자가 리본 표시줄에 포함된 키 설명을 누르면 키보드 탐색 수준을 설정합니다.

void SetKeyboardNavigationLevel(
    CObject* pLevel,
    BOOL bSetFocus = TRUE);

매개 변수

pLevel
[in] 현재 키보드 탐색 개체에 대한 포인터입니다.

bSetFocus
[in] TRUE 키보드 포커스를 리본 표시줄로 설정합니다.

설명

리본 메뉴 모음의 키보드 탐색은 사용자가 ALT 또는 F10 키를 누르면 시작됩니다. 사용자는 리본 표시줄에서 키 설명을 눌러 다음 탐색 수준을 선택합니다. 사용자는 이스케이프 키를 눌러 이전 탐색 수준으로 돌아갈 수 있습니다.

CMFCRibbonBar::SetMaximizeMode

MDI(다중 문서 인터페이스) 자식 창의 창 크기가 최대화된 상태로 들어가거나 나가면 리본 표시줄을 조정합니다.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL);

매개 변수

bMax
[in] TRUE 리본 표시줄에 MDI 자식 창에 대한 시스템 단추를 표시하려면 입니다. FALSE 리본 표시줄에서 MDI 자식 창에 대한 시스템 단추를 제거합니다.

pWnd
[in] 리본 메뉴 모음의 기본 프레임 창에 대한 포인터입니다.

설명

리본 표시줄은 MDI 자식 창이 최대화될 때 탭 행에 MDI 자식 창에 대한 시스템 단추를 표시합니다.

CMFCRibbonBar::SetQuickAccessCommands

빠른 실행 도구 모음에 하나 이상의 리본 요소를 추가합니다.

void SetQuickAccessCommands(
    const CList<UINT,UINT>& lstCommands,
    BOOL bRecalcLayout=TRUE);

매개 변수

lstCommands
[in] 빠른 실행 도구 모음에 배치할 명령 목록입니다.

bRecalcLayout
[in] TRUE 리본 요소를 추가한 후 리본 메뉴를 다시 그리려면 이고, FALSE 그렇지 않으면.

예시

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

// Add quick access commands to the toolbar
CList<UINT, UINT> lstQATCmds;

lstQATCmds.AddTail(ID_FILE_NEW);
lstQATCmds.AddTail(ID_FILE_OPEN);
lstQATCmds.AddTail(ID_FILE_SAVE);
lstQATCmds.AddTail(ID_FILE_PRINT_DIRECT);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessCommands(lstQATCmds);

CMFCRibbonBar::SetQuickAccessDefaultState

빠른 실행 도구 모음을 기본 상태로 설정합니다.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

매개 변수

state
[in] 빠른 실행 도구 모음 기본 상태입니다.

설명

빠른 실행 도구 모음 상태에는 명령 목록과 표시 유형이 포함됩니다.

예시

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

CMFCRibbonQuickAccessToolBarDefaultState *qaToolBarState =
    new CMFCRibbonQuickAccessToolBarDefaultState();
qaToolBarState->AddCommand(ID_FILE_NEW, true);
qaToolBarState->AddCommand(ID_FILE_OPEN, true);
// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessDefaultState(*qaToolBarState);

CMFCRibbonBar::SetQuickAccessToolbarOnTop

빠른 실행 도구 모음을 리본 표시줄 위 또는 아래에 배치합니다.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

매개 변수

bOnTop
[in] TRUE 빠른 실행 도구 모음을 리본 표시줄 위에 배치하려면 입니다. FALSE 빠른 실행 도구 모음을 리본 표시줄 아래에 배치합니다.

CMFCRibbonBar::SetTooltipFixedWidth

리본 표시줄에 대한 도구 설명 고정 너비의 일반 및 큰 크기를 설정합니다.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

매개 변수

nWidthRegular
[in] 일반 고정 크기 도구 설명의 너비(픽셀)입니다.

nWidthLargeImage
[in] 큰 고정 크기 도구 설명의 너비(픽셀)입니다.

설명

매개 변수를 0으로 설정하면 해당 너비가 달라집니다.

CMFCRibbonBar::ShowCategory

지정된 리본 범주를 표시하거나 숨깁니다.

void ShowCategory(
    int nIndex,
    BOOL bShow=TRUE);

매개 변수

nIndex
[in] 리본 범주의 인덱스입니다.

bShow
[in] 리본 범주를 표시하면 TRUE리본 범주를 표시하고, 그렇지 않으면 리본 범주를 숨깁니다.

CMFCRibbonBar::ShowContextCategories

지정된 ID를 가진 컨텍스트 범주를 표시하거나 숨깁니다.

void ShowContextCategories(
    UINT uiContextID,
    BOOL bShow=TRUE);

매개 변수

uiContextID
[in] 컨텍스트 범주 ID입니다.

bShow
[in] 지정된 ID가 있는 범주를 표시하면 TRUE지정한 ID가 있는 범주를 숨깁니다.

CMFCRibbonBar::ShowKeyTips

리본 표시줄의 각 리본 요소에 대한 키 설명을 표시합니다.

void ShowKeyTips();

설명

CMFCRibbonBar::ToggleMimimizeState

리본 표시줄을 최소화 상태 또는 최대화 상태로 표시합니다.

void ToggleMimimizeState();

설명

메서드 이름의 맞춤법 오류는 알려진 문제입니다.

최소화된 상태에서는 리본 컨트롤이 사라지고 탭만 표시됩니다. 탭을 클릭하면 리본 컨트롤이 팝업 창으로 표시됩니다. 사용자가 클릭하거나 명령을 실행하면 창이 닫힙니다.

CMFCRibbonBar::TranslateChar

지정한 키 입력 문자 코드가 리본 표시줄에서 처리되는지 여부를 결정합니다.

virtual BOOL TranslateChar(UINT nChar);

매개 변수

nChar
[in] 사용자 키 입력 문자 코드입니다.

Return Value

TRUE 문자 코드가 리본 표시줄에서 처리되었으면 이고, 그렇지 않으면 FALSE.

설명

키 설명 기능을 사용하면 사용자가 키보드를 사용하여 리본 표시줄을 탐색할 수 있습니다.

CMFCRibbonBar::GetFocused

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

virtual CMFCRibbonBaseElement* GetFocused();

Return Value

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

설명

CMFCRibbonBar::IsWindows7Look

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

BOOL IsWindows7Look() const;

Return Value

TRUE 리본 메뉴에 Windows 7 모양이 있으면 이고, 그렇지 않으면 FALSE.

설명

CMFCRibbonBar::LoadFromResource

오버로드됨. 애플리케이션 리소스에서 리본 표시줄을 로드합니다.

virtual BOOL LoadFromResource(
    UINT uiXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

virtual BOOL LoadFromResource(
    LPCTSTR lpszXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

매개 변수

uiXMLResID
리본 표시줄 정보를 사용하여 XML 문자열의 리소스 ID를 지정합니다.

lpszResType
에 uiXMLResID있는 리소스의 형식을 지정합니다.

hInstance
실행 파일에 리소스가 포함된 모듈에 대한 핸들입니다. 이 NULL경우 hInstance 시스템은 현재 프로세스를 만드는 데 사용된 모듈에서 리소스를 로드합니다.

lpszXMLResID
리본 표시줄 정보를 사용하여 리소스 ID(문자열 형식)를 지정합니다.

Return Value

TRUE 로드가 성공하면 이고, 그렇지 않으면 FALSE.

설명

CMFCRibbonBar::SaveToXMLBuffer

리본 표시줄을 버퍼에 저장합니다.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

매개 변수

ppBuffer
이 함수가 반환 ppBuffer 될 때 이 메서드에서 할당한 버퍼를 가리키고 XML 형식의 리본 표시줄 정보를 포함합니다.

Return Value

성공하면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonBar::SaveToXMLFile

리본 표시줄을 XML 파일에 저장합니다.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

매개 변수

lpszFilePath
출력 파일을 지정합니다.

Return Value

성공하면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonBar::SetWindows7Look

리본 메뉴에 Windows 7 모양(작은 사각형 응용 프로그램 단추)을 사용하거나 사용하지 않도록 설정합니다.

void SetWindows7Look(
    BOOL bWindows7Look,
    BOOL bRecalc = TRUE);

매개 변수

bWindows7Look
TRUE Windows 7 모양을 설정합니다. FALSE 그렇지 않으면.

bRecalc
TRUE 리본 레이아웃을 다시 계산합니다. FALSE 그렇지 않으면.

설명

참고 항목

계층 구조 차트
클래스
CPane 클래스
CMFCRibbonCategory 클래스
CMFCRibbonPanel 클래스
CMFCRibbonBaseElement 클래스
연습: MFC 낙서 애플리케이션 업데이트