Window.Close Metoda

Definicja

Ręcznie zamyka element 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 ()
Atrybuty

Przykłady

W poniższym przykładzie pokazano menuZakończeniapliku> obsługiwane w celu jawnego wywołania metody Close.

<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

Uwagi

Element Window można zamknąć przy użyciu jednego z kilku dobrze znanych mechanizmów dostarczanych przez system znajdujących się na pasku tytułu, w tym:

  • ALT+F4.
  • Menu systemowe | Zamknij.
  • Przycisk Zamknij .

Można Window również zamknąć przy użyciu jednego z kilku dobrze znanych mechanizmów w obszarze klienta, które są udostępniane przez deweloperów, w tym:

  • Plik>Wyjdź z okna głównego.
  • Plik>Zamknij lub przycisk Zamknij w oknie podrzędnym.

Uwaga

Przyciski OK i Anuluj w oknie dialogowym są również dostępne dla deweloperów, ale prawdopodobnie ustawi DialogResultwartość , która automatycznie zamyka okno, które zostało otwarte przez wywołanie polecenia ShowDialog.

Te mechanizmy wymagają jawnego wywołania w Close celu zamknięcia okna.

Uwaga

Jeśli okno zostanie otwarte przez wywołanie ShowDialogmetody i z właściwością Button ustawioną IsCancel na wartość true, zostanie automatycznie zamknięte po kliknięciu przycisku lub naciśnięciu klawisza ESC. Jeśli okno zostało otwarte przy użyciu Showmetody , Close musi być jednak jawnie wywoływane, na przykład z Click programu obsługi zdarzeń dla programu Button.

Zamknięcie okna powoduje, że Closing zdarzenie zostanie podniesione. Closing Jeśli zdarzenie nie zostanie anulowane, wystąpią następujące czynności:

  • Obiekt Window zostanie usunięty z Application.Windows (jeśli Application obiekt istnieje).

  • Element Window zostanie usunięty z właściciela Window , jeśli relacja właściciela/właściciela została ustanowiona przed pokazanym właścicielem Window i po otwarciu właściciela Window .

  • Zdarzenie Closed jest zgłaszane.

  • Zasoby niezarządzane utworzone przez te Window zasoby są usuwane.

  • Jeśli ShowDialog wywołano polecenie w celu wyświetlenia elementu Window, ShowDialog zwraca wartość false.

    Zamknięcie powoduje Window zamknięcie okien, których jest właścicielem. Ponadto zamknięcie elementu Window może spowodować, że aplikacja przestanie działać w zależności od tego, jak właściwość jest ustawiona Application.ShutdownMode .

Uwaga

Nie można wywołać tej metody, gdy okno jest hostowane w przeglądarce.

Dotyczy

Zobacz też