Window.ShowDialog Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Apre una finestra e restituisce un valore solo quando la finestra appena aperta viene chiusa.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog ();

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

Public Function ShowDialog () As Nullable(Of Boolean)

Restituisce

Nullable<Boolean>

Valore Nullable<T> del tipo Boolean che specifica se l'attività è stata accettata (true) o annullata (false). Il valore restituito è il valore della proprietà DialogResult prima della chiusura di una finestra.

Eccezioni

InvalidOperationException

ShowDialog() viene chiamato su una finestra in fase di chiusura (Closing) o che è stata chiusa (Closed).

Esempio

Nell'esempio seguente viene illustrato come aprire una finestra 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()

Commenti

Quando viene creata un'istanza di una Window classe, non è visibile per impostazione predefinita. ShowDialog mostra la finestra, disabilita tutte le altre finestre dell'applicazione e restituisce solo quando la finestra viene chiusa. Questo tipo di finestra è noto come finestra modale .

Le finestre modali vengono usate principalmente come finestre di dialogo. Una finestra di dialogo è un tipo speciale di finestra che le applicazioni usano per interagire con gli utenti per completare le attività, ad esempio l'apertura di file o la stampa di documenti. Le finestre di dialogo consentono in genere agli utenti di accettare o annullare l'attività per la quale sono stati visualizzati prima della chiusura della finestra di dialogo. ShowDialog restituisce un Nullable<T>Boolean valore che specifica se l'attività è stata accettata o annullata. Il valore restituito è il valore della proprietà DialogResult prima della chiusura di una finestra. Per altre informazioni, vedere DialogResult.

Una finestra aperta chiamando il ShowDialog metodo non ha automaticamente una relazione con la finestra aperta. In particolare, la finestra aperta non lo conosce. Questa relazione può essere stabilita usando la Owner proprietà e gestita usando la OwnedWindows proprietà . Per supportare l'automazione interfaccia utente (vedere panoramica Automazione interfaccia utente), Owner è necessario impostare per una finestra aperta chiamando ShowDialog.

Quando una finestra WPF modale (una finestra aperta chiamando ShowDialog) viene chiusa, la finestra attivata in precedenza viene riattivata. Se una finestra WPF modale ha una finestra proprietario (vedere Owner), la finestra proprietario non viene riattivata quando la finestra WPF modale viene chiusa a meno che non fosse la finestra attivata in precedenza.

Nota

Questo metodo non può essere chiamato quando una finestra è ospitata in un browser.

Vedi anche

• Close()
• WindowState