Présentation détaillée : ajout des propriétés avec les valeurs nommées

Article
08/21/2008

Mise à jour : novembre 2007

Dans cette leçon, vous apprendrez à ajouter une propriété qui contient une liste de valeurs à votre contrôle utilisateur.

Valeurs nommées

Les propriétés que vous avez ajoutées jusqu'à présent à votre contrôle utilisateur prennent toutes des valeurs de chaîne, mais les propriétés peuvent être de plusieurs types. Vous pouvez vouloir fournir une liste de valeurs prédéfinies parmi lesquelles effectuer une sélection, comme la propriété SizeMode du contrôle PictureBox que vous avez définie dans une leçon antérieure.

Supposons, par exemple, que vous souhaitiez créer une propriété pour le NamesControl qui vous permet de choisir la façon dont l'étiquette FullName affiche le nom. Vous aurez besoin d'une liste des valeurs dans laquelle effectuer un choix : le prénom en premier, le nom en premier, uniquement le prénom et le nom, et ainsi de suite.

Dans Visual Basic, vous pouvez créer une énumération qui contient les valeurs souhaitées. « Énumération » désigne une « liste numérotée ». Visual Basic stocke les nombres pour que vous puissiez faire référence aux valeurs par leur nom. Une énumération se déclare à l'aide du mot clé Enum, comme dans l'exemple suivant.

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

Une fois l'énumération créée, vous pouvez l'utiliser comme n'importe quel autre type de données. Pour ajouter une propriété qui affiche une liste de valeurs, déclarez d'abord une variable du même type de données qu'Enum, puis une propriété du même type. Au moment de la conception, une liste des valeurs contenues dans l'énumération s'affiche dans la fenêtre Propriétés.

Essayez !

Pour ajouter une propriété qui affiche une liste de valeurs

Ouvrez le projet NamesUserControl que vous avez créé dans la leçon précédente. Si vous ne l'aviez pas enregistré, vous devez d'abord revenir à la leçon précédente, Ajout de code à votre contrôle utilisateur et suivre les procédures de celle-ci.
Dans l'Explorateur de solutions, sélectionnez NamesControl.vb, puis dans le menu Affichage, sélectionnez Code.

Dans l'éditeur de code, ajoutez le code suivant pour créer une énumération.

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

Ajoutez le code suivant pour ajouter une nouvelle propriété.

Private DisplayStyleList As Display 
Property DisplayStyle() As Display
    Get
        Return DisplayStyleList
    End Get
    Set(ByVal value As Display)
        DisplayStyleList = value
    End Set
End Property

Supprimez le code existant dans le gestionnaire d'événements FirstName_TextChanged et remplacez-le par le code suivant.

Select Case DisplayStyleList
    Case Display.FirstLast
        FullName.Text = FirstName.Text & " " & LastName.Text
    Case Display.FirstMiddleLast
        FullName.Text = FirstName.Text & " " & MiddleName.Text & " " & LastName.Text
    Case Display.LastFirst
        FullName.Text = LastName.Text & ", " & FirstName.Text
    Case Display.LastFirstMiddle
        FullName.Text = LastName.Text & ", " & FirstName.Text & " " & MiddleName.Text
End Select

Appuyez sur F5 pour exécuter le programme. Entrez vos premier et deuxième prénoms ainsi que votre nom dans les trois zones de texte.
Dans le Conteneur de test UserControl, faites défiler la grille Propriétés vers le bas et sélectionnez la propriété DisplayStyle. Sélectionnez une valeur différente puis changez le texte dans l'une des zones de texte. Voyez comment il affecte l'étiquette.
Dans le menu Fichier, cliquez sur Enregistrer tout pour enregistrer votre travail.

Étapes suivantes

Dans cette leçon, vous avez appris à utiliser une énumération pour créer une propriété avec une liste de valeurs. Dans la leçon suivante, vous apprendrez à tester votre contrôle utilisateur en le plaçant sur un formulaire.

Leçon suivante : Test de votre contrôle utilisateur