Partager via


Attribut event_source

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

Remarque

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

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_source est 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 Valeur
S’applique à class, struct
Renouvelable Non
Attributs requis coclass quand type=com
Attributs non valides Aucune

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

Voir aussi

Attributs du compilateur
event_receiver
__event
__hook
__unhook
Attributs de classe