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]狀態列的控件標識碼。
傳回值
如果成功建立狀態列，則為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
狀態列的控件標識碼。
傳回值
如果成功建立狀態列，則為TRUE，否則為 FALSE。
CMFCRibbonStatusBar：：FindByID
如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。
CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);
參數
[in] uiCmdID
[in] BOOL
傳回值
備註
CMFCRibbonStatusBar：：FindElement
傳回具有指定命令標識碼之專案的指標。
CMFCRibbonBaseElement* FindElement(UINT uiID);
參數
uiID
[in]項目的標識碼。
傳回值
具有指定命令標識碼之專案的指標。 如果沒有這類專案，則為 NULL。
CMFCRibbonStatusBar：：GetCount
傳回位於功能區狀態列主要區域中的項目數目。
int GetCount() const;
傳回值
位於功能區狀態列主要區域的項目數目。
CMFCRibbonStatusBar：：GetElement
傳回位於指定索引處之專案的指標。
CMFCRibbonBaseElement* GetElement(int nIndex);
參數
nIndex
[in]指定位於狀態列控制項主要區域的元素以零起始的索引。
傳回值
位於指定索引處之專案的指標。 如果索引為負數或超過狀態列中的項目數，則為NULL。
備註
CMFCRibbonStatusBar：：GetExCount
傳回位於功能區狀態列延伸區域中的項目數目。
int GetExCount() const;
傳回值
位於功能區狀態列延伸區域中的項目數目。
CMFCRibbonStatusBar：：GetExElement
傳回指標，該指標指向功能區狀態列擴充區域中，位於指定索引上的元素。 擴充區域位於狀態列控制項右邊。
CMFCRibbonBaseElement* GetExElement(int nIndex);
參數
nIndex
[in]指定位於狀態列控件延伸區域中的專案以零起始的索引。
傳回值
此指標指向功能區狀態列擴充區域中，位於指定索引上的元素。 如果 nIndex 是負數，或超過功能區狀態列延伸區域中的項目數目，則為 NULL。
備註
CMFCRibbonStatusBar：：GetExtendedArea
如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。
virtual BOOL GetExtendedArea(CRect& rect) const;
參數
[in] rect
傳回值
備註
CMFCRibbonStatusBar：：GetSpace
如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。
int GetSpace() const;
傳回值
備註
CMFCRibbonStatusBar：：IsBottomFrame
如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。
BOOL IsBottomFrame() const;
傳回值
備註
CMFCRibbonStatusBar：：IsExtendedElement
如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。
BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;
參數
[in] pElement
傳回值
備註
CMFCRibbonStatusBar：：IsInformationMode
判斷功能區狀態列是否啟用資訊模式。
BOOL IsInformationMode() const;
傳回值
如果狀態列可以在資訊模式中運作，則為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
從功能區狀態列移除具有指定命令標識碼的專案。
BOOL RemoveElement(UINT uiID);
參數
uiID
[in]要從狀態列移除之專案的標識碼。
傳回值
如果移除具有指定 uiID 的專案，則為 TRUE。 否則為 FALSE。
CMFCRibbonStatusBar：：SetInformation
啟用或停用功能區狀態列的資訊模式。
void SetInformation(LPCTSTR lpszInfo);
參數
lpszInfo
[in]資訊字串。
備註
使用此方法可將狀態列置於資訊模式中。 在此模式中，狀態列會隱藏所有窗格，並顯示 lpszInfo 所指定的資訊字串。
當 lpszInfo 為 NULL 時，狀態列會還原為一般模式。
另請參閱
階層架構圖表
類別
CMFCRibbonBar 類別
CMFCRibbonBaseElement 類別
CMFCRibbonBar 類別