Window.Close Método

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationFramework.dll

Fecha manualmente um Windowarquivo .

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 seguinte mostra um menude Saída> a ser 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

Observações

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

  • ALT+F4.
  • Menu do sistema | Quase.
  • Fecha o botão.

O A Window também pode ser fechado usando um dos vários mecanismos bem conhecidos dentro da área do cliente fornecidos pelos programadores, incluindo:

  • Ficheiro>Sai por uma janela principal.
  • Ficheiro>Fechar ou usar um botão Fechar numa janela criança.

Note

Os botões OK e Cancelar numa caixa de diálogo também são fornecidos pelo programador, embora provavelmente definam DialogResult, que fecha automaticamente uma janela que foi aberta ao chamar ShowDialog.

Estes mecanismos exigem que chames Close explicitamente para fechar uma janela.

Note

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

Fechar uma janela faz com que o Closing evento seja elevado. Se o Closing evento não for cancelado, ocorre o seguinte:

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

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

  • O evento Closed é acionado.

  • Os recursos não geridos criados pelos Window são dispostos.

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

    Fechar a Window faz com que todas as janelas que possua fiquem fechadas. Além disso, fechar a Window pode fazer com que uma aplicação pare de correr, dependendo de como a Application.ShutdownMode propriedade está definida.

Note

Este método não pode ser chamado quando uma janela está alojada num navegador.

Aplica-se a

Ver também