次の方法で共有

COM のイベント処理

  • [アーティクル]

COM イベント処理ではソース と event_receiver の属性を使用して type=com を指定するイベント ソースとイベント レシーバーがそれぞれ設定します。これらの属性はCOM のコネクション ポイントを通じてイベントとイベント処理を発生させるために適用されるクラスを可能にするカスタムデュアルディスパッチ インターフェイスの適切なコードを挿入します。

イベントの宣言

イベント ソース クラスではイベント インターフェイスのメソッドとして宣言するインターフェイスの宣言 __event のキーワードを使用します。このインターフェイスのイベントはインターフェイス メソッドであるを呼び出すときに発生します。イベント インターフェイスのメソッドはすべてのパラメーター 入力 がある場合 (ゼロ) こともより多くのパラメーター。戻り値の型が void または整数型を指定できます。

イベント ハンドラーの定義

イベント レシーバー クラスでは定義 (戻り値の型呼び出し規約および) とメソッドの引数に一致するイベントのイベント ハンドラーを定義します。COM のイベントでの呼び出し規約は一致する必要はありません ; 詳細については次 レイアウトに依存した COM イベント を参照してください。

イベントのイベント ハンドラーをフック

またイベント レシーバーのクラスではイベントのイベント ハンドラーを分離するイベント ハンドラーと __unhook とイベントを関連付けるには __hook 組み込み関数を使用します。イベントに複数のイベント ハンドラーに複数のイベントをフックすることができます。

[!メモ]

通常COM イベント レシーバーをイベント ソース インターフェイス定義へのアクセスを許可する 2 とおりの方法があります。次に示すように1 番目のは共通のヘッダー ファイルを共有します。2 番目のイベント ソースのタイプ ライブラリを維持する属性が生成したコードを .tlh ファイルに書き込むことが embedded_idl のインポートの修飾子で #import を使用します。

イベントの発生

イベントを発生させるには宣言されたイベント ソース クラスの __event キーワードのインターフェイスのメソッドを呼び出します。ハンドラーがイベントに引っ掛かったらハンドラーが呼び出されます。

hdcxwbd5.collapse_all(ja-jp,VS.110).gifCOM イベント コード

次の例はCOM クラスのイベントを発生させる方法を示します。例をコンパイルして実行するにはコード内のコメントを参照してください。

// evh_server.h
#pragma once

[ dual, uuid("00000000-0000-0000-0000-000000000001") ]
__interface IEvents {
   [id(1)] HRESULT MyEvent([in] int value);
};

[ dual, uuid("00000000-0000-0000-0000-000000000002") ]
__interface IEventSource {
   [id(1)] HRESULT FireEvent();
};

class DECLSPEC_UUID("530DF3AD-6936-3214-A83B-27B63C7997C4") CSource;

次にサーバー :

// evh_server.cpp
// compile with: /LD
// post-build command: Regsvr32.exe /s evh_server.dll
#define _ATL_ATTRIBUTES 1
#include <atlbase.h>
#include <atlcom.h>
#include "evh_server.h"

[ module(dll, name="EventSource", uuid="6E46B59E-89C3-4c15-A6D8-B8A1CEC98830") ];

[coclass, event_source(com), uuid("530DF3AD-6936-3214-A83B-27B63C7997C4")]
class CSource : public IEventSource {
public:
   __event __interface IEvents; 

   HRESULT FireEvent() {
      __raise MyEvent(123);
      return S_OK;
   }
};

以下はクライアント :

// evh_client.cpp
// compile with: /link /OPT:NOREF
#define _ATL_ATTRIBUTES 1
#include <atlbase.h>
#include <atlcom.h>
#include <stdio.h>
#include "evh_server.h"

[ module(name="EventReceiver") ];

[ event_receiver(com) ]
class CReceiver {
public:
   HRESULT MyHandler1(int nValue) {
      printf_s("MyHandler1 was called with value %d.\n", nValue);
      return S_OK;
   }

   HRESULT MyHandler2(int nValue) {
      printf_s("MyHandler2 was called with value %d.\n", nValue);
      return S_OK;
   }

   void HookEvent(IEventSource* pSource) {
      __hook(&IEvents::MyEvent, pSource, &CReceiver::MyHandler1);
      __hook(&IEvents::MyEvent, pSource, &CReceiver::MyHandler2);
   }

   void UnhookEvent(IEventSource* pSource) {
      __unhook(&IEvents::MyEvent, pSource, &CReceiver::MyHandler1);
      __unhook(&IEvents::MyEvent, pSource, &CReceiver::MyHandler2);
   }
};

int main() {
   // Create COM object
   CoInitialize(NULL);
   {
      IEventSource* pSource = 0;
      HRESULT hr = CoCreateInstance(__uuidof(CSource), NULL,         CLSCTX_ALL, __uuidof(IEventSource), (void **) &pSource);
      if (FAILED(hr)) {
         return -1;
      }

      // Create receiver and fire event
      CReceiver receiver;
      receiver.HookEvent(pSource);
      pSource->FireEvent();
      receiver.UnhookEvent(pSource);
   }
   CoUninitialize();
   return 0;
}

hdcxwbd5.collapse_all(ja-jp,VS.110).gif出力

MyHandler1 was called with value 123.
MyHandler2 was called with value 123.

レイアウトに依存した COM イベント

レイアウトの依存関係は COM プログラミング用の問題です。ハンドラーの定義 (戻り値の型と引数)呼び出し規約を処理するネイティブおよびマネージ イベントではのイベントに一致するハンドラーはイベント名と一致する必要はありません。

ただしCOM のイベント処理ではtrue に event_receiverlayout_dependent のパラメーターを設定すると名前とシグネチャの一致が適用されます。これはイベント レシーバーのハンドラーの名前とシグネチャがフックするイベントの名前とシグネチャと一致する必要があります。

layout_dependent に設定された場合呼び出し規約は False にストレージ クラス (仮想静的イベントを発生メソッドとデリゲートをフックするメソッド () ではなど) は組み合わせることができます。これは layout_dependent=true を設定するにはわずかに効率的です。

たとえば次のメソッドを持つように IEventSource が定義されているとします :

[id(1)] HRESULT MyEvent1([in] int value);
[id(2)] HRESULT MyEvent2([in] int value);

イベント ソースに次のフォームがあるとします。:

[coclass, event_source(com)]
class CSource : public IEventSource {
public:
   __event __interface IEvents;

   HRESULT FireEvent() {
      MyEvent1(123);
      MyEvent2(123);
      return S_OK;
   }
};

次のようにイベント ハンドラーでIEventSource のメソッドにフック エラー ハンドラーが名前とシグネチャと一致する必要があります :

[coclass, event_receiver(com, true)]
class CReceiver {
public:
   HRESULT MyEvent1(int nValue) {  // name and signature matches MyEvent1
      ...
   }
   HRESULT MyEvent2(E c, char* pc) {  // signature doesn't match MyEvent2
      ...
   }
   HRESULT MyHandler1(int nValue) {  // name doesn't match MyEvent1 (or 2)
      ...
   }
   void HookEvent(IEventSource* pSource) {
      __hook(IFace, pSource);  // Hooks up all name-matched events 
                               // under layout_dependent = true
      __hook(&IFace::MyEvent1, pSource, &CReceive::MyEvent1);   // valid
      __hook(&IFace::MyEvent2, pSource, &CSink::MyEvent2);   // not valid
      __hook(&IFace::MyEvent1, pSource, &CSink:: MyHandler1); // not valid
   }
};

参照

関連項目

イベント処理