テクニカルノート 71: MFC IOleCommandTarget の実装

[アーティクル]
02/21/2013

[!メモ]

次のテクニカルノートは、最初にオンラインドキュメントの一部とされてから更新されていません。結果として、一部のプロシージャおよびトピックが最新でないか、不正になります。最新の情報について、オンラインドキュメントのキーワードで関係のあるトピックを検索することをお勧めします。

IOleCommandTarget インターフェイスはオブジェクトを有効にし、ディスパッチへのコンテナーは相互にコマンド。たとえば、オブジェクトの印刷ツールバーは、 印刷プレビュー、 上書き保存(&&S),保存(&&S),上書き保存,保存,保存しますか、 Newと ズームのようなコマンドのボタンを含める場合があります。このようなオブジェクトが IOleCommandTargetをサポートするコンテナーに埋め込まれている場合、オブジェクトはボタンを有効にし、ユーザーがコントロールをクリックしたか処理するためのコンテナーにコマンドをコピーできます。コンテナーが埋め込まれたオブジェクトに自身を印刷する場合は、埋め込みオブジェクトの IOleCommandTarget インターフェイスを通じてコマンドを送信することで、この要求ができます。

IOleCommandTarget はサーバーのメソッドを呼び出すことをクライアントに使用されているオートメーションに似たインターフェイスです。ただし、 IOleCommandTarget を使用してプログラムが IDispatchの Invoke の通常のメソッドを使用する必要がないため、オートメーションインターフェイスによって呼び出しの作成のオーバーヘッドを保存します。

では、 MFC IOleCommandTarget インターフェイスを使用できるようにするためにアクティブドキュメントサーバーにアクティブドキュメントコンテナーディスパッチコマンドにサーバー。アクティブドキュメントサーバークラス、 CDocObjectServerItemの使用の MFC インターフェイス（ TN038: MFC/OLE IUnknown の実装を参照） IOleCommandTarget インターフェイスを実装するにマップします。

IOleCommandTarget は、 COleFrameHook のクラスに実装されます。COleFrameHook は埋め込み先編集コンテナーのフレームウィンドウの機能を実装する記載されていない MFC クラスです。COleFrameHook は、 IOleCommandTarget インターフェイスを実装するために MFC インターフェイスマップを使用します。COleFrameHook の COleDocObjectItemへの順方向の IOleCommandTarget の OLE コマンド派生アクティブドキュメントコンテナーの実装。これは、 MFC のアクティブドキュメントコンテナーが含まれるアクティブドキュメントサーバーからメッセージを受信できるようにします。

MFC OLE コマンドマップ

MFC の開発者は、 MFC OLE コマンドマップを使用して IOleCommandTarget を利用できます。OLE コマンドマップは、メッセージマップなどのコマンドマップを含むクラスのメンバー関数に OLE コマンドをマップするために使用できるためです。コマンドマップの作業、場所のマクロ OLE コマンドとコマンド ID を、処理するコマンドの OLE コマンドグループを指定するために、 OLE コマンドを受信したときに送信 WM_COMMAND のメッセージにする場合は。MFC は、標準 OLE コマンドにいくつかの定義済みマクロを提供します。Microsoft Office アプリケーションで使用するためにデザインされている標準 OLE コマンドの一覧については、 docobj.h で定義されている OLECMDID の列挙を参照してください。

OLE コマンドが OLE コマンドマップを含む MFC アプリケーションが受信すると、 MFC はアプリケーションの OLE コマンドマップの要求されたコマンドのコマンド ID、およびコマンドグループを検索します。一致がある場合、 WM_COMMAND のメッセージは、要求されたコマンドのコマンド ID のマッピングを含むアプリケーションにディスパッチされます。（次 ON_OLECMD の説明を参照してください。このように、アプリケーションにディスパッチ、 OLE コマンドは、 MFC によって WM_COMMAND のメッセージになります。WM_COMMAND のメッセージは、 MFC の標準コマンドルーティングアーキテクチャを使用してアプリケーションのメッセージマップを通じて、ルーティングされます。

メッセージマップとは異なり、 MFC OLE コマンドマップは ClassWizard でサポートされません。MFC の開発者は、 OLE コマンドマップサポートと OLE コマンドマップエントリを手動で追加する必要があります。OLE コマンドマップは、当時、アクティブドキュメントによって、コンテナーの埋め込み先編集である WM_COMMAND のメッセージルーティングのチェーンにあるクラスの MFC アクティブドキュメントサーバーに追加できます。これらのクラスは CWinApp、 CView、 CDocumentと COleIPFrameWndから派生したアプリケーションのクラスが含まれています。アクティブドキュメントコンテナーでは、 OLE コマンドマップは COleDocObjectItem派生クラスにのみ追加できます。また、アクティブドキュメントコンテナーで、 WM_COMMAND のメッセージが COleDocObjectItemのメッセージマップの派生クラスだけにディスパッチされます。

OLE コマンドマップマクロ

クラスは、コマンドマップの機能を追加するには、次のマクロの使用:

DECLARE_OLECMD_MAP ()

このマクロは、コマンドマップを含むクラスのクラス宣言（通常、ヘッダーファイル）になります。

BEGIN_OLECMD_MAP(theClass, baseClass)

theClass
コマンドマップを含んでいるクラスの名前。
baseClass
コマンドマップを含むクラスの基本クラスの名前。

このマクロは、コマンドマップの開始を示します。コマンドマップを含むクラスに実装ファイルにこのマクロを使用します。

END_OLECMD_MAP()

このマクロは、コマンドマップの終了位置を示します。コマンドマップを含むクラスに実装ファイルにこのマクロを使用します。このマクロは BEGIN_OLECMD_MAP のマクロに常に従う必要があります。

ON_OLECMD(pguid, olecmdid, id)

pguid
OLE コマンドのコマンドグループの GUID へのポインター。このパラメーターは、標準 OLE コマンドグループの NULL です。
olecmdid
OLE 起動されるコマンドのコマンド ID。
id
この OLE コマンドが呼び出されたときのコマンドマップを含むアプリケーションに送信する WM_COMMAND のメッセージの ID。

、処理する OLE コマンドのエントリを追加するには、コマンドにマップ ON_OLECMD のマクロを使用します。OLE コマンドを受け取った場合、 WM_COMMAND の指定されたメッセージに変換され、アプリケーションのメッセージマップを通じて標準 MFC のコマンドルーティングアーキテクチャを使用してパスを指定します。

使用例

次の例に OLECMDID_PRINT の OLE コマンドを処理するように MFC のアクティブドキュメントサーバーに OLE のコマンド処理機能を追加する方法を示します。この例は、アクティブドキュメントサーバーである MFC アプリケーションを作成するには、 AppWizard を使用したことを前提としています。

CView派生クラスのヘッダーファイルはクラス宣言に、 DECLARE_OLECMD_MAP のマクロを追加します。

[!メモ]

CView- WM_COMMAND のメッセージルーティングのチェーンにあるアクティブドキュメントサーバーのクラスの 1 であるため、派生クラスを使用します。
```
class CMyServerView : public CView
{
protected: // create from serialization only
   CMyServerView();
   DECLARE_DYNCREATE(CMyServerView)
   DECLARE_OLECMD_MAP()
. . .
};
```
CViewの実装ファイル派生クラスは、 BEGIN_OLECMD_MAP と END_OLECMD_MAP のマクロを追加します:
```
BEGIN_OLECMD_MAP(CMyServerView, CView)

END_OLECMD_MAP()
```
標準 OLE 印刷コマンドを処理するには、標準印刷コマンドで OLE コマンド ID と WM_COMMAND ID に ID_FILE_PRINT を指定するコマンドにマップ ON_OLECMD のマクロを追加します。ID_FILE_PRINT は、 AppWizard 生成された MFC アプリケーションで使用される標準印刷コマンドの ID です:
```
BEGIN_OLECMD_MAP(CMyServerView, CView)
   ON_OLECMD(NULL,OLECMDID_PRINT,ID_FILE_PRINT)
END_OLECMD_MAP()
```

OLECMDID_PRINT が標準 OLE コマンド ID であるため、標準 OLE コマンドマクロの場合に、 afxdocob.h で定義されていることに注意してください ON_OLECMD マクロの代わりに使用できますON_OLECMD_PRINT のマクロは、上記の ON_OLECMD マクロと同じタスクを実行します。

コンテナーアプリケーションがサーバーの IOleCommandTarget インターフェイスを使用してこのサーバーに OLECMDID_PRINT コマンドを送信するとき、 MFC の印刷コマンドハンドラーは、アプリケーションを印刷するサーバーと、に呼び出されます。前の手順で追加した印刷コマンドを呼び出すアクティブドキュメントコンテナーのコードは次のようになります。:

void CContainerCntrItem::DoOleCmd()
{
   IOleCommandTarget *pCmd = NULL;
   HRESULT hr = E_FAIL;
   OLECMD ocm={OLECMDID_PRINT, 0};

   hr = m_lpObject->QueryInterface(IID_IOleCommandTarget,reinterpret_cast<void**>(&pCmd));
   if(FAILED(hr))
      return;

   hr = pCmd->QueryStatus(NULL, 1, &ocm, NULL);
   if(SUCCEEDED(hr) && (ocm.cmdf & OLECMDF_ENABLED))
   {
      //Command is available and enabled so call it
      COleVariant vIn;
      COleVariant vOut;
      hr = pCmd->Exec(NULL, OLECMDID_PRINT,
 OLECMDEXECOPT_DODEFAULT, &vIn, &vOut);
      ASSERT(SUCCEEDED(hr));
   }
   pCmd->Release();
}

参照

その他の技術情報

番号順テクニカルノート

カテゴリ別テクニカルノート

次の方法で共有

テクニカルノート 71: MFC IOleCommandTarget の実装

MFC OLE コマンドマップ

OLE コマンドマップマクロ

使用例

参照

その他の技術情報

その他のリソース

次の方法で共有

テクニカル ノート 71: MFC IOleCommandTarget の実装

MFC OLE コマンド マップ

OLE コマンド マップ マクロ

使用例

参照

その他の技術情報

その他のリソース

テクニカルノート 71: MFC IOleCommandTarget の実装

MFC OLE コマンドマップ

OLE コマンドマップマクロ