Window.ShowDialog Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Ouvre une fenêtre et retourne uniquement lorsque la nouvelle fenêtre ouverte est fermée.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog ();

member this.ShowDialog : unit -> Nullable<bool>

Public Function ShowDialog () As Nullable(Of Boolean)

Retours

Nullable<Boolean>

Valeur Nullable<T> de type Boolean qui spécifie si l'activité a été acceptée (true) ou annulée (false). La valeur de retour est la valeur de la propriété DialogResult avant la fermeture d'une fenêtre.

Exceptions

InvalidOperationException

ShowDialog() est appelé sur une fenêtre qui se ferme (Closing) ou a été fermée (Closed).

Exemples

L’exemple suivant montre comment ouvrir une fenêtre modale.

// Instantiate window
DialogBox dialogBox = new DialogBox();

// Show window modally
// NOTE: Returns only when window is closed
Nullable<bool> dialogResult = dialogBox.ShowDialog();

' Instantiate window
Dim dialogBox As New DialogBox()

' Show window modally
' NOTE: Returns only when window is closed
Dim dialogResult? As Boolean = dialogBox.ShowDialog()

Remarques

Lorsqu’une Window classe est instanciée, elle n’est pas visible par défaut. ShowDialog affiche la fenêtre, désactive toutes les autres fenêtres de l’application et retourne uniquement lorsque la fenêtre est fermée. Ce type de fenêtre est appelé fenêtre modale .

Les fenêtres modales sont principalement utilisées comme boîtes de dialogue. Une boîte de dialogue est un type spécial de fenêtre que les applications utilisent pour interagir avec les utilisateurs afin d’effectuer des tâches, telles que l’ouverture de fichiers ou l’impression de documents. Les boîtes de dialogue permettent généralement aux utilisateurs d’accepter ou d’annuler la tâche pour laquelle ils ont été affichés avant la fermeture de la boîte de dialogue. ShowDialog retourne une Nullable<T>Boolean valeur qui spécifie si l’activité a été acceptée ou annulée. La valeur de retour est la valeur de la propriété DialogResult avant la fermeture d'une fenêtre. Pour plus d'informations, consultez DialogResult.

Une fenêtre ouverte en appelant la ShowDialog méthode n’a pas automatiquement de relation avec la fenêtre qui l’a ouverte ; en particulier, la fenêtre ouverte ne sait pas quelle fenêtre a été ouverte. Cette relation peut être établie à l’aide de la Owner propriété et gérée à l’aide de la OwnedWindows propriété . Pour prendre en charge l’automatisation de l’interface utilisateur (voir Vue d’ensemble d’UI Automation), Owner doit être défini pour une fenêtre ouverte en appelant ShowDialog.

Lorsqu’une fenêtre WPF modale (fenêtre ouverte en appelant ShowDialog) est fermée, la fenêtre précédemment activée est réactivée. Si une fenêtre WPF modale a une fenêtre propriétaire (voir Owner), la fenêtre propriétaire n’est pas réactivée lorsque la fenêtre WPF modale est fermée, sauf s’il s’agit de la fenêtre précédemment activée.

Notes

Cette méthode ne peut pas être appelée lorsqu’une fenêtre est hébergée dans un navigateur.

Voir aussi

• Close()
• WindowState