__event

아티클
02/21/2013

이벤트를 선언합니다.

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

설명

__event 키워드는 메서드 선언, 인터페이스 선언, 또는 데이터 멤버 선언에 적용할 수 있습니다.하지만 __event 키워드를 사용하여 중첩된 클래스의 멤버를 한정할 수 없습니다.

이벤트 소스와 수신자가 네이티브 C++, COM 또는 관리되는 (.NET Framework)인지 여부에 따라 다음 구문을 이벤트로 사용할 수 있습니다.

네이티브 C++	COM	Managed(.NET Framework)
방법	—	메서드
—	인터페이스	—
—	—	데이터 멤버

이벤트 메서드로 처리기 메서드를 연결하는 이벤트 수신기에 있는 __hook을 사용합니다.__event 키워드를 사용하여 이벤트를 만든 후, 이벤트가 호출될 때 이후에 해당 이벤트에 후크된 모든 이벤트 처리기가 호출됩니다.

__event 메서드 선언은 정의를 가질 수 없습니다. 정의는 암시적으로 생성되므로 이벤트 메서드는 일반 메서드인 것처럼 호출할 수 있습니다.

[!참고]

템플릿 기반 클래스 또는 구조체에 event를 포함시킬 수 없습니다.

네이티브 이벤트

네이티브 이벤트는 메서드입니다.반환 형식은 일반적으로 HRESULT 또는 void이지만 enum을 포함하는 모든 정수 계열 형식이 될 수 있습니다.이벤트가 정수 표시 형식을 사용하고, 이벤트 처리기가 0이 아닌 값을 표시하면, 이 경우 발생한 이벤트가 다른 대리자의 호출합니다.

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

샘플 코드는 Native C++로 이벤트 처리@@를 참조하십시오.

COM 이벤트

COM 이벤트는 인터페이스입니다.이벤트 소스 인터페이스에 있는 메서드의 매개 변수는 in에 있는 매개 변수이어야 하지만 out 매개 변수 멀티 캐스팅 하는 경우에 유용 하지 않으므로 엄격하게 적용되지는 않습니다.out 매개 변수를 사용하는 경우 수준 1 경고가 발행됩니다.

반환 형식은 일반적으로 HRESULT 또는 void이지만 enum을 포함하는 모든 정수 계열 형식이 될 수 있습니다.이벤트가 정수 표시 형식을 사용하고, 이벤트 처리기가 0이 아닌 값을 표시하면, 이것은 오류 조건으로,이 경우 발생한 이벤트가 다른 대리자의 호출을 중단합니다.컴파일러는 이벤트 소스 인터페이스를 생성된 IDL에서 자동으로 source로 표시합니다.

__Interface 키워드는 항상 COM 이벤트 소스에 대해 __event 후에 필요합니다.

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

샘플 코드는 COM에서 이벤트 처리를 참조하십시오.

관리되는 이벤트

새 구문의 이벤트 코딩에 대한 자세한 내용은 이벤트 (Visual C++)를 참조하십시오.

관리되는 이벤트는 데이터 멤버 또는 메서드입니다.이벤트와 함께 사용하면, 대리자의 반환 형식은 공용 언어 사양에 부합해야 합니다.이벤트 처리기의 반환 형식은 대리자의 반환 형식이 일치해야 합니다.대리자에 대한 자세한 내용은 __delegate를 참조하십시오.관리되는 이벤트가 데이터 멤버인 경우 그 형식은 대리자에 대한 포인터이어야 합니다.

.NET Framework에서 데이터 멤버가 메서드 자체인 것처럼 취급할 수 있습니다(즉, 해당 대리자의 Invoke 메서드).관리되는 이벤트 데이터 멤버를 선언하는 데 대리자 형식을 미리 정의해야 합니다.반면, 관리되는 이벤트 메서드는 해당 관리되는 대리자(이미 정의되지 않은 경우)를 암시적으로 정의합니다.예를 들어, 다음과 같이 OnClick과 같은 이벤트 값을 이벤트로 선언할 수 있습니다.

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

관리되는 이벤트를 암시적으로 선언할 때 이벤트 처리기를 추가하거나 제거하는 경우에 호출되는 추가 및 제거 접근자를 지정할 수 있습니다.클래스 외부에서 이벤트를 호출(발생)하는 메서드를 정의할 수도 있습니다.

예제: 네이티브 이벤트

// 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);
};

이벤트에 특성을 적용하면 특성이 생성된 메서드나 생성된 대리자의 Invoke 메서드 중 하나에 적용됨을 지정할 수 있습니다.기본값(event:)의 경우 특성을 이벤트에 적용해야 합니다.

// 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();
};