Ajouter une variable membre

Vous pouvez ajouter une variable membre à une classe à l’aide d’Affichage de classes. Les variables membres peuvent être utilisées pour l’échange et la validation de données, ou elles peuvent être génériques. L’Assistant Ajout de variable membre est conçu pour prélever les informations importantes et les utiliser pour insérer des éléments dans vos fichiers sources aux emplacements appropriés. Vous pouvez ajouter une variable membre à partir de l’Éditeur de boîtes de dialogue dans Affichage des ressources, ou à partir d’Affichage de classes.

Pour ajouter une variable membre pour un contrôle de boîte de dialogue dans l’affichage des ressources à l’aide de l’Assistant Ajout de variable membre

1. Dans l’affichage des ressources, développez le nœud du projet et le nœud Boîte de dialogue pour afficher la liste des boîtes de dialogue du projet.

2. Double-cliquez sur la boîte de dialogue à laquelle vous souhaitez ajouter la variable membre pour l’ouvrir dans l’Éditeur de boîtes de dialogue.

3. Dans la boîte de dialogue affichée dans l’Éditeur de boîtes de dialogue, cliquez avec le bouton droit sur le contrôle auquel vous souhaitez ajouter la variable membre.

4. Dans le menu contextuel, choisissez Ajouter une variable pour afficher l’Assistant Ajout de variable membre.

   Notes

   Une valeur par défaut vous est déjà proposée dans ID de contrôle.

5. Indiquez les informations nécessaires dans les zones appropriées de l’Assistant. Pour plus d’informations, consultez Contrôles de boîtes de dialogue et types de variables.

6. Sélectionnez Terminer pour ajouter la définition et le code d’implémentation au projet et fermer l’Assistant.

Pour ajouter une variable membre à partir d’Affichage de classes à l’aide de l’Assistant Ajout de variable membre

1. Dans l’affichage de classes, développez le nœud du projet afin d’afficher ses classes.

2. Cliquez avec le bouton droit sur la classe à laquelle vous souhaitez ajouter une variable.

3. Dans le menu contextuel, choisissez Ajouter, puis Ajouter une variable pour afficher l’Assistant Ajout de variable membre.

4. Indiquez les informations nécessaires dans les zones appropriées de l’Assistant. Pour plus d’informations, consultez Assistant Ajout de variable membre.

5. Sélectionnez Terminer pour ajouter la définition et le code d’implémentation au projet et fermer l’Assistant.

Contenu de cette section

• Assistant Ajout de variable membre
• Contrôles de boîtes de dialogue et types de variables

Assistant Ajout de variable membre

Cet Assistant ajoute une déclaration de variable membre au fichier d’en-tête. En fonction des options, elle peut ajouter le code au fichier .cpp. Une fois que vous avez ajouté la variable membre avec l’Assistant, vous pouvez modifier le code dans l’environnement de développement.

• y accéder

  Définit l’accès à la variable membre. Les modificateurs d’accès sont des mots clés spécifiant l’accès des autres classes à la variable membre. Pour plus d’informations sur la spécification de l’accès, consultez Contrôle d’accès aux membres. Le niveau d’accès à la variable membre est défini par défaut sur public.

  • public
  • protected
  • private

• Type de variable

  Définit le type de retour pour la variable de membre que vous ajoutez.

  • Si vous ajoutez une variable membre qui n’est pas un contrôle de boîte de dialogue, sélectionnez dans la liste des types disponibles.

    Pour plus d’informations sur les types, consultez Types fondamentaux.

    • char
    • double
    • float
    • int
    • long
    • short
    • unsigned char
    • unsigned int
    • unsigned long

  • Si vous ajoutez une variable membre pour un contrôle de boîte de dialogue, cette zone est renseignée avec le type de l’objet retourné pour un contrôle ou une valeur. Si vous sélectionnez Contrôle, Type de variable spécifie la classe de base du contrôle que vous sélectionnez dans la zone ID de contrôle. Si le contrôle de boîte de dialogue peut contenir une valeur et si vous sélectionnez Valeur, Type de variable spécifie le type approprié pour la valeur que le contrôle peut contenir. Pour plus d’informations, consultez Contrôles de boîtes de dialogue et types de variables.

    Cette valeur dépend de la sélection dans ID de contrôle et ne peut pas être modifiée.

• Nom de la variable

  Définit le nom de la variable membre que vous ajoutez. Les variables membres commencent généralement par la chaîne d’identification m_, qui vous est fournie par défaut.

• Variable de contrôle

  Indique que la variable membre gère un contrôle dans une boîte de dialogue avec prise en charge de l’échange de données et de la validation des données. Pour plus d’informations, consultez DoDataExchange. Cette option est disponible seulement pour les variables membres ajoutées à des classes dérivées de CDialog. Cochez cette case pour activer les options ID de contrôle et Type de contrôle.

• ID du contrôle

  Définit l’ID pour la variable de contrôle que vous ajoutez. Dans la liste, sélectionnez l’ID pour le type de contrôle pour lequel vous ajoutez la variable membre. La liste est active seulement quand la case Variable de contrôle est cochée, et elle est limité aux ID des contrôles déjà ajoutés à la boîte de dialogue. Par exemple, pour le bouton OK standard, l’ID de contrôle est IDOK.

  Option	Description
  Contrôle	Cette option est définie par défaut pour le type de contrôle. Elle gère le contrôle lui-même, et non l’état ou le contenu du contrôle (comme vous pourriez vouloir le faire avec une zone de liste, une zone de liste modifiable ou une zone d’édition).
  Valeur	Cette option est disponible pour les types de contrôle qui peuvent contenir une valeur ou afficher un état, par exemple une zone d’édition ou une case à cocher. Elle est également disponible pour les types de contrôle pour lesquels vous pouvez gérer la plage, le contenu ou l’état. Pour plus d’informations, consultez Contrôles de boîtes de dialogue et types de variables.

• Catégorie

  Spécifie si la variable est basée sur un type de contrôle ou sur la valeur du contrôle.

• Type de contrôle

  Définit le type de contrôle ajouté. Vous ne pouvez pas changer cette case. Par exemple, un bouton a le type de contrôle BUTTON et une zone de liste modifiable a le type de contrôle COMBOBOX. Pour plus d’informations, consultez Contrôles de boîtes de dialogue et types de variables.

• Nombre maximal de caractères

  Disponible seulement quand Type de Variable est défini sur CString. Indique le nombre maximal de caractères que le contrôle peut contenir.

• Valeur minimale

  Disponible uniquement quand le type de variable est BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency ou CTime. Indique la plus petite valeur acceptable pour une plage de mise à l’échelle ou de dates.

• Valeur maximale

  Disponible uniquement quand le type de variable est BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency ou CTime. Indique la plus haute valeur acceptable pour une plage de mise à l’échelle ou de dates.

• Fichier .h

  Pour les contrôles ActiveX, dont les variables membres nécessitent une classe wrapper. Définit le nom du fichier d’en-tête pour ajouter la déclaration de classe.

• Fichier .cpp

  Pour les contrôles ActiveX, dont les variables membres nécessitent une classe wrapper. Définit le nom du fichier d’implémentation pour ajouter la définition de classe.

• Commentaire

  Fournit un commentaire dans le fichier d’en-tête pour la variable membre.

Contrôles de boîtes de dialogue et types de variables

Vous pouvez utiliser l’Assistant Ajout de variable membre pour ajouter une variable membre à un contrôle de boîte de dialogue créé à l’aide de MFC. Le type de contrôle pour lequel vous ajoutez la variable membre détermine les options qui apparaissent dans la boîte de dialogue.

Le tableau suivant décrit tous les types de contrôles de boîtes de dialogue pris en charge dans MFC et dans l’Éditeur de boîtes de dialogue. Il montre également leurs types et valeurs disponibles.