CStatusBar クラス

テキスト出力用のペインまたは "インジケーター" の行を持つコントロール バーです。

class CStatusBar : public CControlBar

メンバー

fha3tfk7.collapse_all(ja-jp,VS.110).gifパブリック コンストラクター

名前

説明

CStatusBar::CStatusBar

CStatusBar オブジェクトを構築します。

fha3tfk7.collapse_all(ja-jp,VS.110).gifパブリック メソッド

名前

説明

CStatusBar::CommandToIndex

特定のインジケーター ID のインデックスを取得します

CStatusBar::Create

ステータス バーを作成し、CStatusBar のオブジェクトにアタッチし、最初のフォントおよびバーの高さを設定します。

CStatusBar::CreateEx

CStatusBarCtrl の埋め込みオブジェクトの追加スタイルの CStatusBar のオブジェクトを作成します。

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

特定のインデックスのインジケーターのテキストを設定します。

解説

出力ウィンドウにメッセージ行に自動で表示灯として一般的に使用されます。例では、ScrollLock キーに、NumLock キーやそのほかのキーの状態を示すインジケーター、および選択されたメニュー コマンドを説明するメニューのヘルプ メッセージの行が含まれます。

CStatusBar::GetStatusBarCtrlの MFC 4.0 に新しいメンバー関数は、ステータス バーのカスタマイズと追加の機能の Windows コモン コントロールのサポートを利用できるようにします。CStatusBar のメンバー関数は、Windows コモン コントロールの機能の最もいます; ただし、GetStatusBarCtrlを呼び出すと、Windows 95 /98 のステータス バー、ステータス バーにの特性をさらに指定できます。GetStatusBarCtrlを呼び出すと、CStatusBarCtrl のオブジェクトへの参照を返します。Windows コモン コントロールを使用してツール バーのデザインに関する詳細については、CStatusBarCtrl を参照してください。コモン コントロールについては、Windows SDKの [コモン コントロール] を参照してください。

フレームワークは、位置 0 に左端のインジケーターを含む配列でインジケーターの情報を格納します。ステータス バーを作成すると、フレームワークは対応するインジケーターに関連付ける文字列 ID の配列を使用します。その後、文字列の ID またはインジケーターにアクセスするには、インデックスを使用できます。

既定では、最初のインジケーターは「ゴム」: そのほかのウィンドウが右寄せで表示されるように、他のインジケーターのウィンドウで使用されていないステータス バーの長さを占有します。

ステータス バーを作成するには、次の手順を実行する:

  1. CStatusBar オブジェクトを構築します。

  2. ステータス バー ペインを作成し、CStatusBar のオブジェクトにアタッチするに [作成] (または) CreateEx関数を呼び出します。

  3. 各インジケーターで文字列の ID を関連付けるに SetIndicators を呼び出します。

ステータス バー ペインのテキストを更新する方法が 3 つあります:

  1. ウィンドウ 0 テキストを更新するのみ使用 CWnd::SetWindowText

  2. ステータス バーの ON_UPDATE_COMMAND_UI のハンドラーでは CCmdUI::SetText

  3. ウィンドウのテキストを更新します SetPaneText

ステータス バー ペインのスタイルを更新します SetPaneStyle

CStatusBarの使用の詳細については、" " MFC ステータス バーの実装テクニカル ノート 31: コントロール バーを参照してください。

継承階層

CObject

CCmdTarget

CWnd

CControlBar

CStatusBar

必要条件

Header: afxext.h

参照

関連項目

CControlBar クラス

階層図

CStatusBarCtrl クラス

CControlBar クラス

CWnd::SetWindowText

CStatusBar::SetIndicators

概念

MFC CTRLBARS サンプル

MFC DLGCBR32 サンプル