__hook
__hook將處理程序方法與事件關(guān)聯(lián)。
語(yǔ)法
long __hook( &SourceClass::EventMethod, source, &ReceiverClass::HandlerMethod [, receiver = this]);long __hook( interface, source);參數(shù)
__unhook
取消處理程序方法與事件的關(guān)聯(lián)。
語(yǔ)法
long __unhook( &SourceClass::EventMethod, source, &ReceiverClass::HandlerMethod [, receiver = this] );long __unhook( interface, source);long __unhook( source );
參數(shù)
&SourceClass::EventMethod
指向從中解除掛鉤事件處理程序方法的事件方法的指針:
本機(jī) C++ 事件:SourceClass 是事件源類(lèi),EventMethod 是事件。
COM 事件:SourceClass 是事件源接口,EventMethod 是其方法之一。
托管事件:SourceClass 是事件源類(lèi),EventMethod 是事件。
interface
將從 receiver 中解除掛鉤的接口名稱(chēng),僅適用于 COM 事件接收器,其中 event_receiver 特性的 layout_dependent 參數(shù)為 true。
source
指向事件源的實(shí)例的指針。根據(jù) event_receiver 中指定的代碼 type,source 可為下列項(xiàng)之一:
本機(jī)事件源對(duì)象指針。
基于 IUnknown 的指針(COM 源)。
托管對(duì)象指針(針對(duì)托管事件)。
&ReceiverClass::HandlerMethod
指向要從事件中解除掛鉤的事件處理程序方法的指針。處理程序?qū)⒅付轭?lèi)的方法或?qū)ν环椒ǖ囊茫蝗绻恢付?lèi)名稱(chēng),則 __unhook 假定該類(lèi)是從中調(diào)用它的類(lèi)。
本機(jī) C++ 事件:ReceiverClass 是事件接收器類(lèi),HandlerMethod 是處理程序。
COM 事件:ReceiverClass 是事件接收器接口,HandlerMethod 是其處理程序之一。
托管事件:ReceiverClass 是事件接收器類(lèi),HandlerMethod 是處理程序。
receiver(可選)
指向事件接收器類(lèi)的實(shí)例的指針。如果不指定接收器,則默認(rèn)為在其中調(diào)用 __unhook 的接收器類(lèi)或結(jié)構(gòu)。
用法
可以在事件接收器類(lèi)的外部的任何函數(shù)范圍(包括 main)中使用。
備注
使用事件接收器中的內(nèi)部函數(shù) __unhook 取消處理程序方法與事件方法的關(guān)聯(lián)或從事件方法“解除掛鉤”處理程序方法。
__unhook 有三種形式。在大多數(shù)情況下,可以使用第一種 (four-argument) 形式。只能為 COM 事件接收器使用 __unhook 的第二種 (two-argument) 形式;這將解除掛鉤整個(gè)事件接口。可以使用第三種 (one-argument) 形式從指定的源中解除掛鉤所有委托。
非零返回值指示已發(fā)生錯(cuò)誤(托管事件將引發(fā)異常)。
如果對(duì)尚未掛鉤的事件和事件處理程序調(diào)用 __unhook,它將不起作用。
在編譯時(shí),編譯器將驗(yàn)證事件是否存在,并利用指定的處理程序執(zhí)行參數(shù)類(lèi)型檢查。
除 COM 事件外,可以在事件接收器的外部調(diào)用 __hook 和 __unhook。
作為使用 __unhook 的替代方式,可以使用 -= 運(yùn)算符。
有關(guān)新語(yǔ)法中編碼托管事件的信息,請(qǐng)參閱event(C++ 組件擴(kuò)展)。
注意
模板類(lèi)或結(jié)構(gòu)不能包含事件。
新聞熱點(diǎn)
疑難解答
網(wǎng)友關(guān)注