Window.Close Metodo

Definizione

Chiude manualmente un oggetto 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 ()
Attributi

Esempio

Nell'esempio seguente viene illustrato un menu File>Exit gestito per chiamare Closein modo esplicito .

<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

Commenti

Un Window oggetto può essere chiuso usando uno dei diversi meccanismi noti e forniti dal sistema che si trovano nella barra del titolo, tra cui:

  • ALT+F4.
  • Menu di sistema | Chiudi.
  • Pulsante Chiudi .

Un Window oggetto può anche essere chiuso usando uno dei diversi meccanismi noti all'interno dell'area client fornita dagli sviluppatori, tra cui:

  • File>Uscire da una finestra principale.
  • File>Chiudere o chiudere un pulsante Chiudi in una finestra figlio.

Nota

Anche i pulsanti OK e Annulla in una finestra di dialogo vengono forniti dallo sviluppatore, anche se è probabile che venga impostato DialogResult, che chiude automaticamente una finestra aperta chiamando ShowDialog.

Questi meccanismi richiedono di chiamare Close in modo esplicito per chiudere una finestra.

Nota

Se una finestra, aperta chiamando ShowDialoge con un Button con la relativa IsCancel proprietà impostata su true, si chiude automaticamente quando si fa clic sul pulsante oppure viene premuto ESC. Se la finestra è stata aperta usando Show, tuttavia, Close deve essere chiamata in modo esplicito, ad esempio dal Click gestore eventi per .Button

La chiusura di una finestra determina la generazione dell'evento Closing . Se l'evento Closing non viene annullato, si verifica quanto segue:

  • L'oggetto Window viene rimosso da Application.Windows (se esiste un Application oggetto).

  • L'oggetto Window viene rimosso dal proprietario Window se la relazione proprietaria/di proprietà è stata stabilita prima della visualizzazione del proprietario Window e dopo l'apertura del proprietario Window .

  • Viene generato l'evento Closed.

  • Le risorse non gestite create da Window vengono eliminate.

  • Se ShowDialog è stato chiamato per visualizzare Window, ShowDialog restituisce false.

    La chiusura di un Window oggetto causa la chiusura di tutte le finestre di proprietà. Inoltre, la chiusura di un Window oggetto può causare l'arresto dell'esecuzione di un'applicazione a seconda della modalità di impostazione della Application.ShutdownMode proprietà.

Nota

Questo metodo non può essere chiamato quando una finestra è ospitata in un browser.

Si applica a

Vedi anche