ICommandTarget インターフェイス

  • [アーティクル]

コマンド ソース オブジェクトからコマンドを受け取るインターフェイスをユーザー コントロールに提供します。

構文

interface class ICommandTarget

メンバー

パブリック メソッド

名前 説明
ICommandTarget::Initialize コマンド ターゲット オブジェクトを初期化します。

解説

MFC ビューでユーザー コントロールをホストすると、 CWinFormsView はコマンドをルーティングし、コマンド UI メッセージをユーザー コントロールに更新して、MFC コマンド (フレーム メニュー項目やツール バー ボタンなど) を処理できるようにします。 実装ICommandTargetすることで、ユーザー コントロールに ICommandSource オブジェクトへの参照を与えます。

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

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

必要条件

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

ICommandTarget::Initialize

コマンド ターゲット オブジェクトを初期化します。

void Initialize(ICommandSource^ cmdSource);

パラメーター

cmdSource
コマンド ソース オブジェクトへのハンドル。

解説

MFC ビューでユーザー コントロールをホストすると、CWinFormsView はコマンドをルーティングし、コマンド UI メッセージをユーザー コントロールに更新して MFC コマンドを処理できるようにします。

このメソッドは、コマンド ターゲット オブジェクトを初期化し、指定されたコマンド ソース オブジェクト cmdSource に関連付けます。 ユーザー コントロール クラスの実装で呼び出す必要があります。 初期化時に、Initialize 実装で ICommandSource::AddCommandHandler を呼び出して、コマンド ソース オブジェクトにコマンド ハンドラーを登録する必要があります。 Initialize を使用してこれを行う方法の例については、「方法: Windows フォーム コントロールにコマンド ルーティングを追加する」を参照してください。

関連項目

方法: Windows フォーム コントロールにコマンド ルーティングを追加する
ICommandSource インターフェイス