ICommandSource インターフェイス
コマンドソースオブジェクトからユーザーコントロールに送信されたコマンドを管理します。
構文
interface class ICommandSource
メンバー
パブリック メソッド
| 名前 | 説明 |
|---|---|
| ICommandSource:: AddCommandHandler | コマンドソースオブジェクトにコマンドハンドラーを追加します。 |
| ICommandSource:: AddCommandRangeHandler | コマンドソースオブジェクトにコマンドハンドラーのグループを追加します。 |
| ICommandSource:: AddCommandRangeUIHandler | コマンドソースオブジェクトに、ユーザーインターフェイスのコマンドメッセージハンドラーのグループを追加します。 |
| ICommandSource:: Add Duihandler | コマンドソースオブジェクトにユーザーインターフェイスのコマンドメッセージハンドラーを追加します。 |
| ICommandSource::P ostCommand | 処理されるのを待たずにメッセージをポストします。 |
| ICommandSource:: RemoveCommandHandler | コマンドソースオブジェクトからコマンドハンドラーを削除します。 |
| ICommandSource:: RemoveCommandRangeHandler | コマンドソースオブジェクトからコマンドハンドラーのグループを削除します。 |
| ICommandSource:: RemoveCommandRangeUIHandler | コマンドソースオブジェクトからユーザーインターフェイスのコマンドメッセージハンドラーのグループを削除します。 |
| ICommandSource:: RemoveCommandUIHandler | コマンドソースオブジェクトからユーザーインターフェイスのコマンドメッセージハンドラーを削除します。 |
| ICommandSource:: SendCommand | メッセージを送信し、が返される前に処理されるのを待機します。 |
注釈
MFC ビューでユーザーコントロールをホストする場合、 CWinFormsView クラス は、コマンドをルーティングし、コマンド UI メッセージをユーザーコントロールに更新して、mfc コマンドを処理できるようにします (たとえば、フレームメニュー項目やツールバーボタンなど)。 ICommandTarget インターフェイスを実装することにより、ユーザーコントロールにオブジェクトへ ICommandSource の参照を与えることができます。
の使用方法の例については、「方法: Windows フォームコントロールにコマンドルーティングを追加する」を参照してください。 ICommandTarget
Windows フォームの使用方法の詳細については、「 MFC での Windows フォームユーザーコントロールの使用」を参照してください。
要件
ヘッダー: afxwinforms (アセンブリ atlmfc\lib\mfcmifc80.dll で定義)
ICommandSource:: AddCommandHandler
コマンドソースオブジェクトにコマンドハンドラーを追加します。
void AddCommandHandler(
unsigned int cmdID,
CommandHandler^ cmdHandler);
パラメーター
cmdID
コマンド ID. Cmdhandler
コマンドハンドラーメソッドへのハンドル。
注釈
このメソッドは、コマンドハンドラーの cmdHandler をコマンドソースオブジェクトに追加し、ハンドラーを cmdID にマップします。 addcommandhandler の使用方法の例については、「方法: Windows フォームコントロールにコマンドルーティングを追加する」を参照してください。
ICommandSource:: AddCommandRangeHandler
コマンドソースオブジェクトにコマンドハンドラーのグループを追加します。
void AddCommandRangeHandler(
unsigned int cmdIDMin,
unsigned int cmdIDMax,
CommandHandler^ cmdHandler);
パラメーター
cmdIDMin
コマンド ID 範囲の開始インデックス。
cmdIDMax
コマンド ID 範囲の終了インデックス。
cmdHandler
コマンドのマップ先となるメッセージハンドラーメソッドへのハンドル。
注釈
このメソッドは、連続した一連のコマンド Id を1つのメッセージハンドラーにマップして、コマンドソースオブジェクトに追加します。 これは、関連するボタンのグループを1つの方法で処理するために使用されます。
ICommandSource:: AddCommandRangeUIHandler
コマンドソースオブジェクトに、ユーザーインターフェイスのコマンドメッセージハンドラーのグループを追加します。
void AddCommandRangeUIHandler(
unsigned int cmdIDMin,
unsigned int cmdIDMax,
CommandUIHandler^ cmdUIHandler);
パラメーター
cmdIDMin
コマンド ID 範囲の開始インデックス。
cmdIDMax
コマンド ID 範囲の終了インデックス。
cmdHandler
コマンドのマップ先となるメッセージハンドラーメソッドへのハンドル。
注釈
このメソッドは、コマンド Id の連続した範囲を1つのユーザーインターフェイスのコマンドメッセージハンドラーにマップして、コマンドソースオブジェクトに追加します。 これは、関連するボタンのグループを1つの方法で処理するために使用されます。
ICommandSource:: Add Duihandler
コマンドソースオブジェクトにユーザーインターフェイスのコマンドメッセージハンドラーを追加します。
void AddCommandUIHandler(
unsigned int cmdID,
CommandUIHandler^ cmdUIHandler);
パラメーター
cmdID
コマンド ID。 Cmduihandler
ユーザーインターフェイスコマンドメッセージハンドラーメソッドへのハンドル。
注釈
このメソッドは、コマンドソースオブジェクトにユーザーインターフェイスのコマンドメッセージハンドラー cmdHandler を追加し、そのハンドラーを cmdID にマップします。
ICommandSource::P ostCommand
処理されるのを待たずにメッセージをポストします。
void PostCommand(unsigned int command);
パラメーター
command
ポストされるメッセージのコマンド ID。
注釈
このメソッドは、コマンドで指定された ID にマップされたメッセージを非同期にポストします。 CWnd::P ostMessage を呼び出して、ウィンドウのメッセージキューにメッセージを配置し、対応するウィンドウがメッセージを処理するのを待たずに制御を戻します。
ICommandSource:: RemoveCommandHandler
コマンドソースオブジェクトからコマンドハンドラーを削除します。
void RemoveCommandHandler(unsigned int cmdID);
パラメーター
cmdID
コマンド ID。
注釈
このメソッドは、コマンドソースオブジェクトから、cmdID にマップされたコマンドハンドラーを削除します。
ICommandSource:: RemoveCommandRangeHandler
コマンドソースオブジェクトからコマンドハンドラーのグループを削除します。
void RemoveCommandRangeUIHandler(
unsigned int cmdIDMin,
unsigned int cmdIDMax);
パラメーター
cmdIDMin
コマンド ID 範囲の開始インデックス。
cmdIDMax
コマンド ID 範囲の終了インデックス。
注釈
このメソッドは、コマンド ソース オブジェクトから、cmdIDMin と cmdIDMax で指定されたコマンド ID にマップされたメッセージ ハンドラーのグループを削除します。
ICommandSource::RemoveCommandRangeUIHandler
コマンド ソース オブジェクトからユーザー インターフェイス コマンド メッセージ ハンドラーのグループを削除します。
void RemoveCommandRangeUIHandler(
unsigned int cmdIDMin,
unsigned int cmdIDMax);
パラメーター
cmdIDMin
コマンド ID 範囲の開始インデックス。
cmdIDMax
コマンド ID 範囲の終了インデックス。
注釈
このメソッドは、コマンド ソース オブジェクトから、cmdIDMin と cmdIDMax で指定されたコマンド ID にマップされたユーザー インターフェイス コマンド メッセージ ハンドラーのグループを削除します。
ICommandSource::RemoveCommandUIHandler
コマンド ソース オブジェクトからユーザー インターフェイス コマンド メッセージ ハンドラーを削除します。
void RemoveCommandUIHandler(unsigned int cmdID);
パラメーター
Cmdid
コマンド ID。
注釈
このメソッドは、コマンド ソース オブジェクトから cmdID にマップされたユーザー インターフェイス コマンド メッセージ ハンドラーを削除します。
ICommandSource::SendCommand
メッセージを送信し、メッセージが処理されるのを待って戻ります。
void SendCommand(unsigned int command);
パラメーター
command
送信するメッセージのコマンド ID。
注釈
このメソッドは、コマンドで指定された ID にマップされたメッセージを同期的に送信します。 CWnd::SendMessage を呼び出してウィンドウのメッセージ キューにメッセージを配置し、そのウィンドウ プロシージャがメッセージを処理してから戻るまで待機します。
こちらもご覧ください
方法: Windows フォーム コントロールにコマンド ルーティングを追加する
ICommandTarget インターフェイス