Window.ShowDialog Método

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)

Devoluções

Um Nullable<T> valor de tipo Boolean que especifica se a atividade foi aceite (true) ou cancelada (false). O valor de retorno é o valor da DialogResult propriedade antes de uma janela fechar.

Atributos

SecurityCriticalAttribute

Exceções

Exemplos

O exemplo seguinte demonstra como abrir uma janela modal.

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

Observações

Quando uma Window classe é instanciada, não é visível por defeito. ShowDialog mostra a janela, desativa todas as outras janelas na aplicação e só retorna quando a janela está fechada. Este tipo de janela é conhecido como janela modal .

As janelas modais são principalmente usadas como caixas de diálogo. Uma caixa de diálogo é um tipo especial de janela que as aplicações utilizam para interagir com os utilizadores e realizar tarefas, como abrir ficheiros ou imprimir documentos. As caixas de diálogo permitem frequentemente que os utilizadores aceitem ou cancelem a tarefa para a qual foram mostrados antes de a caixa de diálogo ser fechada. ShowDialog devolve um Nullable<T>Boolean valor que especifica se a atividade foi aceite ou cancelada. O valor de retorno é o valor da DialogResult propriedade antes de uma janela fechar. Para obter mais informações, veja DialogResult.

Uma janela que é aberta ao chamar o ShowDialog método não tem automaticamente uma relação com a janela que a abriu; especificamente, a janela aberta não sabe qual janela a abriu. Esta relação pode ser estabelecida usando o Owner imóvel e gerida através do imóvel OwnedWindows . Para suportar UI automation (ver Automatização da Interface de Utilizador Overview), Owner deve ser definido para uma janela aberta ao chamar ShowDialog.

Quando uma janela de WPF modal (uma janela aberta ao chamar ShowDialog) é fechada, a janela previamente ativada é reativada. Se uma janela de WPF modal tiver uma janela de proprietário (ver Owner), a janela de dono não é reativada quando a janela de WPF modal está fechada, a menos que tenha sido a janela previamente ativada.

Ver também

• Close()
• WindowState