CMFCRibbonStatusBar 클래스
클래스는 CMFCRibbonStatusBar 리본 요소를 표시할 수 있는 상태 표시줄 컨트롤을 구현합니다.
구문
class CMFCRibbonStatusBar : public CMFCRibbonBar
멤버
공용 메서드
보호된 메서드
| 속성 | 설명 |
|---|---|
| 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);
상속 계층 구조
요구 사항
헤더: afxribbonstatusbar.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 클래스