Données entrées par l'utilisateur dans les boîtes de dialogue

Mise à jour : novembre 2007

En général, les boîtes de dialogue sont employées pour inviter l'utilisateur à entrer des données qui sont ensuite utilisées par l'application. Le formulaire qui affiche la boîte de dialogue traite ces informations. Quand vous affichez une boîte de dialogue, il est important de savoir comment elle est fermée, c'est-à-dire son « résultat ». Par exemple, si l'utilisateur clique sur un bouton Annuler, les données qu'il a entrées ne sont pas conservées. Vous pouvez utiliser la propriété Form.DialogResult pour savoir comment une boîte de dialogue est fermée.

À partir du formulaire qui affiche la boîte de dialogue (autrement dit, son formulaire parent), vous pouvez utiliser la valeur de la propriété DialogResult pour déterminer si un bouton OK ou un bouton Annuler est sélectionné. En fonction de la valeur retournée pour la propriété DialogResult, vous décidez si vous avez besoin d'extraire les informations de la boîte de dialogue. Si vous n'utilisez pas les contrôles Button de votre boîte de dialogue, vous pouvez néanmoins retourner son résultat en définissant la valeur de sa propriété DialogResult.

Lorsqu'un formulaire est affiché comme une boîte de dialogue modale, un clic sur le bouton Fermer (le bouton marqué d'une croix et situé dans le coin supérieur droit du formulaire) entraîne le masquage du formulaire et l'affectation de la valeur DialogResult.Cancel à la propriété DialogResult. La méthode Close n'est pas appelée automatiquement lorsque l'utilisateur clique sur le bouton Fermer d'une boîte de dialogue ou affecte une valeur à la propriété DialogResult. En revanche, le formulaire est masqué et peut être affiché à nouveau sans créer une nouvelle instance de la boîte de dialogue. En raison de ce comportement, vous devez appeler la méthode Dispose du formulaire une fois ce dernier devenu inutile à l'application.

Remarque :
Vous pouvez substituer la valeur assignée à la propriété DialogResult lorsque l'utilisateur clique sur le bouton Fermer en définissant la propriété DialogResult dans un gestionnaire d'événements pour l'événement Closing du formulaire.

Voir aussi

Tâches

Comment : créer des boîtes de dialogue au moment du design

Comment : fermer les boîtes de dialogue et conserver les données entrées par l'utilisateur

Comment : récupérer le résultat des boîtes de dialogue

Autres ressources

Boîtes de dialogue dans les Windows Forms