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