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
Referenz