Window.ShowDialog Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Abre uma janela e retorna somente quando a janela recém-aberta é fechada.

public:
 Nullable<bool> ShowDialog();

public bool? ShowDialog ();

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

Public Function ShowDialog () As Nullable(Of Boolean)

Retornos

Nullable<Boolean>

Um valor Nullable<T> do tipo Boolean que especifica se a atividade foi aceita (true) ou cancelada (false). O valor retornado é o valor da propriedade DialogResult antes que uma janela seja fechada.

Exceções

InvalidOperationException

ShowDialog() é chamado em uma janela que está sendo fechada (Closing) ou que foi fechada (Closed).

Exemplos

O exemplo a seguir 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()

Comentários

Quando uma Window classe é instanciada, ela não fica visível por padrão. ShowDialog mostra a janela, desabilita todas as outras janelas do aplicativo e retorna somente quando a janela é fechada. Esse tipo de janela é conhecido como uma janela modal .

As janelas modais são usadas principalmente como caixas de diálogo. Uma caixa de diálogo é um tipo especial de janela que os aplicativos usam para interagir com os usuários para concluir tarefas, como abrir arquivos ou imprimir documentos. As caixas de diálogo geralmente permitem que os usuários aceitem ou cancelem a tarefa para a qual foram mostradas antes que a caixa de diálogo seja fechada. ShowDialog retorna um Nullable<T>Boolean valor que especifica se a atividade foi aceita ou cancelada. O valor retornado é o valor da propriedade DialogResult antes que uma janela seja fechada. Para obter mais informações, consulte DialogResult.

Uma janela aberta chamando 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 o abriu. Essa relação pode ser estabelecida usando a Owner propriedade e gerenciada usando a OwnedWindows propriedade . Para dar suporte à automação da interface do usuário (consulte Visão geral da automação da interface do usuário), Owner deve ser definido para uma janela aberta chamando ShowDialog.

Quando uma janela modal do WPF (uma janela aberta chamando ShowDialog) é fechada, a janela ativada anteriormente é reativada. Se uma janela modal do WPF tiver uma janela de proprietário (consulte Owner), a janela do proprietário não será reativada quando a janela modal do WPF for fechada, a menos que tenha sido a janela ativada anteriormente.

Observação

Esse método não pode ser chamado quando uma janela é hospedada em um navegador.

Confira também

• Close()
• WindowState