当前位置: 首页 > 编程笔记 >

C++事件处理中的__hook与__unhook用法详解

陶高峻
2023-03-14
本文向大家介绍C++事件处理中的__hook与__unhook用法详解,包括了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++ 组件扩展)。
注意
模板类或结构不能包含事件。

 

 类似资料:
  • 本文向大家介绍C++事件处理中__event与__raise关键字的用法讲解,包括了C++事件处理中__event与__raise关键字的用法讲解的使用技巧和注意事项,需要的朋友参考一下 __event 声明事件。 语法 备注 关键字 __event 可应用于方法声明、接口声明或数据成员声明。但是,不能使用 __event 关键字限定嵌套类的成员。 根据您的事件源和接收器是本机 C++、COM 还

  • 本文向大家介绍详解javascript中的事件处理,包括了详解javascript中的事件处理的使用技巧和注意事项,需要的朋友参考一下 一.事件传播机制   客户端JavaScript程序(就是浏览器啦)采用了异步事件驱动编程模型。当文档、浏览器、元素或与之相关的对象发生某些有趣的事情时,Web浏览器就会产生事件(event)。如果JavaScript应用程序关注特定类型的事件,那么它可以注册当这

  • 本文向大家介绍详解JavaScript中的事件流和事件处理程序,包括了详解JavaScript中的事件流和事件处理程序的使用技巧和注意事项,需要的朋友参考一下 事件流:分两种,IE的是 事件冒泡流 ,事件开始时从最具体的元素接收,逐级向上传播到较为不具体的节点(Element -> Document)。与之相反的是 Netscape 的 事件捕获流 。 DOM2级事件规定事件流包括三个阶段:事件捕

  • 本文向大家介绍mysql事务处理用法与实例代码详解,包括了mysql事务处理用法与实例代码详解的使用技巧和注意事项,需要的朋友参考一下 MySQL的事务支持不是绑定在MySQL服务器本身,而是与存储引擎相关 1.MyISAM:不支持事务,用于只读程序提高性能 2.InnoDB:支持ACID事务、行级锁、并发 3.Berkeley DB:支持事务 一个事务是一个连续的一组数据库操作,就好像它是一个单

  • 本文向大家介绍javascript表单事件处理方法详解,包括了javascript表单事件处理方法详解的使用技巧和注意事项,需要的朋友参考一下 本文实例为大家分享了javascript处理表单事件的常用方法,供大家参考,具体内容如下 1、访问表单对象的常用方法: ①:根据<form>元素的id属性; var myform=document.getElementById("myformid"); 

  • 本文向大家介绍C#处理Access中事务的方法,包括了C#处理Access中事务的方法的使用技巧和注意事项,需要的朋友参考一下 本文实例讲述了C#处理Access中事务的方法。分享给大家供大家参考。具体如下: Access不能像SQL server一样直接执行多条语句,但是把多条语句绑成事务还是可以一起执行的. 所谓事务,就是把多件事情当做一件事情来处理。也就是大家同在一条船上! 由一个事务来完成