Contrôles invisibles : utilisation des composants

Article
08/21/2008

Mise à jour : novembre 2007

Vous pouvez utiliser plusieurs composants dans les applications Windows Forms pour vous aider à effectuer une tâche particulière. Par exemple, vous pouvez utiliser un composant ErrorProvider pour valider des données entrées dans un contrôle Windows Forms. Les composants sont disponibles dans la Boîte à outils et vous pouvez les faire glisser vers un Windows Form de la même manière que les contrôles. Toutefois, la différence principale entre les contrôles et les composants provient du fait que les composants n'ont en général pas d'interface utilisateur. Ils ne sont pas visibles sur le formulaire.

Lorsque vous faites glisser un composant vers un formulaire, il est ajouté à la barre d'état des composants c'est-à-dire la zone en bas du mode Design. Une nombreuse partie des composants disponibles sont répertoriés sous l'onglet Composants de la Boîte à outils. Il existe d'autres composants sous d'autres onglets, tels que les onglets Boîtes de dialogue, Données et Menus et barres d'outils.

Dans cette leçon, vous ajoutez des contrôles TextBox à un Windows Form. Vous allez ensuite utiliser un composant ErrorProvider pour valider des données entrées dans l'une des zones de texte. Vous pouvez écrire du code dans le gestionnaire d'événements Validating d'un contrôle, tel que TextBox, pour vous assurer que les données entrées par l'utilisateur sont valides. Si les données ne sont pas valides, une icône d'erreur apparaît à côté du contrôle. Il est possible de consulter l'erreur en positionnant le pointeur de la souris sur l'icône d'erreur.

Essayez !

Pour valider des données à l'aide d'un composant ErrorProvider

Dans le menu Fichier, cliquez sur Nouveau projet.

La boîte de dialogue Nouveau projet s'affiche.
Cliquez sur Application Windows Forms, puis sur OK.

Un nouveau projet Windows Forms s'ouvre.
Ajoutez un contrôle Label au formulaire, en conservant le nom par défaut Label1, puis modifiez la propriété Text du contrôle par Name.
Ajoutez un contrôle TextBox à côté du contrôle Label, en conservant le nom par défaut TextBox1.
Ajoutez un autre contrôle Label au formulaire, en conservant le nom par défaut Label2, puis modifiez la propriété Text du contrôle par Age.
Ajoutez un contrôle TextBox à côté de ce contrôle Label, en conservant le nom par défaut TextBox2.
Faites glisser un composant ErrorProvider de l'onglet Composants de la Boîte à outils vers le formulaire en conservant le nom par défaut ErrorProvider1.

Le composant est ajouté à la barre d'état des composants.
Pour ouvrir l'éditeur de code, cliquez avec le bouton droit de la souris sur le formulaire, puis cliquez sur Afficher le code.
Dans la liste déroulante Nom de la classe de l'éditeur de code, cliquez sur TextBox2.
Dans la liste déroulante Nom de la méthode, cliquez sur Validation pour créer le gestionnaire d'événements.
Ajoutez le code suivant au gestionnaire d'événements TextBox2_Validating. Ce code vérifie si les données entrées dans TextBox2 correspondent à des valeurs numériques. Dans le cas contraire, le code définit le message d'erreur du composant ErrorProvider.
```
If Not IsNumeric(TextBox2.Text) Then
    ErrorProvider1.SetError(TextBox2, _
        "You must enter a numeric value.")
Else
    ErrorProvider1.SetError(TextBox2, "")
End If
```
Appuyez sur F5 pour exécuter le programme.
Lorsque le formulaire apparaît, tapez votre nom dans la première zone de texte, votre couleur favorite dans la deuxième zone de texte, puis appuyez sur la touche TAB.

Une icône d'erreur apparaît à côté de TextBox2.
Positionnez le pointeur de la souris sur l'icône d'erreur pour afficher le texte d'erreur.
Tapez votre âge en chiffres dans la zone de texte, puis appuyez sur la touche TAB.

L'icône d'erreur disparaît.