ICommandUI インターフェイス

ユーザー インターフェイス コマンドを管理します。

構文

interface class ICommandUI

メンバー

パブリック メソッド

名前	説明
icommandui__Check	このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。
ICommandUI::ContinueRouting	現在のメッセージをハンドラーのチェーンにルーティングし続けるよう、コマンド ルーティング メカニズムに指示します。
ICommandUI::Enabled	このコマンドのユーザー インターフェイス項目を有効または無効にします。
ICommandUI::ID	オブジェクトによって表されるユーザー インターフェイス オブジェクトの ID を ICommandUI 取得します。
ICommandUI::Index	オブジェクトによって表されるユーザー インターフェイス オブジェクトのインデックスを ICommandUI 取得します。
ICommandUI::Radio	このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。
ICommandUI::Text	このコマンドのユーザー インターフェイス項目のテキストを設定します。

解説

このインターフェイスには、ユーザー インターフェイス コマンドを管理するメソッドとプロパティが用意されています。 ICommandUIは CCmdUI クラスに似ていますがICommandUI、.NET コンポーネントと相互運用する MFC アプリケーションに使用される点が異なります。

ICommandUIは、ICommandTarget 派生クラスのON_UPDATE_COMMAND_UI ハンドラー内で使用されます。 アプリケーションのユーザーがメニューをアクティブ化 (選択またはクリック) すると、各メニュー項目が有効または無効として表示されます。 各メニュー コマンドのターゲットは、ON_UPDATE_COMMAND_UI ハンドラーを実装することによってこの情報を提供します。 アプリケーションのコマンド ユーザー インターフェイス オブジェクトごとに、クラス ウィザードを使用して、各ハンドラーのメッセージ マップ エントリと関数プロトタイプを作成します。

コマンド ルーティングでインターフェイスを使用するICommandUI方法の詳細については、「方法: Windows フォーム コントロールにコマンド ルーティングを追加する」を参照してください。

Windows フォームの使用方法の詳細については、「MFC での Windows フォーム ユーザー コントロールの使用」を参照してください。

MFC でのユーザー インターフェイス コマンドの管理方法の詳細については、「CCmdUI クラス」を参照してください。

ICommandUI::Check

このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。

property UICheckState Check;

解説

このプロパティは、このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。 Check を次の値に設定します。

• 0 Unチェック
• 1 チェック
• 2 不確定の設定

ICommandUI::ContinueRouting

現在のメッセージをハンドラーのチェーンにルーティングし続けるよう、コマンド ルーティング メカニズムに指示します。

void ContinueRouting();

解説

これは、FAL Standard Edition を返すON_COMMAND_EX ハンドラーと組み合わせて使用する必要がある高度なメンバー関数です。 詳細については、「テクニカル ノート TN006: メッセージ マップ」を参照してください。

ICommandUI::Enabled

このコマンドのユーザー インターフェイス項目を有効または無効にします。

property bool Enabled;

解説

このプロパティは、このコマンドのユーザー インターフェイス項目を有効または無効にします。 [有効] を TRUE に設定すると、アイテム FAL Standard Edition が無効になります。

ICommandUI::ID

ICommandUI オブジェクトによって表されるユーザー インターフェイス オブジェクトの ID を取得します。

property unsigned int ID;

解説

このプロパティは、メニュー項目、ツール バー ボタン、または ICommandUI オブジェクトによって表されるその他のユーザー インターフェイス オブジェクトの ID (ハンドル) を取得します。

ICommandUI::Index

ICommandUI オブジェクトによって表されるユーザー インターフェイス オブジェクトのインデックスを取得します。

property unsigned int Index;

解説

このプロパティは、メニュー項目、ツール バー ボタン、または ICommandUI オブジェクトによって表されるその他のユーザー インターフェイス オブジェクトのインデックス (ハンドル) を取得します。

ICommandUI::Radio

このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。

property bool Radio;

解説

このプロパティは、このコマンドのユーザー インターフェイス項目を適切なチェック状態に設定します。 項目を有効にするには、ラジオを TRUE に設定します。それ以外の場合は FAL Standard Edition。

ICommandUI::Text

このコマンドのユーザー インターフェイス項目のテキストを設定します。

property String^ Text;

解説

このプロパティは、このコマンドのユーザー インターフェイス項目のテキストを設定します。 テキストをテキスト文字列ハンドルに設定します。

必要条件

ヘッダー: afxwinforms.h (アセンブリ atlmfc\lib\mfcmifc80.dll で定義)

関連項目

CCmdUI クラス