Noms, Assistant Ajout de propriété

Utilisez cet Assistant pour ajouter une propriété à une interface.

• Type de propriété
  Définit le type de propriété que vous ajoutez.Pour les dispinterfaces MFC, indiquez le type de votre choix ou sélectionnez-en un dans la liste prédéfinie.Si vous indiquez une implémentation stock d'une propriété, Type de propriété est défini sur le type de stock et n'est pas disponible à des fins de modification.

• Nom de la propriété
  Définit le nom de la propriété.Pour les dispinterfaces MFC associées aux contrôles ActiveX, vous pouvez indiquer le nom de votre choix ou sélectionner un nom de propriété stock dans la liste prédéfinie.Si vous indiquez un nom de propriété de votre choix, le type d'implémentation Stock n'est pas disponible.Pour obtenir une description des propriétés de la liste, consultez Propriétés stock.

  Type d'interface	Description
  Interface double ATL, interface personnalisée et interface locale personnalisée	Indiquez un nom de propriété.
  Dispinterface MFC, dispinterface du contrôle ActiveX MFC	Indiquez un nom de propriété ou sélectionnez une propriété stock dans la liste.Si vous sélectionnez une propriété dans la liste, la valeur appropriée apparaît dans la zone Type de propriété.Vous pouvez modifier ce type selon la sélection que vous avez effectuée sous Type d'implémentation.

• Type de retour
  Interfaces ATL uniquement.Définit le type de retour de la propriété.Pour les interfaces doubles, HRESULT est toujours le type de retour et cette zone n'est pas disponible.Pour les interfaces personnalisées, vous pouvez sélectionner un type de retour dans la liste.HRESULT est encore recommandé, parce qu'il offre un moyen standard de retourner des erreurs.

• Nom de la variable
  Dispinterfaces MFC uniquement.Disponible uniquement si vous spécifiez Variable membre sous Type d'implémentation.Définit le nom de la variable membre à laquelle la propriété est associée.Par défaut, le nom de la variable est défini sur m_PropertyName.Vous pouvez modifier ce nom.

• Fonction de notification
  Dispinterfaces MFC uniquement.Disponible uniquement si vous spécifiez Variable membre sous Type d'implémentation.Définit le nom de la fonction de notification appelée en cas de modification de la propriété.Par défaut, le nom de la fonction de notification est défini sur OnPropertyNameChanged.Vous pouvez modifier ce nom.

• Fonction Get
  Dispinterfaces MFC uniquement.Disponible uniquement si vous spécifiez Méthodes Get/Set sous Type d'implémentation.Définit le nom de la fonction pour lire la propriété.Par défaut, le nom de la fonction Get est défini sur GetPropertyName.Vous pouvez modifier ce nom.Si vous supprimez le nom, la fonction GetNotSupported est insérée dans la table de dispatch de l'interface.La fonction GetPropertyName spécifie que la propriété est accessible en lecture.

• Fonction Set
  Dispinterfaces MFC uniquement.Disponible uniquement si vous spécifiez Méthodes Get/Set sous Type d'implémentation.Définit le nom de la fonction pour écrire la propriété.Par défaut, le nom de la fonction Set est défini sur SetPropertyName.Vous pouvez modifier ce nom.Si vous supprimez le nom, la fonction SetNotSupported est insérée dans la table de dispatch de l'interface.La fonction SetPropertyName spécifie que la propriété est accessible en écriture.

• Type d'implémentation
  Dispinterfaces MFC uniquement.Spécifie la méthode d'implémentation de la propriété ajoutée.

  Type d'implémentation	Description
  Boursier	Spécifie une implémentation stock pour la propriété sélectionnée dans Nom de la propriété.Valeur par défaut.Pour plus d'informations, consultez Propriétés stock. Si vous spécifiez Stock, puis Type de propriété, Type de paramètre et Nom de paramètre apparaissent estompés.
  Variable membre	Spécifie que la propriété est ajoutée comme variable membre.Vous pouvez ajouter des propriétés personnalisées ou la plupart des propriétés stock comme variables membres.Vous ne pouvez pas spécifier Variable membre pour les propriétés Légende, hWnd et Texte. Fournit les noms par défaut sous Nom de la variable et Fonction de notification.Vous pouvez modifier ce nom.
  Méthodes Get/Set	Spécifie que la propriété est ajoutée en tant que fonctions GetPropertyName et SetPropertyName, par défaut.Ces noms apparaissent sous Fonction Get et Fonction Set . Vous pouvez modifier le Type de propriété par défaut, qui passe une valeur pour la fonction Get.Vous pouvez spécifier des paramètres pour les fonctions Get et Set.

• Fonction Get
  Interfaces ATL uniquement.Définit la propriété comme étant accessible en lecture ; en d'autres termes, cette fonction crée la méthode Get pour extraire cette propriété de l'objet.Vous devez sélectionner Get, Put ou les deux.

• Fonction Put
  Interfaces ATL uniquement.Définit la propriété comme étant accessible en écriture ; en d'autres termes, cette fonction crée la méthode Put pour définir cette propriété de l'objet.Vous devez sélectionner Get, Put ou les deux.Si vous sélectionnez cette option, vous pouvez choisir l'une des méthodes décrites ci-après pour implémenter la méthode :

  Option	Description
  PropPut	La fonction PropPut retourne une copie de l'objet.Cette option par défaut est la manière la plus courante de rendre cette propriété accessible en écriture.
  PropPutRef	La fonction PropPutRef retourne une référence à l'objet et non la copie de l'objet lui-même.Utilisez de préférence cette option pour les objets, tels que les structures ou les tableaux volumineux, qui peuvent créer une charge de travail importante à l'initialisation.

• Attributs de paramètres
  Interfaces ATL uniquement.Définit si le paramètre spécifié dans Nom du paramètre est in, out, les deux ou aucun.

  Option	Description
  in	Indique que le paramètre est passé de la procédure appelante à la procédure appelée.
  out	Indique que le paramètre du pointeur est retourné de la procédure appelée à la procédure appelante (du serveur au client).

• Type de paramètre
  Définit le type de données du paramètre.Sélectionnez le type dans la liste.

• Nom du paramètre
  Définit le nom d'un paramètre que vous ajoutez à la propriété, si celle-ci comporte des paramètres.Lorsque vous cliquez sur Ajouter, le nom du paramètre s'affiche dans la Liste de paramètres.

• Liste de paramètres
  Affiche la liste des attributs à ajouter à la propriété.Chaque élément de la liste comprend le nom du paramètre, le type du paramètre et les attributs.Utilisez Ajouter et Supprimer pour mettre à jour la liste.

• Ajouter
  Ajoute le paramètre spécifié dans les zones Nom du paramètre et Type du paramètre à la zone Liste de paramètres.Pour ajouter un paramètre à la liste, cliquez sur Ajouter.

• Supprimer
  Supprime le paramètre que vous sélectionnez dans la zone Liste de paramètres.

• Propriété par défaut
  Dispinterface MFC uniquement.Définit cette propriété comme valeur par défaut de l'interface.Une interface ne peut avoir qu'une propriété par défaut ; une fois la propriété par défaut spécifiée, cette zone n'est pas disponible pour toutes les autres propriétés que vous ajoutez à l'interface.

Voir aussi

Tâches

Ajout d'une propriété

Implémentation d'une interface

Référence

Attributs IDL, Assistant Ajout de propriété