Partilhar via

Window.Close Método

Definição

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

Fecha manualmente um Window.

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 tratado 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, 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 na área do cliente que são fornecidos pelos desenvolvedores, incluindo:

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

Observação

Os botões OK e Cancel em uma caixa de diálogo também são fornecidos pelo desenvolvedor, embora provavelmente serão definidos DialogResult, o 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 propriedade definida como IsCancel 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 explicitamente chamada, 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 objeto é removido Application.Windows (se houver um Application objeto).

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

  • O evento Closed foi acionado.

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

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

    O fechamento de uma Window janela faz com que todas as janelas de sua propriedade sejam fechadas. Além disso, o fechamento de um Window aplicativo 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