ICommandUI インターフェイス
ユーザー インターフェイス コマンドを管理します。
構文
interface class ICommandUI
メンバー
パブリック メソッド
| 名前 | 説明 |
|---|---|
| icommandui__Check | このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。 |
| ICommandUI::ContinueRouting | 現在のメッセージをハンドラーのチェーンにルーティングし続けるよう、コマンド ルーティング メカニズムに指示します。 |
| ICommandUI::Enabled | このコマンドのユーザー インターフェイス項目を有効または無効にします。 |
| ICommandUI::ID | ICommandUI オブジェクトによって表されるユーザー インターフェイス オブジェクトの ID を取得します。 |
| ICommandUI::Index | ICommandUI オブジェクトによって表されるユーザー インターフェイス オブジェクトのインデックスを取得します。 |
| ICommandUI::Radio | このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。 |
| ICommandUI::Text | このコマンドのユーザー インターフェイス項目のテキストを設定します。 |
解説
このインターフェイスには、ユーザー インターフェイス コマンドを管理するメソッドとプロパティが用意されています。 ICommandUI は、 CCmdUI クラスに似ていますが、.NET コンポーネントと相互運用する MFC アプリケーションに ICommandUI が使用される点が異なります。
ICommandUI は、 ICommandTarget 派生クラスのON_UPDATE_COMMAND_UI ハンドラー内で使用されます。 アプリケーションのユーザーがメニューをアクティブ化 (選択またはクリック) すると、各メニュー項目が有効または無効として表示されます。 各メニュー コマンドのターゲットは、ON_UPDATE_COMMAND_UI ハンドラーを実装することによってこの情報を提供します。 アプリケーションのコマンド ユーザー インターフェイス オブジェクトごとに、 クラス ウィザード を使用して、各ハンドラーのメッセージ マップ エントリと関数プロトタイプを作成します。
ICommandUI インターフェイスをコマンド ルーティングで使用する方法の詳細については、「方法: Windows フォーム コントロールにコマンド ルーティングを追加するを参照してください。
Windows フォームの使用方法の詳細については、「 MFC での Windows フォーム ユーザー コントロールの使用」を参照してください。
MFC でのユーザー インターフェイス コマンドの管理方法の詳細については、「 CCmdUI クラスを参照してください。
ICommandUI::Check
このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。
property UICheckState Check;
解説
このプロパティは、このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。 Check を次の値に設定します。
- 0 オフ
- 1 チェック
- 2 不確定の設定
ICommandUI::ContinueRouting
現在のメッセージをハンドラーのチェーンにルーティングし続けるよう、コマンド ルーティング メカニズムに指示します。
void ContinueRouting();
解説
これは、FALSE を返すON_COMMAND_EX ハンドラーと組み合わせて使用する必要がある高度なメンバー関数です。 詳細については、「テクニカル ノート TN006: メッセージ マップ」を参照してください。
ICommandUI::Enabled
このコマンドのユーザー インターフェイス項目を有効または無効にします。
property bool Enabled;
解説
このプロパティは、このコマンドのユーザー インターフェイス項目を有効または無効にします。 項目を有効にするには [有効] を TRUE に設定し、無効にするには FALSE を設定します。
ICommandUI::ID
ICommandUI オブジェクトによって表されるユーザー インターフェイス オブジェクトの ID を取得します。
property unsigned int ID;
解説
このプロパティは、メニュー項目、ツール バー ボタン、または ICommandUI オブジェクトによって表されるその他のユーザー インターフェイス オブジェクトの ID (ハンドル) を取得します。
ICommandUI::Index
ICommandUI オブジェクトによって表されるユーザー インターフェイス オブジェクトのインデックスを取得します。
property unsigned int Index;
解説
このプロパティは、メニュー項目、ツール バー ボタン、または ICommandUI オブジェクトによって表されるその他のユーザー インターフェイス オブジェクトのインデックス (ハンドル) を取得します。
ICommandUI::Radio
このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。
property bool Radio;
解説
このプロパティは、このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。 項目を有効にするには、ラジオを TRUE に設定します。それ以外の場合は FALSE。
ICommandUI::Text
このコマンドのユーザー インターフェイス項目のテキストを設定します。
property String^ Text;
解説
このプロパティは、このコマンドのユーザー インターフェイス項目のテキストを設定します。 テキストをテキスト文字列ハンドルに設定します。
要件
Header: afxwinforms.h (アセンブリ atlmfc\lib\mfcmifc80.dll で定義)