Attribut event_source

Crée une source d'événement.

Remarque

Les attributs d’événement en C++ natifs sont incompatibles avec la norme C++. Ils ne sont pas compilés lorsque vous spécifiez le /permissive- mode de conformité.

Syntaxe

[ event_source(type, optimize=[speed | size], decorate=[true | false]) ]

Paramètres

type
Une énumération de l’une des valeurs suivantes :

• native pour le code C/C++ non managé (par défaut pour les classes non managées).

• com pour le code COM. Utilisez coclass quand type=com. Cette valeur nécessite que vous incluiez les fichiers d’en-tête suivants :

  #define _ATL_ATTRIBUTES
  #include <atlbase.h>
  #include <atlcom.h>
  

optimize
Lorsque le type est native, vous pouvez spécifier optimize=size, pour indiquer qu’il y a 4 octets de stockage (minimum) pour tous les événements d’une classe ou optimize=speed (la valeur par défaut) pour indiquer qu’il y a 4 * (# d’événements) octets de stockage.

decorate
Lorsque le type est native, vous pouvez spécifier decorate=false, pour indiquer que le nom développé dans le fichier fusionné (.mrg) ne doit pas inclure le nom de classe englobant. /Fx vous permet de générer des .mrg fichiers. decorate=false, qui est la valeur par défaut, génère des noms de types complets dans le fichier fusionné.

Notes

L’attribut event_source C++ spécifie que la classe ou la structure à laquelle elle est appliquée sera une source d’événement.

event_sourceest utilisé conjointement avec l’attribut event_receiver et le __event mot clé. Permet event_receiver de créer des récepteurs d’événements. Utilisez __event sur les méthodes dans la source d’événements pour spécifier ces méthodes en tant qu’événements.

Remarque

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

Spécifications

Contexte d’attribut	Value
S’applique à	class, struct
Renouvelable	Non
Attributs requis	coclass quand type=com
Attributs non valides	Aucun

Pour plus d'informations, consultez Contextes d'attribut.

Voir aussi

Attributs du compilateur
event_receiver
__event
__hook
__unhook
Attributs de classe