快捷導(dǎo)航

C++事件處理中event與raise關(guān)鍵字的用法講解

更新時間：2016年01月26日 15:42:44 投稿：goldensun

這篇文章主要介紹了C++事件處理中__event與__raise關(guān)鍵字的用法,是C++入門學習中的基礎(chǔ)知識,需要的朋友可以參考下

__event
聲明事件。
語法

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

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

2016126151821045.png (426×192)

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

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

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

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

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

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

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

// 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)用于事件時，您可以指定特性應(yīng)用于生成的方法還是生成的委托的 Invoke 方法。默認值 (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
強調(diào)一個事件的調(diào)用站點。

__raise method-declarator;

備注
在托管代碼中，事件只能從定義它的類中引發(fā)。
說明
模板類或結(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
}

您可能感興趣的文章: