Como fechar uma janela ou caixa de diálogo (WPF .NET)

Neste artigo, você aprenderá sobre as diferentes maneiras de fechar uma janela ou caixa de diálogo. Um usuário pode fechar uma janela usando os elementos na área não cliente, incluindo o seguinte:

  • O item Fechar do menu Sistema.
  • Pressionando ALT+F4.
  • Pressionando o botão Fechar.
  • Pressionando ESC quando um botão tem a propriedade IsCancel definida como true em uma janela modal.

Ao projetar uma janela, forneça mais mecanismos à área do cliente para fechar uma janela. Alguns dos elementos de design comuns em uma janela que são usados para fechá-la incluem o seguinte:

  • Um item Sair no menu Arquivo, geralmente para janelas do aplicativo principal.
  • Um item Fechar no menu Arquivo, normalmente para uma janela do aplicativo secundária.
  • Um botão Cancelar, normalmente em uma caixa de diálogo modal.
  • Um botão Fechar, normalmente em uma caixa de diálogo não modal.

Importante

Depois que uma janela é fechada, a mesma ocorrência de objeto não pode ser usada para reabrir a janela.

Para obter mais informações sobre a vida útil de uma janela, consulte Visão geral das janelas WPF: vida útil da janela.

Fechar uma janela modal

Ao fechar uma janela que foi aberta com o ShowDialog método, defina a DialogResult propriedade como ou truefalse para indicar um estado "aceito" ou "cancelado", respectivamente. Assim que a propriedade é definida como um valor, a DialogResult janela é fechada. O código a seguir demonstra a configuração da DialogResult propriedade:

private void okButton_Click(object sender, RoutedEventArgs e) =>
    DialogResult = true;

private void cancelButton_Click(object sender, RoutedEventArgs e) =>
    DialogResult = false;
Private Sub okButton_Click(sender As Object, e As RoutedEventArgs)
    DialogResult = True
End Sub

Private Sub cancelButton_Click(sender As Object, e As RoutedEventArgs)
    DialogResult = False
End Sub

Você também pode chamar o Close método. Se o Close método for usado, a DialogResult propriedade será definida como false.

Depois que uma janela é fechada, ela não pode ser reaberta com a mesma instância de objeto. Se você tentar mostrar a mesma janela, um InvalidOperationException é lançado. Em vez disso, crie uma nova instância da janela e abra-a.

Fechar uma janela sem janela restrita

Ao fechar uma janela que foi aberta com o método, use o ShowClose método. O código a seguir demonstra como fechar uma janela sem moderação:

private void closeButton_Click(object sender, RoutedEventArgs e) =>
    Close();
Private Sub closeButton_Click(sender As Object, e As RoutedEventArgs)
    Close()
End Sub

Fechar com IsCancel

A Button.IsCancel propriedade pode ser definida para true permitir que a chave ESC feche automaticamente a janela. Isso só funciona quando a janela é aberta com ShowDialog método.

<Button Name="cancelButton" IsCancel="True">Cancel</Button>

Ocultar uma janela

Em vez de fechar uma janela, uma janela pode ser ocultada com o Hide método. Uma janela oculta pode ser reaberta, ao contrário de uma janela que foi fechada. Se você for reutilizar uma ocorrência de objeto de janela, oculte a janela em vez de fechá-la. O código a seguir demonstra como ocultar uma janela:

private void saveButton_Click(object sender, RoutedEventArgs e) =>
    Hide();
Private Sub saveButton_Click(sender As Object, e As RoutedEventArgs)
    Hide()
End Sub

Cancelar, fechar e ocultar

Se você projetou seus botões para ocultar uma janela em vez de fechá-la, o usuário ainda pode ignorar isso e fechar a janela. O item Fechar do menu do sistema e o botão Fechar da área não cliente da janela, fecharão a janela em vez de ocultá-la. Considere esse cenário quando sua intenção for ocultar uma janela em vez de fechá-la.

Cuidado

Se uma janela for mostrada modalmente com ShowDialog, a propriedade será definida como null quando a DialogResult janela estiver oculta. Você precisará comunicar o estado de volta ao código de chamada adicionando sua própria propriedade à janela.

Quando uma janela é fechada, o Closing evento é gerado. O manipulador passa um CancelEventArgs, que implementa a Cancel propriedade. Defina essa propriedade para true impedir que uma janela seja fechada. O código a seguir demonstra como cancelar o fechamento e, em vez disso, ocultar a janela:

private void Window_Closing(object sender, System.ComponentModel.CancelEventArgs e)
{
    // Cancel the closure
    e.Cancel = true;

    // Hide the window
    Hide();
}
Private Sub Window_Closing(sender As Object, e As ComponentModel.CancelEventArgs)
    ' Cancel the closure
    e.Cancel = True

    ' Hide the window
    Hide()
End Sub

Pode haver momentos em que você não quer ocultar uma janela, mas na verdade impedir que o usuário a feche. Para obter mais informações, consulte Visão geral das janelas do WPF: Cancelar fechamento de janela.

Confira também