Attributs par utilisation

Cette rubrique répertorie les attributs en fonction des éléments de langage C++ auxquels ils s’appliquent.

Si un attribut précède un élément qui n’est pas dans l’étendue de l’attribut, le bloc d’attribut est traité comme un commentaire.

Attribut	Description
Attributs de module	S’applique à l’attribut du module .
Attributs d’interface	S’applique au mot clé __interface C++.
Attributs de classe	S’applique au mot clé C++.
Attributs de méthode	S’applique aux méthodes d’une classe, d’une coclasse ou d’une interface.
Attributs de paramètres	S’applique aux paramètres d’une méthode dans une classe ou une interface.
Attributs de membre de données	S’applique aux membres de données d’une classe, d’une coclasse ou d’une interface.
Attributs Typedef, Enum, Union et Struct	S’applique aux mots clés C++.
Attributs de tableau	S’applique aux tableaux ou SAFEARRAYaux s.
Attributs autonomes	Fonctionne plus comme une ligne de code, mais ne fonctionne pas sur un mot clé C++. Les instructions d’attribut autonome nécessitent un point-virgule à la fin de la ligne.
Attributs personnalisés	Permet à l’utilisateur d’étendre les métadonnées.

Attributs de module

L’attribut suivant ne peut être appliqué qu’à l’attribut de module .

Attribut	Description
helpstringdll	Spécifie le nom de la DLL à utiliser pour effectuer la recherche de chaîne de document (localisation).

Attributs d’interface

Les attributs suivants s’appliquent au mot clé C++ de l’interface (ou __interface).

Attribut	Description
async_uuid	Spécifie l’UUID qui dirige le compilateur MIDL pour définir des versions synchrones et asynchrones d’une interface COM.
custom	Vous permet de définir vos propres attributs.
dispinterface	Place une interface dans le fichier .idl comme interface de dispatch.
dual	Place une interface dans le fichier .idl en tant qu’interface double.
export	Provoque l’emplacement d’une structure de données dans le fichier .idl.
helpcontext	Spécifie un ID de contexte qui permet à l’utilisateur d’afficher des informations sur cet élément dans le fichier d’aide.
helpfile	Définit le nom du fichier d’aide pour une bibliothèque de types.
helpstring	Spécifie une chaîne de caractères qui est utilisée pour décrire l’élément auquel elle s’applique.
helpstringcontext	Spécifie l’ID d’une rubrique d’aide dans un fichier .hlp ou .chm.
helpstringdll	Spécifie le nom de la DLL à utiliser pour effectuer la recherche de chaîne de document (localisation).
hidden	Indique que l’élément existe mais ne doit pas être affiché dans un navigateur orienté utilisateur.
library_block	Place une construction à l’intérieur du bloc de bibliothèque du fichier .idl.
local	Vous permet d’utiliser le compilateur MIDL comme générateur d’en-tête lorsqu’il est utilisé dans l’en-tête d’interface. Lorsqu’elle est utilisée dans une fonction individuelle, désigne une procédure locale pour laquelle aucun stub n’est généré.
nonextensible	Spécifie que l’implémentation IDispatch inclut uniquement les propriétés et méthodes répertoriées dans la description de l’interface et ne peut pas être étendue avec des membres supplémentaires au moment de l’exécution. Cet attribut n’est valide que sur une interface double .
odl	Identifie une interface en tant qu’interface ODL (Object Description Language).
object	Identifie une interface personnalisée.
oleautomation	Indique qu’une interface est compatible avec Automation.
pointer_default	Spécifie l’attribut de pointeur par défaut pour tous les pointeurs, à l’exception des pointeurs de niveau supérieur qui apparaissent dans les listes de paramètres.
ptr	Désigne un pointeur comme pointeur complet.
restricted	Désigne les membres de la bibliothèque qui ne peuvent pas être appelés arbitrairement.
uuid	Fournit l’ID unique de la bibliothèque

Vous devez observer ces règles pour définir une interface :

• La convention d’appel par défaut est __stdcall.

• Un GUID est fourni pour vous si vous n’en fournissez pas un.

• Aucune méthode surchargée n’est autorisée.

Lorsque vous ne spécifiez pas l’attribut uuid et que vous utilisez le même nom d’interface dans différents projets d’attributs, le même GUID est généré.

Voir aussi

Attributs C++ pour COM et .NET
Attributs par groupe
Référence alphabétique des attributs