Partager via


Noms, Assistant Ajout de propriété

Mise à jour : novembre 2007

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 reste recommandé, parce qu'il offre un moyen standard pour 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é. Il s'agit de la 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é