Share via


event_receiver

Stellt einen Ereignisempfänger (Senke).

[ event_receiver(
   type 
   [, layout_dependent=false] 
) ]

Parameter

  • type
    Eine Enumeration mit einem der folgenden Werte:

    • native für nicht verwaltete C/C++-Code (Standard für systemeigene Klassen).

    • com für COM-Code.Dieser Wert setzt voraus, dass Sie die folgenden Headerdateien umfassen:

         #define _ATL_ATTRIBUTES
         #include <atlbase.h>
         #include <atlcom.h>
      
  • layout_dependent
    Geben Sie nur bei type= layout_dependentCOMan.ist ein boolescher Wertlayout_dependent :

    • true bedeutet, dass die Signatur des Empfängers der Delegat im Ereignisprotokoll die genau übereinstimmen müssen, auf die sie gehakte Quelle in den Ereignisdaten.Das Ereignis empfänger-Handler Namen müssen die Namen übereinstimmen, die in der relevanten Quellschnittstelle des Ereignisses angegeben werden.Sie müssen coclass verwenden, wenn layout_dependent, sind true.Es ist etwas effizienter, trueanzugeben.

    • false (Standard) gibt an, dass die Aufrufkonvention und Speicherklasse (virtual statisch und andere) die Ereignismethode und die Handler nicht übereinstimmen müssen. Name der Handler dennoch ausführen, die Ereignisquellen schnittstellenmethoden Namen übereinstimmt.

Hinweise

Das Attribut event_receiver C++ gibt an, dass die Klasse oder die Struktur, auf die es angewendet wird, ein Ereignisempfänger sind, mithilfe des einheitlichen Ereignismodells von Visual C++.

event_receiver wird mit dem event_source-Attribut und der __hook und __unhook Schlüsselwörtern verwendet.Verwendung event_source , Ereignisquellen zu erstellen.Verwenden Sie __hook innerhalb der Methoden eines Ereignisempfängers, um („Ereignisempfänger“) Hook Methoden Ereignisse einer Ereignisquelle zuzuordnen.Verwendung __unhook , sie zu trennen.

layout_dependent wird nur für COM-Ereignisempfänger (type=COM) angegeben.Der Standardwert für layout_dependent ist false.

HinweisHinweis

Eine von einer Vorlage gebildete Klasse oder Struktur kann keine Ereignisse enthalten.

Anforderungen

Attribut-Kontext

Betrifft

Klasse, struct

Wiederholbar

Nein

Erforderliche Attribute

coclass wenn layout_dependent=true

Ungültige Attribute

None

Weitere Informationen finden Sie unter Attribut-Kontexte.

Siehe auch

Referenz

event_source

__event

__hook

__unhook

Weitere Ressourcen

Compiler-Attribute

Klassen-Attribute

Attributes Samples