event_receiver

Article
06/09/2015

crée un récepteur d'événements (récepteur).

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

Paramètres

type
une énumération d'une des valeurs suivantes :
- native pour du code non managé C/C++ (valeur par défaut pour les classes natives).
- com pour le code de COM. cette valeur requiert que vous incluez les fichiers d'en-tête suivants :
```
   #define _ATL_ATTRIBUTES
   #include <atlbase.h>
   #include <atlcom.h>
```
layout_dependent
Spécifiez layout_dependent uniquement si type=COM. layout_dependent est une valeur booléenne :
- true signifie que la signature du récepteur de délégués dans l'événement doit correspondre exactement à ceux auxquels il est dans le source lié. Les noms des gestionnaires de récepteur d'événements doivent correspondre à ceux spécifiés dans l'interface appropriée de l'événement. vous devez utiliser coclasse si layout_dependent est true. il est légèrement plus efficace de spécifier true.
- false (valeur par défaut) signifie que la convention d'appel et la classe de stockage (virtuel, statique, etc.) ne doivent pas correspondre à la méthode d'événement et les gestionnaires ; ni effectuent le gestionnaire que les noms doivent correspondre aux noms des méthodes d'interface de l'événement.

Notes

L'attribut d' event_receiver C++ spécifie que la classe ou la structure dans laquelle il est appliqué est un récepteur d'événements, à l'aide de le modèle d'événement unifié par Visual C++.

event_receiver est utilisé avec l'attribut d' event_source et les mots clés de __hook et de __unhook . utilisation event_source de créer des sources d'événement. Utilisez __hook dans les méthodes d'un récepteur d'événements pour associer (« raccordement ») des méthodes de récepteur d'événements aux événements d'une source d'événement. utilisation __unhook de les dissocier.

layout_dependent n'est spécifié pour les récepteurs d'événements COM (type=COM). la valeur par défaut pour layout_dependent est false.

Notes

Une classe ou structure modélisée ne peut pas contenir d'événements.