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 で定義)

関連項目

CCmdUI クラス