__event
聲明事件。
語(yǔ)法

   __event 
   method-declarator
   ;
__event __interface interface-specifier;
__event member-declarator;

備注
關(guān)鍵字 __event 可應(yīng)用于方法聲明、接口聲明或數(shù)據(jù)成員聲明。但是，不能使用 __event 關(guān)鍵字限定嵌套類(lèi)的成員。
根據(jù)您的事件源和接收器是本機(jī) C++、COM 還是托管 (.NET Framework)，您可使用下列構(gòu)造作為事件：

在事件接收器中使用 __hook 可將處理程序方法與事件方法關(guān)聯(lián)。請(qǐng)注意，使用 __event 關(guān)鍵字創(chuàng)建一個(gè)事件之后，將在調(diào)用此事件時(shí)調(diào)用后來(lái)掛鉤到它的所有事件處理程序。
__event 方法聲明不能具有定義；定義是隱式生成的，因此可將事件方法當(dāng)做任何普通方法一樣調(diào)用。
System_CAPS_note注意
模板類(lèi)或結(jié)構(gòu)不能包含事件。
本機(jī)事件
本機(jī)事件是方法。返回類(lèi)型通常是 HRESULT 或 void，但可以是任何整型（包括 enum）。當(dāng)事件使用整數(shù)返回類(lèi)型時(shí)，如果事件處理程序返回非零值，則會(huì)定義錯(cuò)誤條件，在這種情況下，引發(fā)的事件將調(diào)用其他委托。

// Examples of native C++ events:
__event void OnDblClick();
__event HRESULT OnClick(int* b, char* s);

有關(guān)代碼示例，請(qǐng)參閱本機(jī) C++ 中的事件處理。
COM 事件
COM 事件是接口。事件源接口中的方法的參數(shù)應(yīng)為 in 參數(shù)（但這不是強(qiáng)制要求的），因?yàn)?out 參數(shù)在多播時(shí)無(wú)用。如果使用 out 參數(shù)，則將發(fā)出 1 級(jí)警告。
返回類(lèi)型通常是 HRESULT 或 void，但可以是任何整型（包括 enum）。當(dāng)事件使用整數(shù)返回類(lèi)型并且事件處理程序返回非零值時(shí)，這是錯(cuò)誤情況，此時(shí)引發(fā)的事件將中止對(duì)其他委托的調(diào)用。請(qǐng)注意，編譯器會(huì)自動(dòng)將一個(gè)事件源接口標(biāo)記為生成的 IDL 中的源。
COM 事件源的 __event 之后始終需要 __interface 關(guān)鍵字。

// Example of a COM event:
__event __interface IEvent1;

有關(guān)代碼示例，請(qǐng)參閱 COM 中的事件處理。
托管事件
有關(guān)新語(yǔ)法中的編碼事件的信息，請(qǐng)參閱event（C++ 組件擴(kuò)展）。
托管事件是數(shù)據(jù)成員或方法。當(dāng)與事件一起使用時(shí)，委托的返回類(lèi)型必須符合公共語(yǔ)言規(guī)范。事件處理程序的返回類(lèi)型必須與委托的返回類(lèi)型匹配。有關(guān)委托的詳細(xì)信息，請(qǐng)參閱 __delegate。如果托管事件是數(shù)據(jù)成員，則其類(lèi)型必須是指向委托的指針。
在 .NET Framework 中，您可以將數(shù)據(jù)成員視為方法本身（即，其對(duì)應(yīng)委托的 Invoke 方法）。您必須預(yù)定義用于聲明托管事件數(shù)據(jù)成員的委托類(lèi)型。相反，如果尚未定義對(duì)應(yīng)的托管委托，則托管事件方法將隱式定義它。例如，您可以將事件值（如 OnClick）聲明為下面所示的事件：

// Examples of managed events:
__event ClickEventHandler* OnClick; // data member as event
__event void OnClick(String* s); // method as event

隱式聲明托管事件時(shí)，您可以指定添加或移除添加或移除事件處理程序時(shí)將調(diào)用的 add 和 remove 訪問(wèn)器。您還可以定義從類(lèi)外部調(diào)用（引發(fā)）事件的方法。
示例：本機(jī)事件

// EventHandling_Native_Event.cpp
// compile with: /c
[event_source(native)]
class CSource {
public:
  __event void MyEvent(int nValue);
};

示例：COM 事件

// EventHandling_COM_Event.cpp
// compile with: /c
#define _ATL_ATTRIBUTES 1
#include <atlbase.h>
#include <atlcom.h>

[ module(dll, name="EventSource", uuid="6E46B59E-89C3-4c15-A6D8-B8A1CEC98830") ];

[ dual, uuid("00000000-0000-0000-0000-000000000002") ]
__interface IEventSource {
  [id(1)] HRESULT MyEvent();
};
 [ coclass, uuid("00000000-0000-0000-0000-000000000003"), event_source(com) ]
class CSource : public IEventSource {
public:
  __event __interface IEventSource;
  HRESULT FireEvent() {
   __raise MyEvent();
   return S_OK;
  }
};

示例：托管事件

// EventHandling_Managed_Event.cpp
// compile with: /clr:oldSyntax /c
using namespace System;
[event_source(managed)]
public __gc class CPSource {

public:
  __event void MyEvent(Int16 nValue);
};

將特性應(yīng)用于事件時(shí)，您可以指定特性應(yīng)用于生成的方法還是生成的委托的 Invoke 方法。默認(rèn)值 (event:) 用于將特性應(yīng)用于事件。

// EventHandling_Managed_Event_2.cpp
// compile with: /clr:oldSyntax /c
using namespace System;
[attribute(All, AllowMultiple=true)]
public __gc class Attr {};

public __delegate void D();

public __gc class X {
public:
  [method:Attr] __event D* E;
  [returnvalue:Attr] __event void noE();
};

__raise
強(qiáng)調(diào)一個(gè)事件的調(diào)用站點(diǎn)。

__raise method-declarator;

備注
在托管代碼中，事件只能從定義它的類(lèi)中引發(fā)。
說(shuō)明
模板類(lèi)或結(jié)構(gòu)不能包含事件。
示例

 // EventHandlingRef_raise.cpp
struct E {
  __event void func1();
  void func1(int) {}

  void func2() {}

  void b() {
   __raise func1();
   __raise func1(1); // C3745: 'int Event::bar(int)': 
             // only an event can be 'raised'
   __raise func2();  // C3745
  }
};

int main() {
  E e;
  __raise e.func1();
  __raise e.func1(1); // C3745
  __raise e.func2();  // C3745
}

最新評(píng)論