CMFCRibbonStatusBar 클래스

이 클래스는 CMFCRibbonStatusBar 리본 요소를 표시할 수 있는 상태 막대 컨트롤을 구현합니다.

구문

class CMFCRibbonStatusBar : public CMFCRibbonBar

멤버

공용 메서드

이름	설명
CMFCRibbonStatusBar::AddDynamicElement	리본 상태 막대에 동적 요소를 추가합니다.
CMFCRibbonStatusBar::AddElement	리본 상태 막대에 새 리본 요소를 추가합니다.
CMFCRibbonStatusBar::AddExtendedElement	리본 메뉴 상태 막대의 확장 영역에 리본 요소를 추가합니다.
CMFCRibbonStatusBar::AddSeparator	리본 상태 막대에 구분 기호를 추가합니다.
CMFCRibbonStatusBar::Create	리본 상태 막대를 만듭니다.
CMFCRibbonStatusBar::CreateEx	확장 스타일을 사용하여 리본 상태 막대를 만듭니다.
CMFCRibbonStatusBar::FindByID
CMFCRibbonStatusBar::FindElement	지정된 명령 ID가 있는 요소에 대한 포인터를 반환합니다.
CMFCRibbonStatusBar::GetCount	리본 상태 막대의 기본 영역에 있는 요소 수를 반환합니다.
CMFCRibbonStatusBar::GetElement	지정된 인덱스 위치에 있는 요소에 대한 포인터를 반환합니다.
CMFCRibbonStatusBar::GetExCount	리본 상태 막대의 확장 영역에 있는 요소의 수를 반환합니다.
CMFCRibbonStatusBar::GetExElement	리본 메뉴 상태 표시줄에서 확장된 영역의 지정한 인덱스에 있는 요소에 대한 포인터를 반환합니다.
CMFCRibbonStatusBar::GetExtendedArea
CMFCRibbonStatusBar::GetSpace
CMFCRibbonStatusBar::IsBottomFrame
CMFCRibbonStatusBar::IsExtendedElement
CMFCRibbonStatusBar::IsInformationMode	리본 상태 표시줄에 정보 모드를 사용할 수 있는지 여부를 결정합니다.
CMFCRibbonStatusBar::RecalcLayout	(재정의 CMFCRibbonBar::RecalcLayout.)
CMFCRibbonStatusBar::RemoveAll	리본 상태 막대에서 모든 요소를 제거합니다.
CMFCRibbonStatusBar::RemoveElement	리본 상태 표시줄에서 지정된 명령 ID가 있는 요소를 제거합니다.
CMFCRibbonStatusBar::SetInformation	리본 상태 표시줄에 대한 정보 모드를 사용하거나 사용하지 않도록 설정합니다.

보호된 메서드

속성	설명
CMFCRibbonStatusBar::OnDrawInformation	정보 모드를 사용할 때 리본 상태 표시줄에 표시되는 정보 문자열을 표시합니다.

설명

사용자는 리본 메뉴 상태 표시줄의 기본 제공 상황에 맞는 메뉴를 사용하여 리본 상태 막대에서 리본 요소의 표시 유형을 변경할 수 있습니다. 요소를 동적으로 추가하거나 제거할 수 있습니다.

리본 상태 막대에는 기본 영역과 확장 영역의 두 가지 영역이 있습니다. 확장 영역은 리본 상태 표시줄의 오른쪽에 표시되며 기본 영역과 다른 색으로 표시됩니다.

일반적으로 상태 막대의 기본 영역에는 상태 알림이 표시되고 확장 영역에는 보기 컨트롤이 표시됩니다. 확장 영역은 사용자가 리본 상태 표시줄의 크기를 조정할 때 가능한 한 기본 표시됩니다.

예시

다음 예제에서는 CMFCRibbonStatusBar 클래스에서 다양한 메서드를 사용하는 방법을 보여 줍니다. 이 예제에서는 리본 상태 막대에 새 리본 요소를 추가하고, 리본 상태 막대의 확장 영역에 리본 요소를 추가하고, 구분 기호를 추가하고, 리본 상태 막대에 대한 일반 모드를 사용하도록 설정하는 방법을 보여 줍니다.

// CMFCRibbonStatusBar  m_wndStatusBar
m_wndStatusBar.AddElement(rsbp, strTitlePane1);
m_wndStatusBar.AddExtendedElement(new CMFCRibbonStatusBarPane(ID_STATUSBAR_PANE2, strTitlePane2, TRUE),
                                  strTitlePane2);

m_wndStatusBar.AddSeparator();
m_wndStatusBar.SetInformation(NULL);

상속 계층 구조

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCRibbonBar

CMFCRibbonStatusBar

요구 사항

헤더: afxribbon상태bar.h

CMFCRibbonStatusBar::AddDynamicElement

리본 상태 막대에 동적 요소를 추가합니다.

void AddDynamicElement(CMFCRibbonBaseElement* pElement);

매개 변수

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

설명

일반 요소와 달리 동적 요소는 사용자 지정할 수 없으며 상태 표시줄의 사용자 지정 메뉴가 표시되지 않습니다.

CMFCRibbonStatusBar::AddElement

리본 상태 막대에 새 리본 요소를 추가합니다.

void AddElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

매개 변수

pElement
[in] 추가된 요소에 대한 포인터입니다.

lpszLabel
[in] 요소의 텍스트 레이블입니다.

bIsVisible
[in] 요소를 표시로 추가하려면 TRUE, 요소를 숨김으로 추가하려면 FALSE입니다.

CMFCRibbonStatusBar::AddExtendedElement

리본 메뉴 상태 막대의 확장 영역에 리본 요소를 추가합니다.

void AddExtendedElement(
    CMFCRibbonBaseElement* pElement,
    LPCTSTR lpszLabel,
    BOOL bIsVisible=TRUE);

매개 변수

pElement
[in] 추가된 요소에 대한 포인터입니다.

lpszLabel
[in] 요소의 텍스트 레이블입니다.

bIsVisible
[in] 요소를 표시로 추가하려면 TRUE, 요소를 숨김으로 추가하려면 FALSE입니다.

설명

확장된 영역은 상태 표시줄 컨트롤의 오른쪽에 있습니다.

CMFCRibbonStatusBar::AddSeparator

리본 상태 막대에 구분 기호를 추가합니다.

void AddSeparator();

설명

프레임워크는 CMFCRibbonStatusBar::AddElement 메서드 뒤의 구분 기호를 추가합니다. 는 마지막 요소를 삽입합니다.

CMFCRibbonStatusBar::Create

리본 상태 막대를 만듭니다.

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

매개 변수

pParentWnd
[in] 부모 창에 대한 포인터입니다.

dwStyle
[in] 컨트롤 스타일의 논리적 OR 조합입니다.

nID
[in] 상태 막대의 컨트롤 ID입니다.

Return Value

상태 막대가 성공적으로 만들어지면 TRUE이고, 그렇지 않으면 FALSE입니다.

CMFCRibbonStatusBar::CreateEx

확장 스타일이 있는 리본 상태 막대를 만듭니다.

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

매개 변수

pParentWnd
부모 창에 대한 포인터입니다.

dwCtrlStyle
상태 막대 개체를 만들기 위한 추가 스타일의 논리적 OR 조합입니다.

dwStyle
상태 막대의 컨트롤 스타일입니다.

nID
상태 막대의 컨트롤 ID입니다.

Return Value

상태 막대가 성공적으로 만들어지면 TRUE이고, 그렇지 않으면 FALSE입니다.

CMFCRibbonStatusBar::FindByID

자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

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

매개 변수

[in] uiCmdID
[in] Bool

Return Value

설명

CMFCRibbonStatusBar::FindElement

지정된 명령 ID가 있는 요소에 대한 포인터를 반환합니다.

CMFCRibbonBaseElement* FindElement(UINT uiID);

매개 변수

uiID
[in] 요소의 ID입니다.

Return Value

지정된 명령 ID가 있는 요소에 대한 포인터입니다. 이러한 요소가 없으면 NULL입니다.

CMFCRibbonStatusBar::GetCount

리본 상태 막대의 기본 영역에 있는 요소 수를 반환합니다.

int GetCount() const;

Return Value

리본 상태 표시줄의 기본 영역에 있는 요소의 수입니다.

CMFCRibbonStatusBar::GetElement

지정된 인덱스 위치에 있는 요소에 대한 포인터를 반환합니다.

CMFCRibbonBaseElement* GetElement(int nIndex);

매개 변수

nIndex
[in] 상태 막대 컨트롤의 기본 영역에 있는 요소의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

Return Value

지정된 인덱스 위치에 있는 요소에 대한 포인터입니다. 인덱스가 음수이거나 상태 막대의 요소 수를 초과하는 경우 NULL입니다.

설명

CMFCRibbonStatusBar::GetExCount

리본 상태 막대의 확장 영역에 있는 요소의 수를 반환합니다.

int GetExCount() const;

Return Value

리본 상태 막대의 확장 영역에 있는 요소의 수입니다.

CMFCRibbonStatusBar::GetExElement

리본 메뉴 상태 표시줄에서 확장된 영역의 지정한 인덱스에 있는 요소에 대한 포인터를 반환합니다. 확장된 영역은 상태 표시줄 컨트롤의 오른쪽에 있습니다.

CMFCRibbonBaseElement* GetExElement(int nIndex);

매개 변수

nIndex
[in] 상태 막대 컨트롤의 확장 영역에 있는 요소의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

Return Value

리본 메뉴 상태 표시줄에서 확장된 영역의 지정한 인덱스에 있는 요소에 대한 포인터입니다. nIndex가 음수이거나 리본 상태 막대의 확장 영역에 있는 요소 수를 초과하는 경우 NULL입니다.

설명

CMFCRibbonStatusBar::GetExtendedArea

자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

virtual BOOL GetExtendedArea(CRect& rect) const;

매개 변수

[in] rect

Return Value

설명

CMFCRibbonStatusBar::GetSpace

자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

int GetSpace() const;

Return Value

설명

CMFCRibbonStatusBar::IsBottomFrame

자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

BOOL IsBottomFrame() const;

Return Value

설명

CMFCRibbonStatusBar::IsExtendedElement

자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;

매개 변수

[in] pElement

Return Value

설명

CMFCRibbonStatusBar::IsInformationMode

리본 상태 표시줄에 정보 모드를 사용할 수 있는지 여부를 결정합니다.

BOOL IsInformationMode() const;

Return Value

상태 표시줄이 정보 모드에서 작동할 수 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

정보 모드에서 상태 막대는 모든 일반 창을 숨기고 메시지 문자열을 표시합니다.

CMFCRibbonStatusBar::OnDrawInformation

정보 모드를 사용할 때 리본 상태 표시줄에 표시되는 문자열을 표시합니다.

virtual void OnDrawInformation(
    CDC* pDC,
    CString& strInfo,
    CRect rectInfo);

매개 변수

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

strInfo
[in] 정보 문자열입니다.

rectInfo
[in] 경계 사각형입니다.

설명

상태 막대에서 정보 문자열의 모양을 사용자 지정하려는 경우 파생 클래스에서 이 메서드를 재정의합니다. CMFCRibbonStatusBar::SetInformation 메서드를 사용하여 상태 막대를 정보 모드로 전환합니다. 이 모드에서 상태 막대는 모든 창을 숨기고 strInfo에서 지정한 정보 문자열을 표시합니다.

CMFCRibbonStatusBar::RecalcLayout

자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

virtual void RecalcLayout();

설명

CMFCRibbonStatusBar::RemoveAll

리본 상태 막대에서 모든 요소를 제거합니다.

void RemoveAll();

CMFCRibbonStatusBar::RemoveElement

리본 상태 표시줄에서 지정된 명령 ID가 있는 요소를 제거합니다.

BOOL RemoveElement(UINT uiID);

매개 변수

uiID
[in] 상태 표시줄에서 제거할 요소의 ID입니다.

Return Value

지정된 uiID 가 있는 요소가 제거되면 TRUE입니다. 그렇지 않으면 FALSE입니다.

CMFCRibbonStatusBar::SetInformation

리본 상태 표시줄에 대한 정보 모드를 사용하거나 사용하지 않도록 설정합니다.

void SetInformation(LPCTSTR lpszInfo);

매개 변수

lpszInfo
[in] 정보 문자열입니다.

설명

이 메서드를 사용하여 상태 표시줄을 정보 모드로 전환합니다. 이 모드에서 상태 막대는 모든 창을 숨기고 lpszInfo로 지정된 정보 문자열을 표시합니다.

lpszInfo가 NULL이면 상태 막대가 일반 모드로 되돌리기.

참고 항목

계층 구조 차트
클래스
CMFCRibbonBar 클래스
CMFCRibbonBaseElement 클래스
CMFCRibbonBar 클래스