Freigeben über


DestroyWindow-Funktion (winuser.h)

Zerstört das angegebene Fenster. Die Funktion sendet WM_DESTROY und WM_NCDESTROY Nachrichten an das Fenster, um es zu deaktivieren und den Tastaturfokus daraus zu entfernen. Die Funktion zerstört auch das Menü des Fensters, zerstört Zeitgeber, entfernt den Besitz der Zwischenablage und unterbricht die Zwischenablageanzeigekette (wenn sich das Fenster am oberen Rand der Viewerkette befindet).

Wenn es sich bei dem angegebenen Fenster um ein übergeordnetes Fenster oder ein Besitzerfenster handelt, zerstört DestroyWindow automatisch die zugeordneten untergeordneten oder eigenen Fenster, wenn das übergeordnete Fenster oder das Besitzerfenster zerstört wird. Die Funktion zerstört zuerst untergeordnete oder eigene Fenster und zerstört dann das übergeordnete Fenster oder das Besitzerfenster.

DestroyWindow zerstört auch moduslose Dialogfelder, die von der CreateDialog-Funktion erstellt wurden.

Syntax

BOOL DestroyWindow(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das zu zerstörende Fenster.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Ein Thread kann destroyWindow nicht verwenden, um ein Fenster zu zerstören, das von einem anderen Thread erstellt wurde.

Wenn es sich bei dem zerstörten Fenster um ein untergeordnetes Fenster handelt, das nicht über das WS_EX_NOPARENTNOTIFY-Format verfügt, wird eine WM_PARENTNOTIFY-Nachricht an das übergeordnete Element gesendet.

Beispiele

Ein Beispiel finden Sie unter Zerstören eines Fensters.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzept

CreateDialog

Createwindow

Createwindowex

Referenz

WM_DESTROY

WM_NCDESTROY

WM_PARENTNOTIFY

Windows