Window.Close Método

  • Referência

Definição

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

Fecha um Window manualmente.

public:
 void Close();
[System.Security.SecurityCritical]
public void Close ();
public void Close ();
[<System.Security.SecurityCritical>]
member this.Close : unit -> unit
member this.Close : unit -> unit
Public Sub Close ()
Atributos
SecurityCriticalAttribute

Exemplos

O exemplo a seguir mostra um menuSaída de Arquivo> sendo manipulado para chamar Closeexplicitamente .

<MenuItem Name="fileExitMenuItem" Header="E_xit" Click="fileExitMenuItem_Click"></MenuItem>

void fileExitMenuItem_Click(object sender, RoutedEventArgs e)
{
    // Close this window
    this.Close();
}

Private Sub fileExitMenuItem_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Close this window
    Me.Close()
End Sub

Comentários

Um Window pode ser fechado usando um dos vários mecanismos, conhecidos e fornecidos pelo sistema localizados em sua barra de título, incluindo:

  • ALT+F4.
  • Menu do sistema | Feche.
  • Botão Fechar .

Um Window também pode ser fechado usando um dos vários mecanismos conhecidos dentro da área de cliente que são fornecidos pelos desenvolvedores, incluindo:

  • Arquivo>Saia em uma janela main.
  • Arquivo>Feche ou um botão Fechar em uma janela filho.

Observação

Os botões OK e Cancelar em uma caixa de diálogo também são fornecidos pelo desenvolvedor, embora provavelmente defina DialogResult, que fecha automaticamente uma janela que foi aberta chamando ShowDialog.

Esses mecanismos exigem que você chame Close explicitamente para fechar uma janela.

Observação

Se uma janela, aberta chamando ShowDialoge com uma Button com sua IsCancel propriedade definida como true, fechará automaticamente quando o botão for clicado ou o ESC for pressionado. Se a janela foi aberta usando Show, no entanto, Close deve ser chamada explicitamente, como do manipulador de Click eventos para o Button.

Fechar uma janela faz com que o Closing evento seja acionado. Se o Closing evento não for cancelado, ocorrerá o seguinte:

  • O Window é removido de Application.Windows (se houver um Application objeto).

  • O Window será removido do proprietário Window se a relação de proprietário/propriedade tiver sido estabelecida antes da propriedade Window ser mostrada e depois que o proprietário Window foi aberto.

  • O evento Closed será gerado.

  • Os recursos não gerenciados criados pelo Window são descartados.

  • Se ShowDialog foi chamado para mostrar o Window, ShowDialog retorna false.

    Fechar um Window faz com que todas as janelas que ele possui sejam fechadas. Além disso, fechar um Window pode fazer com que um aplicativo pare de ser executado dependendo de como a Application.ShutdownMode propriedade é definida.

Observação

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

Aplica-se a

Confira também