Ajouter une propriété IDL MFC

L’Assistant Ajouter une propriété MFC IDL ajoute une propriété à une interface IDL (Interface Definition Library) définie dans votre projet MFC (Microsoft Framework Class).

Pour utiliser cet Assistant, vous devez être dans un projet MFC, un projet ActiveX ou un projet ATL qui prend en charge MFC. Par exemple, si vous avez un projet de contrôle Microsoft ActiveX, vous pouvez utiliser la procédure suivante pour ajouter une propriété à une interface IDL dans la solution.

Ajouter une propriété IDL MFC à votre interface

1. Dans le menu Affichage, sélectionnez Affichage de classes.

2. Dans le volet Affichage de classes, cliquez avec le bouton droit sur le nom de l’interface à laquelle vous souhaitez ajouter la propriété.

   Remarque

   Vous pouvez également ajouter des propriétés aux dispinterfaces qui, tant que le projet n’est pas attribué, sont imbriquées dans le nœud de la bibliothèque.

3. Dans le menu contextuel, choisissez Ajouter une>propriété.

4. Dans l’Assistant Ajouter une propriété MFC IDL, fournissez les informations permettant de créer la propriété.

5. Sélectionnez OK pour ajouter la propriété.

Pour les dispinterfaces MFC :

• Si vous sélectionnez la variable Member comme type d’implémentation, une méthode et une variable sont ajoutées à la classe qui l’implémente.
• Si vous sélectionnez Méthodes Get/Set comme type d’implémentation, deux méthodes sont ajoutées à la classe qui l’implémente.

Liste des éléments d’interface utilisateur

La section suivante décrit l’Assistant Ajouter une propriété MFC IDL :

• 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 votre propre nom de propriété, le type d’implémentation Stock n’est pas disponible.

  Pour plus d’informations sur une description des propriétés boursières de la liste, consultez les propriétés boursières.

  Type d'interface	Options de nom de propriété
  Interface double ATL, interface personnalisée et interface personnalisée locale	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, en fonction de la sélection du type d’implémentation.

• 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 fournissez une implémentation de stock d’une propriété, le type de propriété est le type de stock et ne peut pas être modifié.

• Nom de la variable

  Définit le nom de la variable membre à laquelle la propriété est associée.

  Par défaut, le nom de la variable est m_PropertyName. Vous pouvez modifier ce nom.

  Ce champ n’est visible que pour les dispinterfaces MFC et si vous spécifiez la variable Membre sous type d’implémentation.

• Fonction de notification

  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 OnPropertyNameChanged. Vous pouvez modifier ce nom.

  Ce champ n’est visible que pour les dispinterfaces MFC et si vous spécifiez la variable Membre sous type d’implémentation.

• Get, fonction

  Définit le nom de la fonction pour obtenir la propriété.

  Par défaut, le nom de la fonction Get est 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.

  Ce champ est visible uniquement pour les dispinterfaces MFC et si vous spécifiez des méthodes Get/Set sous Type d’implémentation.

• Fonction Set

  Définit le nom de la fonction pour définir la propriété.

  Par défaut, le nom de la fonction Set est 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.

  Ce champ est visible uniquement pour les dispinterfaces MFC et si vous spécifiez des méthodes Get/Set sous Type d’implémentation.

• Type d’implémentation

  Spécifie comment implémenter la propriété ajoutée.

  Disponible uniquement pour les dispinterfaces MFC.

  Type d’implémentation	Description
  Boursier	Spécifie une implémentation par défaut pour la propriété sélectionnée dans le nom de la propriété. 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 du paramètre apparaissent estompés.
  Variable membre	Ajoute la propriété en tant que variable membre. Vous pouvez ajouter des propriétés personnalisées ou la plupart des propriétés stock comme variables membres. Fournit les noms par défaut sous Nom de la variable et Fonction de notification. Vous pouvez modifier ce nom. Vous ne pouvez pas spécifier la variable Member pour les propriétés ou TexthWndles Captionpropriétés.
  Méthodes Get/Set	Spécifie que la propriété est ajoutée en tant que Getfonctions PropertyName et SetPropertyName par défaut. Ces noms apparaissent sous Get, fonction et Fonction Set. Vous pouvez modifier la valeur par défaut de Type de propriété, qui transmet une valeur pour la fonction Get. Vous pouvez spécifier des paramètres pour les fonctions Get et Set.

• Propriété par défaut

  Définit la propriété comme valeur par défaut pour l’interface.

  Une interface ne peut avoir qu’une seule propriété par défaut.

  Une fois que vous avez spécifié la propriété par défaut, cette case activée box n’est pas disponible pour toutes les autres propriétés que vous ajoutez à l’interface. Disponible uniquement pour une dispinterface MFC.

• Paramètres

  Affiche les paramètres de la méthode et ses types.

• +

  Ajoute un paramètre. Dans Paramètres, tapez le type de paramètre et le nom, puis choisissez OK. Par exemple, int x

• x

  Supprime le paramètre sélectionné de la liste Paramètres.

• Icône de crayon

  Modifie le paramètre sélectionné.

• id

  Définit l’ID numérique qui identifie la propriété.

  Cette option n’est pas disponible pour les propriétés des interfaces personnalisées. Pour plus d’informations, consultez id la référence MIDL.

• helpcontext

  Spécifie un ID de contexte qui permet à l’utilisateur de voir des informations sur cette propriété dans le fichier d’aide.

  Pour plus d’informations, consultez helpcontext la référence MIDL.

• helpstring

  Spécifie une chaîne de caractères qui est utilisée pour décrire l’élément auquel elle s’applique. Par défaut, il s’agit du nom de propertypropriété.

  Pour plus d’informations, consultez helpstring la référence MIDL.

Propriétés stock

Si vous ajoutez une propriété à une dispinterface MFC, vous pouvez choisir l’une des propriétés boursières suivantes dans la liste déroulante Nom de la propriété :

Nom de la propriété	Description
Appearance	Retourne ou définit une valeur qui détermine l’apparence du contrôle. La propriété Appearance du contrôle peut inclure ou omettre les effets 3D. Il s’agit d’une propriété ambiante en lecture/écriture.
BackColor	Retourne ou définit la propriété BackColor ambiante du contrôle avec une couleur de palette (RVB) ou une couleur système prédéfinie. Par défaut, sa valeur correspond à la couleur de premier plan du conteneur du contrôle. Il s’agit d’une propriété ambiante en lecture/écriture.
BorderStyle	Retourne ou définit le style de bordure d’un contrôle. Il s’agit d’une propriété en lecture/écriture.
Caption	Retourne ou définit la propriété Caption du contrôle. La légende est le titre de la fenêtre. Caption n’a pas de type d’implémentation Variable membre.
Enabled	Retourne ou définit la propriété Enabled du contrôle. Un contrôle activé peut répondre aux événements générés par l’utilisateur.
Font	Retourne ou définit la police ambiante du contrôle. Null si le contrôle n’a pas de police.
ForeColor	Retourne ou définit la propriété ForeColor ambiante du contrôle.
hWnd	Retourne ou définit la propriété hWnd du contrôle. N’a pas de type d’implémentation de variable membre.
ReadyState	Retourne ou définit la propriété ReadyState du contrôle. Un contrôle peut être non initialisé, initialisé, en cours de chargement, interactif ou complet. Pour plus d’informations, consultez READYSTATE dans le kit SDK Internet.
Text	Retourne ou définit le texte présent dans un contrôle. N’a pas de type d’implémentation de variable membre.

Voir aussi

Ajouter une propriété

Ajouter une propriété IDL