Comment : récupérer des données d'une boîte de dialogue

Article
08/21/2008

Mise à jour : novembre 2007

Les boîtes de dialogue permettent à votre programme d'interagir avec les utilisateurs et de récupérer des données entrées par les utilisateurs en vue d'une utilisation dans votre application. Vous pouvez utiliser plusieurs boîtes de dialogue intégrées dans vos applications. Pour plus d'informations, consultez Utilisation de boîtes de dialogue intégrées dans votre application. Vous pouvez également créer vos propres boîtes de dialogue.

Dans le cadre d'un développement Windows Forms, l'une des tâches courantes consiste à afficher une boîte de dialogue pour collecter des informations lorsqu'un utilisateur clique sur un bouton sur le formulaire principal d'une application. Vous pouvez en consulter un exemple dans l'environnement de développement intégré (IDE, Integrated Developement Environment) de Visual C# Express. Lorsque vous ajoutez un contrôle ListBox à un formulaire, vous pouvez cliquer sur la propriété Items dans la fenêtre Propriétés pour afficher une boîte de dialogue. Cette boîte de dialogue vous permet de taper rapidement du texte sur des lignes séparées d'une zone de texte. L'application ajoute ensuite chaque ligne de texte au contrôle ListBox lorsque vous cliquez sur OK. Si vous souhaitez que les utilisateurs puissent ajouter leurs propres éléments à une zone de liste dans votre application, vous pouvez créer votre propre boîte de dialogue d'éditeur de chaînes.

Pour créer le formulaire principal de votre application

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 formulaire nommé Form1 est ajouté au projet.
À partir de la boîte à outils, faites glisser un contrôle ListBox vers le formulaire et modifiez la propriété suivante dans la fenêtre Propriétés :

Propriété

Valeur

Modificateurs

Public
Ajoutez un contrôle Button au formulaire et modifiez les propriétés suivantes dans la fenêtre Propriétés :

Propriété

Valeur

Name

addItems

Text

Ajouter

Propriété	Valeur
Modificateurs	Public

Propriété	Valeur
Name	addItems
Text	Ajouter

Pour créer une boîte de dialogue

Dans le menu Projet, cliquez sur Ajouter un formulaire Windows, conservez le nom par défaut Form2, puis cliquez sur Ajouter.
À partir de la boîte à outils, faites glisser un contrôle Label vers le formulaire et modifiez la propriété Texte en Entrez la chaîne (une par ligne).
Ajoutez un contrôle TextBox au formulaire et modifiez les propriétés suivantes dans la fenêtre Propriétés :

Propriété

Valeur

Multiline

True

Scrollbars

Both

Size

255, 160
Ajoutez un contrôle Button au formulaire et modifiez les propriétés suivantes dans la fenêtre Propriétés :

Propriété

Valeur

Name

okButton

Text

OK

Propriété	Valeur
Multiline	True
Scrollbars	Both
Size	255, 160

Propriété	Valeur
Name	okButton
Text	OK

Récupération de données à partir d'une boîte de dialogue

Vous pouvez passer des donnés d'un formulaire Windows à un autre de différentes manières. Dans cet exemple, vous allez passer Form1 au constructeur de Form2.

Pour récupérer des données à partir d'une boîte de dialogue

Double-cliquez sur le bouton OK pour créer le gestionnaire d'événements Click par défaut.

Avant d'ajouter le code à cette procédure, vous devez créer une variable pour le formulaire principal et créer un constructeur pour la classe Form2.
Ajoutez le code suivant en dessous du constructeur par défaut. Ce code crée un constructeur surchargé qui requiert Form1 en tant que paramètre.
```
Form1 mainForm;

public Form2(Form1 mainForm)
{
    this.mainForm = mainForm;
    InitializeComponent();

}
```
Dans le gestionnaire d'événements Click d'okButton, ajoutez le code suivant. Ce code efface tout le texte existant dans la zone de liste, assigne chaque ligne de texte de la zone de texte sur Form2 à un tableau, puis ajoute chaque élément du tableau à la zone de liste sur Form1.
```
if (this.textBox1.Text != string.Empty)
{

    mainForm.listBox1.Items.Clear();

    string[] stringsEntered = textBox1.Lines;

    for (int count = 0; count < stringsEntered.Length; count++)
    {

        mainForm.listBox1.Items.Add(stringsEntered[count]);

    }

}
this.Close();
```
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Form1, puis cliquez sur Concepteur de vues.
Double-cliquez sur le bouton Ajouter pour ajouter le gestionnaire d'événements Click par défaut, puis ajoutez le code suivant pour créer une instance de Form2 et afficher le formulaire :
```
Form2 subForm = new Form2(this);
subForm.Show();
```
Appuyez sur F5 pour exécuter le code.
Lorsque le formulaire s'ouvre, cliquez surAjouter.
Lorsque la boîte de dialogue s'ouvre, tapez la liste de couleurs suivante et appuyez sur ENTRÉE après chaque mot.

Bleu

Vert

Jaune

Rouge
Cliquez sur OK.
Vérifiez que les données tapées dans la boîte de dialogue figurent dans la zone de liste de Form1.
Fermez l'application.