CCmdUI クラス
更新 : 2007 年 11 月
このクラスは、CCmdTarget の派生クラスの ON_UPDATE_COMMAND_UI ハンドラ内だけで使われます。
class CCmdUI
解説
CCmdUI には、基本クラスはありません。
アプリケーションのユーザーが、メニューをプル ダウンしたときに、各メニュー項目は有効な項目として表示されるのか、無効な項目として表示されるのかを知る必要があります。この情報を与えるために、メニュー コマンドのターゲットに、ON_UPDATE_COMMAND_UI ハンドラを実装します。アプリケーションのコマンド ユーザー インターフェイス オブジェクトごとに、[プロパティ] ウィンドウを使って、各ハンドラに対してメッセージ マップのエントリと関数プロトタイプを作成します。
メニューがプル ダウンされると、フレームワークがそれぞれの ON_UPDATE_COMMAND_UI ハンドラを探して呼び出します。次に、それぞれのハンドラが Enable、Check などの CCmdUI メンバ関数を呼び出します。最後に、フレームワークが各メニュー項目を表示します。
ON_UPDATE_COMMAND_UI ハンドラ内のコードを変更せずに、メニュー項目をコントロール バーのボタンや、その他のコマンド ユーザー インターフェイス オブジェクトに置き換えることができます。
次に示す表に、コマンド ユーザー インターフェイスの各アイテムに対する、CCmdUI の各メンバ関数による処理をまとめます。
ユーザー インターフェイスの項目 |
Enable |
SetCheck |
SetRadio |
SetText |
|---|---|---|---|---|
メニュー項目 |
有効、または無効 |
チェック付き (×) またはチェックなし |
ドット (•) チェック付き |
項目テキストの設定 |
ツール バー ボタン |
有効、または無効 |
選択、未選択、または不確定 |
SetCheck と同じ |
(適用なし) |
ステータス バーのペイン |
テキストの表示、または非表示 |
突出境界、または通常の境界を表示 |
SetCheck と同じ |
ペイン テキストの設定 |
CDialogBar 内の通常ボタン |
有効、または無効 |
チェック ボックスのオン、またはオフ |
SetCheck と同じ |
ボタン テキストの設定 |
CDialogBar 内の通常のコントロール |
有効、または無効 |
(適用なし) |
(適用なし) |
ウィンドウ テキストの設定 |
このクラスの使用法の詳細については、「ユーザー インターフェイス オブジェクトの更新方法」を参照してください。
必要条件
ヘッダー : afxwin.h
参照
処理手順
MDI サンプル : ドキュメント/ビュー アーキテクチャを使用しない MDI