__event 关键字

声明事件。

注意

本机 C++ 中的事件特性与标准 C++ 不兼容。 指定 /permissive- 一致性模式时，它们不会编译。

语法

__event member-function-declarator ;
__event __interface interface-specifier ;
__event data-member-declarator ;

备注

特定于 Microsoft 的关键字 __event 可应用于成员函数声明、接口声明或数据成员声明。 但是，不能使用 __event 关键字限定嵌套类的成员。

根据您的事件源和接收器是本机 C++、COM 还是托管 (.NET Framework)，您可使用下列构造作为事件：

本机 C++	COM	托管 (.NET Framework)
成员函数	-	method
-	接口	-
-	-	数据成员 (data member)

在事件接收器中使用 __hook，将处理程序成员函数与事件成员函数相关联。 使用 __event 关键字创建事件之后，将在调用此事件时调用后来挂钩到它的所有事件处理程序。

__event 成员函数声明不能具有定义；定义是隐式生成的，因此调用事件成员函数就如同调用普通成员函数一样。

注意

模板类或结构不能包含事件。

本机事件

本机事件是成员函数。 返回类型通常是 HRESULT 或 void，但可以是任何整型，包括 enum。 当事件使用整数返回类型时，如果事件处理程序返回非零值，则会定义错误条件。 在这种情况下，引发的事件将调用其他委托。

// Examples of native C++ events:
__event void OnDblClick();
__event HRESULT OnClick(int* b, char* s);

有关代码示例，请参阅本机 C++ 中的事件处理。

COM 事件

COM 事件是接口。 事件源接口中成员函数的参数应是 in 参数，但不严格强制实施。 这是因为多播时， out 参数不起作用。 如果使用 out 参数，则将发出 1 级警告。

返回类型通常是 HRESULT 或 void，但可以是任何整型，包括 enum。 当事件使用整数返回类型时，并且事件处理程序返回非零值，这是错误条件。 引发的事件中止对其他委托的调用。 编译器会自动将一个事件源接口标记为生成的 IDL 中的 source。

COM 事件源的 __event 后面始终需要 __interface 关键字。

// Example of a COM event:
__event __interface IEvent1;

有关代码示例，请参阅 COM 中的事件处理。

托管事件

有关新语法中的编码事件的信息，请参阅事件。

托管事件是数据成员或成员函数。 当与事件一起使用时，委托的返回类型必须符合公共语言规范。 事件处理程序的返回类型必须与委托的返回类型匹配。 有关委托的详细信息，请参阅委托和事件。 如果托管事件是数据成员，则其类型必须是指向委托的指针。

在 .NET Framework 中，您可以将数据成员视为方法本身（即，其对应委托的 Invoke 方法）。 为此，请预定义用于声明托管事件数据成员的委托类型。 相反，托管事件方法隐式定义了相应的托管委托（如果尚未定义）。 例如，您可以将事件值（如 OnClick）声明为下面所示的事件：

// Examples of managed events:
__event ClickEventHandler* OnClick;  // data member as event
__event void OnClick(String* s);  // method as event

隐式声明托管事件时，可以指定添加或移除添加或移除事件处理程序时将调用的 add 和 remove 访问器。 还可以定义从类外部调用（引发）事件的成员函数。

示例：本机事件

// EventHandling_Native_Event.cpp
// compile with: /c
[event_source(native)]
class CSource {
public:
   __event void MyEvent(int nValue);
};

示例：COM 事件

// EventHandling_COM_Event.cpp
// compile with: /c
#define _ATL_ATTRIBUTES 1
#include <atlbase.h>
#include <atlcom.h>

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

[ dual, uuid("00000000-0000-0000-0000-000000000002") ]
__interface IEventSource {
   [id(1)] HRESULT MyEvent();
};
[ coclass, uuid("00000000-0000-0000-0000-000000000003"),  event_source(com) ]
class CSource : public IEventSource {
public:
   __event __interface IEventSource;
   HRESULT FireEvent() {
      __raise MyEvent();
      return S_OK;
   }
};

另请参阅

关键字
事件处理
event_source
event_receiver
__hook
__unhook
__raise