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ū)ν环椒ǖ囊?;如果不指定類名稱,則 __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)不能包含事件。
相關(guān)文章
C++的get()函數(shù)與getline()函數(shù)使用詳解
這篇文章主要介紹了C++的get()函數(shù)與getline()函數(shù)使用詳解,是C++入門學(xué)習(xí)中的基礎(chǔ)知識,需要的朋友可以參考下2015-09-09c語言實現(xiàn)足球比賽積分統(tǒng)計系統(tǒng)
這篇文章主要為大家詳細介紹了c語言實現(xiàn)足球比賽積分統(tǒng)計系統(tǒng),文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下2022-05-05c++實現(xiàn)對輸入數(shù)組進行快速排序的示例(推薦)
下面小編就為大家?guī)硪黄猚++實現(xiàn)對輸入數(shù)組進行快速排序的示例(推薦)。小編覺得挺不錯的,現(xiàn)在就分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2017-06-06