Window.ShowDialog Methode

public:
 Nullable<bool> ShowDialog();

[System.Security.SecurityCritical]
public bool? ShowDialog();

public bool? ShowDialog();

[<System.Security.SecurityCritical>]
member this.ShowDialog : unit -> Nullable<bool>

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

Public Function ShowDialog () As Nullable(Of Boolean)

Retouren

Een Nullable<T> waarde van het type Boolean dat aangeeft of de activiteit is geaccepteerd (true) of geannuleerd (false). De retourwaarde is de waarde van de DialogResult eigenschap voordat een venster wordt gesloten.

Kenmerken

SecurityCriticalAttribute

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u een modaal venster opent.

// 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()

Opmerkingen

Wanneer een Window klasse wordt geïnstantieerd, is deze niet standaard zichtbaar. ShowDialog toont het venster, schakelt alle andere vensters in de toepassing uit en retourneert alleen wanneer het venster wordt gesloten. Dit type venster wordt een modaal venster genoemd.

Modale vensters worden voornamelijk gebruikt als dialoogvensters. Een dialoogvenster is een speciaal type venster dat toepassingen gebruiken om met gebruikers te communiceren om taken uit te voeren, zoals het openen van bestanden of het afdrukken van documenten. In dialoogvensters kunnen gebruikers meestal de taak accepteren of annuleren waarvoor ze zijn weergegeven voordat het dialoogvenster wordt gesloten. ShowDialog retourneert een Nullable<T>Boolean waarde die aangeeft of de activiteit is geaccepteerd of geannuleerd. De retourwaarde is de waarde van de DialogResult eigenschap voordat een venster wordt gesloten. Zie DialogResult voor meer informatie.

Een venster dat wordt geopend door de ShowDialog methode aan te roepen, heeft niet automatisch een relatie met het venster dat het heeft geopend. Het geopende venster weet niet welk venster het heeft geopend. Deze relatie kan tot stand worden gebracht met behulp van de Owner eigenschap en beheerd met behulp van de OwnedWindows eigenschap. Als u UI automation wilt ondersteunen (zie UI Automation Overview), moet Owner zijn ingesteld voor een venster dat wordt geopend door ShowDialog aan te roepen.

Wanneer een modaal WPF venster (een venster geopend door ShowDialog) wordt geopend, wordt het eerder geactiveerde venster opnieuw geactiveerd. Als een modaal WPF venster een eigenaarvenster heeft (zie Owner), wordt het venster van de eigenaar niet opnieuw geactiveerd wanneer het modale WPF venster wordt gesloten, tenzij het eerder geactiveerde venster is.

Zie ook

• Close()
• WindowState