CStatusBar 類別

有文字資料列的控制列輸出窗格或「說明」。

class CStatusBar : public CControlBar

成員

fha3tfk7.collapse_all(zh-tw,VS.110).gif公用建構函式

名稱

描述

CStatusBar::CStatusBar

建構 CStatusBar 物件。

fha3tfk7.collapse_all(zh-tw,VS.110).gif公用方法

名稱

描述

CStatusBar::CommandToIndex

取得指定顯示 ID. 的索引。

CStatusBar::Create

建立這個狀態列,將它附加至 CStatusBar 物件,並將初始字型和列高度。

CStatusBar::CreateEx

建立含有其他樣式的 CStatusBar 物件 CStatusBarCtrl 內嵌物件的。

CStatusBar::DrawItem

呼叫,以主控描繪狀態列控制項的視覺外觀變更時。

CStatusBar::GetItemID

取得位於指定索引的說明 ID。

CStatusBar::GetItemRect

取得位於指定索引的顯示矩形。

CStatusBar::GetPaneInfo

取得顯示 ID、樣式和寬度指定索引的。

CStatusBar::GetPaneStyle

取得位於指定索引的顯示樣式。

CStatusBar::GetPaneText

取得指定索引上的顯示文字。

CStatusBar::GetStatusBarCtrl

允許傳送至基礎通用控制項的直接存取。

CStatusBar::SetIndicators

設定顯示 ID。

CStatusBar::SetPaneInfo

設定顯示 ID、樣式和寬度指定索引的。

CStatusBar::SetPaneStyle

設定指定之索引處的顯示模式。

CStatusBar::SetPaneText

設定指定之索引的顯示文字。

備註

輸出窗格最常使用在訊息列和目前狀態指示。 範例包括簡短說明選擇的功能表命令和顯示 SCROLL LOCK、NUM LOCK 和其他按鍵狀態的功能表說明訊息行。

CStatusBar::GetStatusBarCtrl,成員函式新增至 MFC 4.0,可讓您利用 Windows 通用控制項支援狀態列自訂和其他功能。 CStatusBar 成員函式讓您最新 Windows 通用控制項的功能,不過,在中,當您呼叫 GetStatusBarCtrl時,您可以將狀態列 Windows 95 特性/98 狀態列。 當您呼叫 GetStatusBarCtrl,它將會傳回 CStatusBarCtrl 物件的參考。 使用 Windows 通用控制項,請參閱 CStatusBarCtrl 有關設計工具列的詳細資訊。 如需通用控制項的詳細資訊,請參閱 Windows SDK通用控制項

這個架構在最左方的顯示的陣列儲存資訊顯示在位置 0。 當您建立狀態列時,您可使用陣列架構與對應的顯示的字串識別項。 您可以使用字串 ID 或索引存取顯示。

根據預設,第一個顯示為「項目的」:其佔用其他窗格會顯示未使用的狀態列長度,因此,其他窗格靠右對齊。

若要建立狀態列,請依照下列步驟執行:

  1. CStatusBar 建構物件。

  2. 呼叫 建立 (或) CreateEx函式建立狀態列視窗並附加至 CStatusBar 物件。

  3. 呼叫 SetIndicators 關聯字串 ID 與每個顯示。

有三種方式更新狀態列窗格的文字:

  1. 呼叫更新只在 窗格中的 CWnd::SetWindowText 0 的文字。

  2. 在狀態列中 ON_UPDATE_COMMAND_UI 處理常式的呼叫 CCmdUI::SetText

  3. 呼叫更新任何窗格的文字 SetPaneText

呼叫更新狀態列窗格的樣式的 SetPaneStyle

如需使用 CStatusBar的詳細資訊,請參閱本文 在 MFC 狀態列實作Technical Note 31:控制項陣列。

繼承階層架構

CObject

CCmdTarget

CWnd

CControlBar

CStatusBar

需求

Header: afxext.h

請參閱

參考

CControlBar 類別

階層架構圖

CStatusBarCtrl 類別

CControlBar 類別

CWnd::SetWindowText

CStatusBar::SetIndicators

概念

MFC 範例 CTRLBARS

MFC 範例 DLG CBR32