深入解析C++程序中激发事件和COM中的事件处理
本机 C++ 中的事件处理
在处理本机 C ++ 事件时，您分别使用 event_source 和 event_receiver 特性设置事件源和事件接收器，并指定 type=native。这些特性允许应用它们的类在本机的非 COM 上下文中激发和处理事件。
声明事件
在事件源类中，对一个方法声明使用 __event关键字可将该方法声明为事件。请确保声明该方法，但不要定义它；这样做会产生编译器错误，因为将该方法转换为事件时编译器会隐式定义它。本机事件可以是带有零个或多个参数的方法。返回类型可以是 void 或任何整型。
定义事件处理程序
在事件接收器类中，可定义事件处理程序，这些处理程序是具有与它们将处理的事件匹配的签名（返回类型、调用约定和参数）的方法。
将事件处理程序挂钩到事件
同样在事件接收器类中，可使用内部函数 __hook 将事件与事件处理程序关联，并可使用 __unhook 取消事件与事件处理程序的关联。您可将多个事件挂钩到一个事件处理程序，或将多个事件处理程序挂钩到一个事件。
激发事件
若要激发事件，只需调用声明为事件源类中的事件的方法即可。如果处理程序已挂钩到事件，则将调用处理程序。
本机 C++ 事件代码
以下示例演示如何在本机 C++ 中激发事件。若要编译并运行此示例，请参考代码中的注释。
示例代码
// evh_native.cpp
#include <stdio.h>
[event_source(native)]
class CSource {
public:
__event void MyEvent(int nValue);
};
[event_receiver(native)]
class CReceiver {
public:
void MyHandler1(int nValue) {
printf_s("MyHandler1 was called with value %d.\n", nValue);
}
void MyHandler2(int nValue) {
printf_s("MyHandler2 was called with value %d.\n", nValue);
}
void hookEvent(CSource* pSource) {
__hook(&CSource::MyEvent, pSource, &CReceiver::MyHandler1);
__hook(&CSource::MyEvent, pSource, &CReceiver::MyHandler2);
}
void unhookEvent(CSource* pSource) {
__unhook(&CSource::MyEvent, pSource, &CReceiver::MyHandler1);
__unhook(&CSource::MyEvent, pSource, &CReceiver::MyHandler2);
}
};
int main() {
CSource source;
CReceiver receiver;
receiver.hookEvent(&source);
__raise source.MyEvent(123);
receiver.unhookEvent(&source);
}
输出：
MyHandler2 was called with value 123. MyHandler1 was called with value 123.
COM 中的事件处理
在 COM 事件处理中，您使用 event_source 和 event_receiver 特性分别设置事件源和事件接收器，并指定 type=com。这些特性为自定义接口、调度接口和双重接口注入相应的代码，从而使这些接口能够应用到的类激发事件并通过 COM 连接点处理事件。
声明事件
在事件源类中，在接口声明上使用 __event 关键字以将该接口的方法声明为事件。当您将该接口的事件作为接口方法调用时，将激发这些事件。事件接口上的方法可以有零个或多个参数（应全是 in 参数）。返回类型可以是 void 或任何整型。
定义事件处理程序
在事件接收器类中，可定义事件处理程序，这些处理程序是具有与它们将处理的事件匹配的签名（返回类型、调用约定和参数）的方法。对于 COM 事件，调用约定不必匹配；有关详细信息，请参阅下文中的依赖于布局的 COM 事件。
将事件处理程序挂钩到事件
同样在事件接收器类中，可使用内部函数 __hook 将事件与事件处理程序关联，并可使用 __unhook 取消事件与事件处理程序的关联。您可将多个事件挂钩到一个事件处理程序，或将多个事件处理程序挂钩到一个事件。
注意
通常，有两种方法使 COM 事件接收器能够访问事件源接口定义。第一种是共享公共头文件，如下所示。第二种是将 #import 与 embedded_idl 导入限定符结合使用，以便让事件源类型库写入到保留了特性生成的代码的 .tlh 文件。
激发事件
若要激发事件，只需调用在事件源类中使用 __event 关键字声明的接口中的方法。如果处理程序已挂钩到事件，则将调用处理程序。
COM 事件代码
下面的示例演示如何在 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;
}
输出
MyHandler1 was called with value 123. MyHandler2 was called with value 123.
依赖于布局的 COM 事件
布局依赖性只是 COM 编程中的一个问题。在本机和托管事件处理中，处理程序的签名（返回类型、调用约定和参数）必须与其事件匹配，但处理程序的名称不必与其事件匹配。
但是，在 COM 事件处理中，如果将 event_receiver 的 layout_dependent 参数设置为 true，则将强制名称和签名匹配。这意味着事件接收器中处理程序的名称和签名必须与处理程序将挂钩到的事件的名称和签名完全匹配。
当 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
}
};
相关文章
今天小编就为大家分享一篇关于C++实践数组类运算的实现参考，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧2019-02-02
这篇文章主要为大家详细介绍了如何溧阳C语言实现绘制LoveBeat爱心曲线，文中的示例代码讲解详细，感兴趣的小伙伴可以跟随小编一起学习一下2023-03-03
上篇文章简单给大介绍了 C++20 特性 协程 Coroutines co_yield 和 co_return 那么这篇文章继续给大家介绍C++20 的新特性协程 Coroutines co_await,需要的朋友可以参考一下2021-10-10
本文给大家汇总介绍了几种C++求Fib数列的方法，有需要的小伙伴们可以来参考下2016-02-02
这篇文章主要为大家介绍一个C++ OpenCV的实战——文档照片转换成扫描文件，文中的示例代码讲解详细，感兴趣的小伙伴可以跟随小编一起学习一下2022-09-09
这篇文章主要介绍了c++自带的查找函数,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2023-09-09
一个中大型软件往往由多名程序员共同开发，会使用大量的变量和函数，当有两个人都同时定义了一个名字相同的全局变量或函数的时候，若是把他们的代码整合在一块编译，此时编译器就会提示变量或函数重复定义，C++为了解决这个问题，便引用了命名空间(namespace)的概念2020-01-01
这一篇我要跟大家介绍二叉搜索树中的另一颗树——红黑树，它主要是通过控制颜色来控制自身的平衡，但它的平衡没有AVL树的平衡那么严格2022-03-03
这篇文章主要介绍了C语言实现abs和fabs绝对值，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2021-01-01
哈希表，即散列表，可以快速地存储和查询记录。这篇文章主要为大家详细介绍了C++数据结构中哈希表的实现，感兴趣的小伙伴可以了解一下2023-03-03
最新评论