C++事件处理中的__hook与__unhook用法详解
__hook
__hook将处理程序方法与事件关联。
语法
long__hook( &SourceClass::EventMethod, source, &ReceiverClass::HandlerMethod [,receiver=this] ); long__hook( interface, source );参数
&SourceClass::EventMethod
指向要将事件处理程序方法挂钩到的事件方法的指针:
本机C++事件:SourceClass是事件源类,EventMethod是事件。
COM事件:SourceClass是事件源接口,EventMethod是其方法之一。
托管事件:SourceClass是事件源类,EventMethod是事件。
interface
要挂钩到receiver的接口名称,仅适用于COM事件接收器,其中event_receiver特性的layout_dependent参数为true。
source
指向事件源的实例的指针。根据event_receiver中指定的代码type,source可为下列项之一:
本机事件源对象指针。
基于IUnknown的指针(COM源)。
托管对象指针(针对托管事件)。
&ReceiverClass::HandlerMethod
指向要挂钩到事件的事件处理程序方法的指针。处理程序将指定为类的方法或对同一方法的引用;如果不指定类名称,则__hook假定该类是从中调用它的类。
本机C++事件:ReceiverClass是事件接收器类,HandlerMethod是处理程序。
COM事件:ReceiverClass是事件接收器接口,HandlerMethod是其处理程序之一。
托管事件:ReceiverClass是事件接收器类,HandlerMethod是处理程序。
receiver(可选)
指向事件接收器类的实例的指针。如果不指定接收器,则默认为在其中调用__hook的接收器类或结构。
用法
可以在事件接收器类的外部的任何函数范围(包括main)中使用。
备注
请使用事件接收器中的内部函数__hook将处理程序方法与事件方法关联或挂钩。随后会在源引发指定事件时调用指定的事件处理程序。可以将多个处理程序挂钩到单个事件,或将多个事件挂钩到单个处理程序。
__hook有两种形式。大多数情况下,可以使用第一种(四个形参)形式,具体而言,就是针对其中的event_receiver特性的layout_dependent参数是false的COM事件接收器。
在这些情况下,当在其中一个方法上激发事件前,不需要在接口中挂钩所有方法;只需挂钩处理事件的方法。可以只对layout_dependent=true的COM事件接收器使用第二种(二个形参)形式的__hook。
__hook将返回一个长值。非零返回值表示发生了错误(托管事件引发了异常)。
编译器将检查是否存在事件以及事件签名是否与委托签名一致。
除COM事件外,可以在事件接收器的外部调用__hook和__unhook。
使用__hook的替代方法是使用+=运算符。
注意
模板类或结构不能包含事件。
__unhook
取消处理程序方法与事件的关联。
语法
long__unhook( &SourceClass::EventMethod, source, &ReceiverClass::HandlerMethod [,receiver=this] ); long__unhook( interface, source ); long__unhook( source );
参数
&SourceClass::EventMethod
指向从中解除挂钩事件处理程序方法的事件方法的指针:
本机C++事件:SourceClass是事件源类,EventMethod是事件。
COM事件:SourceClass是事件源接口,EventMethod是其方法之一。
托管事件:SourceClass是事件源类,EventMethod是事件。
interface
将从receiver中解除挂钩的接口名称,仅适用于COM事件接收器,其中event_receiver特性的layout_dependent参数为true。
source
指向事件源的实例的指针。根据event_receiver中指定的代码type,source可为下列项之一:
本机事件源对象指针。
基于IUnknown的指针(COM源)。
托管对象指针(针对托管事件)。
&ReceiverClass::HandlerMethod
指向要从事件中解除挂钩的事件处理程序方法的指针。处理程序将指定为类的方法或对同一方法的引用;如果不指定类名称,则__unhook假定该类是从中调用它的类。
本机C++事件:ReceiverClass是事件接收器类,HandlerMethod是处理程序。
COM事件:ReceiverClass是事件接收器接口,HandlerMethod是其处理程序之一。
托管事件:ReceiverClass是事件接收器类,HandlerMethod是处理程序。
receiver(可选)
指向事件接收器类的实例的指针。如果不指定接收器,则默认为在其中调用__unhook的接收器类或结构。
用法
可以在事件接收器类的外部的任何函数范围(包括main)中使用。
备注
使用事件接收器中的内部函数__unhook取消处理程序方法与事件方法的关联或从事件方法“解除挂钩”处理程序方法。
__unhook有三种形式。在大多数情况下,可以使用第一种(four-argument)形式。只能为COM事件接收器使用__unhook的第二种(two-argument)形式;这将解除挂钩整个事件接口。可以使用第三种(one-argument)形式从指定的源中解除挂钩所有委托。
非零返回值指示已发生错误(托管事件将引发异常)。
如果对尚未挂钩的事件和事件处理程序调用__unhook,它将不起作用。
在编译时,编译器将验证事件是否存在,并利用指定的处理程序执行参数类型检查。
除COM事件外,可以在事件接收器的外部调用__hook和__unhook。
作为使用__unhook的替代方式,可以使用-=运算符。
有关新语法中编码托管事件的信息,请参阅event(C++组件扩展)。
注意
模板类或结构不能包含事件。