Partilhar via

Como fechar uma janela ou caixa de diálogo

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 Fechar item do menu Sistema .
  • Pressionando ALT + F4.
  • Pressionando o botão Fechar.
  • Pressionar ESC quando um botão tem a propriedade IsCancel definida como true em uma janela modal.

Ao projetar uma janela, forneça mais mecanismos na área de utilizador para facilitar o fecho da 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, normalmente para as janelas principais da aplicação.
  • Um item Fechar no menu Arquivo, normalmente numa janela secundária do aplicativo.
  • Um botão Cancelar, normalmente numa caixa de diálogo modal.
  • Um botão Fechar, normalmente numa caixa de diálogo não modal.

Importante

Depois que uma janela é fechada, a mesma instância de objeto não pode ser usada para reabri-la.

Para obter mais informações sobre a vida útil de uma janela, consulte Visão geral das janelas WPF: tempo de vida 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 DialogResult propriedade é definida como um valor, a janela fecha. 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 for fechada, ela não poderá ser reaberta com a mesma instância de objeto. Se você tentar mostrar a mesma janela, um InvalidOperationException é jogado. Em vez disso, crie uma nova instância da janela e abra-a.

Fechar uma janela sem moderação

Ao fechar uma janela que foi aberta com o Show método, use o Close método. O código a seguir demonstra o fechamento de 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 a ocultação de 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.

Atenção

Se uma janela for mostrada modalmente com ShowDialog, a DialogResult propriedade será definida para null quando a 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 é passado um CancelEventArgs, que implementa a Cancel propriedade. Defina essa propriedade como true para 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 queira 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 o fechamento da janela.

Ver também