C++事件處理中的__hook與__unhook用法詳解
__hook
__hook將處理程序方法與事件關(guān)聯(lián)。
語法
long __hook( &SourceClass::EventMethod, source, &ReceiverClass::HandlerMethod [, receiver = this] ); long __hook( interface, source );參數(shù)
&SourceClass::EventMethod
指向要將事件處理程序方法掛鉤到的事件方法的指針:
本機 C++ 事件:SourceClass 是事件源類,EventMethod 是事件。
COM 事件:SourceClass 是事件源接口,EventMethod 是其方法之一。
托管事件:SourceClass 是事件源類,EventMethod 是事件。
interface
要掛鉤到 receiver 的接口名稱,僅適用于 COM 事件接收器,其中 event_receiver 特性的 layout_dependent 參數(shù)為 true。
source
指向事件源的實例的指針。根據(jù) event_receiver 中指定的代碼 type,source 可為下列項之一:
本機事件源對象指針。
基于 IUnknown 的指針(COM 源)。
托管對象指針(針對托管事件)。
&ReceiverClass::HandlerMethod
指向要掛鉤到事件的事件處理程序方法的指針。處理程序?qū)⒅付轭惖姆椒ɑ驅(qū)ν环椒ǖ囊?;如果不指定類名稱,則 __hook 假定該類是從中調(diào)用它的類。
本機 C++ 事件:ReceiverClass 是事件接收器類,HandlerMethod 是處理程序。
COM 事件:ReceiverClass 是事件接收器接口,HandlerMethod 是其處理程序之一。
托管事件:ReceiverClass 是事件接收器類,HandlerMethod 是處理程序。
receiver(可選)
指向事件接收器類的實例的指針。如果不指定接收器,則默認為在其中調(diào)用 __hook 的接收器類或結(jié)構(gòu)。
用法
可以在事件接收器類的外部的任何函數(shù)范圍(包括 main)中使用。
備注
請使用事件接收器中的內(nèi)部函數(shù) __hook 將處理程序方法與事件方法關(guān)聯(lián)或掛鉤。隨后會在源引發(fā)指定事件時調(diào)用指定的事件處理程序??梢詫⒍鄠€處理程序掛鉤到單個事件,或?qū)⒍鄠€事件掛鉤到單個處理程序。
__hook 有兩種形式。大多數(shù)情況下,可以使用第一種(四個形參)形式,具體而言,就是針對其中的 event_receiver 特性的 layout_dependent 參數(shù)是 false 的 COM 事件接收器。
在這些情況下,當在其中一個方法上激發(fā)事件前,不需要在接口中掛鉤所有方法;只需掛鉤處理事件的方法。可以只對 layout_dependent=true 的 COM 事件接收器使用第二種(二個形參)形式的 __hook。
__hook 將返回一個長值。非零返回值表示發(fā)生了錯誤(托管事件引發(fā)了異常)。
編譯器將檢查是否存在事件以及事件簽名是否與委托簽名一致。
除 COM 事件外,可以在事件接收器的外部調(diào)用 __hook 和 __unhook。
使用 __hook 的替代方法是使用 += 運算符。
注意
模板類或結(jié)構(gòu)不能包含事件。
__unhook
取消處理程序方法與事件的關(guān)聯(lián)。
語法
long __unhook( &SourceClass::EventMethod, source, &ReceiverClass::HandlerMethod [, receiver = this] ); long __unhook( interface, source ); long __unhook( source );
參數(shù)
&SourceClass::EventMethod
指向從中解除掛鉤事件處理程序方法的事件方法的指針:
本機 C++ 事件:SourceClass 是事件源類,EventMethod 是事件。
COM 事件:SourceClass 是事件源接口,EventMethod 是其方法之一。
托管事件:SourceClass 是事件源類,EventMethod 是事件。
interface
將從 receiver 中解除掛鉤的接口名稱,僅適用于 COM 事件接收器,其中 event_receiver 特性的 layout_dependent 參數(shù)為 true。
source
指向事件源的實例的指針。根據(jù) event_receiver 中指定的代碼 type,source 可為下列項之一:
本機事件源對象指針。
基于 IUnknown 的指針(COM 源)。
托管對象指針(針對托管事件)。
&ReceiverClass::HandlerMethod
指向要從事件中解除掛鉤的事件處理程序方法的指針。處理程序?qū)⒅付轭惖姆椒ɑ驅(qū)ν环椒ǖ囊茫蝗绻恢付惷Q,則 __unhook 假定該類是從中調(diào)用它的類。
本機 C++ 事件:ReceiverClass 是事件接收器類,HandlerMethod 是處理程序。
COM 事件:ReceiverClass 是事件接收器接口,HandlerMethod 是其處理程序之一。
托管事件:ReceiverClass 是事件接收器類,HandlerMethod 是處理程序。
receiver(可選)
指向事件接收器類的實例的指針。如果不指定接收器,則默認為在其中調(diào)用 __unhook 的接收器類或結(jié)構(gòu)。
用法
可以在事件接收器類的外部的任何函數(shù)范圍(包括 main)中使用。
備注
使用事件接收器中的內(nèi)部函數(shù) __unhook 取消處理程序方法與事件方法的關(guān)聯(lián)或從事件方法“解除掛鉤”處理程序方法。
__unhook 有三種形式。在大多數(shù)情況下,可以使用第一種 (four-argument) 形式。只能為 COM 事件接收器使用 __unhook 的第二種 (two-argument) 形式;這將解除掛鉤整個事件接口??梢允褂玫谌N (one-argument) 形式從指定的源中解除掛鉤所有委托。
非零返回值指示已發(fā)生錯誤(托管事件將引發(fā)異常)。
如果對尚未掛鉤的事件和事件處理程序調(diào)用 __unhook,它將不起作用。
在編譯時,編譯器將驗證事件是否存在,并利用指定的處理程序執(zhí)行參數(shù)類型檢查。
除 COM 事件外,可以在事件接收器的外部調(diào)用 __hook 和 __unhook。
作為使用 __unhook 的替代方式,可以使用 -= 運算符。
有關(guān)新語法中編碼托管事件的信息,請參閱event(C++ 組件擴展)。
注意
模板類或結(jié)構(gòu)不能包含事件。
欄 目:C語言
下一篇:實例講解C++編程中l(wèi)ambda表達式的使用
本文標題:C++事件處理中的__hook與__unhook用法詳解
本文地址:http://mengdiqiu.com.cn/a1/Cyuyan/2522.html
您可能感興趣的文章
- 04-02c語言沒有round函數(shù) round c語言
- 01-10深入理解C++中常見的關(guān)鍵字含義
- 01-10使用C++實現(xiàn)全排列算法的方法詳解
- 01-10c++中inline的用法分析
- 01-10用C++實現(xiàn)DBSCAN聚類算法
- 01-10全排列算法的非遞歸實現(xiàn)與遞歸實現(xiàn)的方法(C++)
- 01-10C++大數(shù)模板(推薦)
- 01-10淺談C/C++中的static與extern關(guān)鍵字的使用詳解
- 01-10深入C/C++浮點數(shù)在內(nèi)存中的存儲方式詳解
- 01-10異步http listener 完全并發(fā)處理懲罰http懇求的小例子


閱讀排行
本欄相關(guān)
- 04-02c語言函數(shù)調(diào)用后清空內(nèi)存 c語言調(diào)用
- 04-02func函數(shù)+在C語言 func函數(shù)在c語言中
- 04-02c語言的正則匹配函數(shù) c語言正則表達
- 04-02c語言用函數(shù)寫分段 用c語言表示分段
- 04-02c語言中對數(shù)函數(shù)的表達式 c語言中對
- 04-02c語言編寫函數(shù)冒泡排序 c語言冒泡排
- 04-02c語言沒有round函數(shù) round c語言
- 04-02c語言分段函數(shù)怎么求 用c語言求分段
- 04-02C語言中怎么打出三角函數(shù) c語言中怎
- 04-02c語言調(diào)用函數(shù)求fibo C語言調(diào)用函數(shù)求
隨機閱讀
- 01-11ajax實現(xiàn)頁面的局部加載
- 01-10SublimeText編譯C開發(fā)環(huán)境設(shè)置
- 08-05織夢dedecms什么時候用欄目交叉功能?
- 04-02jquery與jsp,用jquery
- 01-11Mac OSX 打開原生自帶讀寫NTFS功能(圖文
- 01-10delphi制作wav文件的方法
- 08-05dedecms(織夢)副欄目數(shù)量限制代碼修改
- 01-10C#中split用法實例總結(jié)
- 01-10使用C語言求解撲克牌的順子及n個骰子
- 08-05DEDE織夢data目錄下的sessions文件夾有什