您的位置：首页 > 编程技术 > C语言  >  C++事件处理中的__hook与__unhook用法详解

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

 更新时间：2020年4月25日 17:36  点击：1456

__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++ 组件扩展）。
注意
模板类或结构不能包含事件。

 

[!--infotagslink--]

相关文章

  • C++ STL标准库std::vector的使用详解

    vector是表示可以改变大小的数组的序列容器，本文主要介绍了C++STL标准库std::vector的使用详解，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下...2022-03-06

  • C++中取余运算的实现

    这篇文章主要介绍了C++中取余运算的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2021-02-23

  • 详解C++ string常用截取字符串方法

    这篇文章主要介绍了C++ string常用截取字符串方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2020-04-25

  • C++调用C#的DLL程序实现方法

    本文通过例子，讲述了C++调用C#的DLL程序的方法，作出了以下总结，下面就让我们一起来学习吧。...2020-06-25

  • C++中四种加密算法之AES源代码

    本篇文章主要介绍了C++中四种加密算法之AES源代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。...2020-04-25

  • C#事件(event)使用方法详解

    本文给大家介绍了在C#中，事件(event)的概念和使用方法，文章适合一些初学者学习，主要讲解了一些概念和一些代码案例。...2020-06-25

  • C++ 整数拆分方法详解

    整数拆分，指把一个整数分解成若干个整数的和。本文重点给大家介绍C++ 整数拆分方法详解，非常不错，感兴趣的朋友一起学习吧...2020-04-25

  • jQuery事件绑定用法详解(附bind和live的区别)

    这篇文章主要介绍了jQuery事件绑定用法,结合实例形式较为详细的分析了jQuery事件绑定的实现原理与相关注意事项,并附带了相关绑定方法的使用说明,重点介绍了bind和live的区别,需要的朋友可以参考下...2016-01-21

  • C++中 Sort函数详细解析

    这篇文章主要介绍了C++中Sort函数详细解析，sort函数是algorithm库下的一个函数，sort函数是不稳定的，即大小相同的元素在排序后相对顺序可能发生改变...2022-08-18

  • C++万能库头文件在vs中的安装步骤(图文)

    这篇文章主要介绍了C++万能库头文件在vs中的安装步骤(图文)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2021-02-23

  • 详解C++ bitset用法

    这篇文章主要介绍了C++ bitset用法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2020-04-25

  • 浅谈C++中的string 类型占几个字节

    本篇文章小编并不是为大家讲解string类型的用法，而是讲解我个人比较好奇的问题，就是string 类型占几个字节...2020-04-25

  • easyUI下拉列表点击事件使用方法

    这篇文章主要为大家详细介绍了easyUI下拉列表点击事件的使用方法，具有一定的参考价值，感兴趣的小伙伴们可以参考一下...2017-05-22

  • C++ Eigen库计算矩阵特征值及特征向量

    这篇文章主要为大家详细介绍了C++ Eigen库计算矩阵特征值及特征向量，具有一定的参考价值，感兴趣的小伙伴们可以参考一下...2020-04-25

  • C#事件实例详解

    这篇文章主要介绍了C#事件实例详解的相关资料,需要的朋友可以参考下...2020-06-25

  • C++ pair的用法实例详解

    这篇文章主要介绍了C++ pair的用法实例详解的相关资料,需要的朋友可以参考下...2020-04-25

  • VSCode C++多文件编译的简单使用方法

    这篇文章主要介绍了VSCode C++多文件编译的简单使用方法,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下...2021-03-29

  • jQuery Mobile 触摸事件实例

    这篇文章主要演示了5个jQuery Mobile 触摸事件实例,需要的朋友可以参考下。...2016-06-12

  • C++中的循环引用

    虽然C++11引入了智能指针的，但是开发人员在与内存的斗争问题上并没有解放，如果我门实用不当仍然有内存泄漏问题，其中智能指针的循环引用缺陷是最大的问题。下面通过实例代码给大家介绍c++中的循环引用，一起看看吧...2020-04-25

  • C++随机点名生成器实例代码（老师们的福音！）

    这篇文章主要给大家介绍了关于C++随机点名生成器的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2020-04-25