__hook
__hook將處理程序方法與事件關(guān)聯(lián)。
語(yǔ)法
|
1
2
3
4
5
6
7
8
9
10
|
long __hook( &SourceClass::EventMethod, source, &ReceiverClass::HandlerMethod [, receiver = this]);long __hook( interface, source); |
參數(shù)
&SourceClass::EventMethod
指向要將事件處理程序方法掛鉤到的事件方法的指針：
本機(jī) C++ 事件：SourceClass 是事件源類，EventMethod 是事件。
COM 事件：SourceClass 是事件源接口，EventMethod 是其方法之一。
托管事件：SourceClass 是事件源類，EventMethod 是事件。
interface
要掛鉤到 receiver 的接口名稱，僅適用于 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ū)⒅付轭惖姆椒ɑ驅(qū)ν环椒ǖ囊?；如果不指定類名稱，則 __hook 假定該類是從中調(diào)用它的類。
本機(jī) C++ 事件：ReceiverClass 是事件接收器類，HandlerMethod 是處理程序。
COM 事件：ReceiverClass 是事件接收器接口，HandlerMethod 是其處理程序之一。
托管事件：ReceiverClass 是事件接收器類，HandlerMethod 是處理程序。
receiver（可選）
指向事件接收器類的實(shí)例的指針。如果不指定接收器，則默認(rèn)為在其中調(diào)用 __hook 的接收器類或結(jié)構(gòu)。
用法
可以在事件接收器類的外部的任何函數(shù)范圍（包括 main）中使用。
備注
請(qǐng)使用事件接收器中的內(nèi)部函數(shù) __hook 將處理程序方法與事件方法關(guān)聯(lián)或掛鉤。隨后會(huì)在源引發(fā)指定事件時(shí)調(diào)用指定的事件處理程序?？梢詫⒍鄠€(gè)處理程序掛鉤到單個(gè)事件，或?qū)⒍鄠€(gè)事件掛鉤到單個(gè)處理程序。
__hook 有兩種形式。大多數(shù)情況下，可以使用第一種（四個(gè)形參）形式，具體而言，就是針對(duì)其中的 event_receiver 特性的 layout_dependent 參數(shù)是 false 的 COM 事件接收器。
在這些情況下，當(dāng)在其中一個(gè)方法上激發(fā)事件前，不需要在接口中掛鉤所有方法；只需掛鉤處理事件的方法。可以只對(duì) layout_dependent=true 的 COM 事件接收器使用第二種（二個(gè)形參）形式的 __hook。
__hook 將返回一個(gè)長(zhǎng)值。非零返回值表示發(fā)生了錯(cuò)誤（托管事件引發(fā)了異常）。
編譯器將檢查是否存在事件以及事件簽名是否與委托簽名一致。
除 COM 事件外，可以在事件接收器的外部調(diào)用 __hook 和 __unhook。
使用 __hook 的替代方法是使用 += 運(yùn)算符。
注意
模板類或結(jié)構(gòu)不能包含事件。
__unhook
取消處理程序方法與事件的關(guān)聯(lián)。
語(yǔ)法
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
long __unhook( &SourceClass::EventMethod, source, &ReceiverClass::HandlerMethod [, receiver = this] );long __unhook( interface, source);long __unhook( source ); |
參數(shù)
&SourceClass::EventMethod
指向從中解除掛鉤事件處理程序方法的事件方法的指針：
本機(jī) C++ 事件：SourceClass 是事件源類，EventMethod 是事件。
COM 事件：SourceClass 是事件源接口，EventMethod 是其方法之一。
托管事件：SourceClass 是事件源類，EventMethod 是事件。
interface
將從 receiver 中解除掛鉤的接口名稱，僅適用于 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ū)⒅付轭惖姆椒ɑ驅(qū)ν环椒ǖ囊茫蝗绻恢付惷Q，則 __unhook 假定該類是從中調(diào)用它的類。
本機(jī) C++ 事件：ReceiverClass 是事件接收器類，HandlerMethod 是處理程序。
COM 事件：ReceiverClass 是事件接收器接口，HandlerMethod 是其處理程序之一。
托管事件：ReceiverClass 是事件接收器類，HandlerMethod 是處理程序。
receiver（可選）
指向事件接收器類的實(shí)例的指針。如果不指定接收器，則默認(rèn)為在其中調(diào)用 __unhook 的接收器類或結(jié)構(gòu)。
用法
可以在事件接收器類的外部的任何函數(shù)范圍（包括 main）中使用。
備注
使用事件接收器中的內(nèi)部函數(shù) __unhook 取消處理程序方法與事件方法的關(guān)聯(lián)或從事件方法“解除掛鉤”處理程序方法。
__unhook 有三種形式。在大多數(shù)情況下，可以使用第一種 (four-argument) 形式。只能為 COM 事件接收器使用 __unhook 的第二種 (two-argument) 形式；這將解除掛鉤整個(gè)事件接口?？梢允褂玫谌N (one-argument) 形式從指定的源中解除掛鉤所有委托。
非零返回值指示已發(fā)生錯(cuò)誤（托管事件將引發(fā)異常）。
如果對(duì)尚未掛鉤的事件和事件處理程序調(diào)用 __unhook，它將不起作用。
在編譯時(shí)，編譯器將驗(yàn)證事件是否存在，并利用指定的處理程序執(zhí)行參數(shù)類型檢查。
除 COM 事件外，可以在事件接收器的外部調(diào)用 __hook 和 __unhook。
作為使用 __unhook 的替代方式，可以使用 -= 運(yùn)算符。
有關(guān)新語(yǔ)法中編碼托管事件的信息，請(qǐng)參閱event（C++ 組件擴(kuò)展）。
注意
模板類或結(jié)構(gòu)不能包含事件。
