Fungsi DestroyWindow (winuser.h)

Artikel
03/04/2024

Menghancurkan jendela yang ditentukan. Fungsi mengirim WM_DESTROY dan WM_NCDESTROY pesan ke jendela untuk menonaktifkannya dan menghapus fokus keyboard darinya. Fungsi ini juga menghancurkan menu jendela, membersihkan antrean pesan utas, menghancurkan timer, menghapus kepemilikan clipboard, dan memutus rantai penampil clipboard (jika jendela berada di bagian atas rantai penampil).

Jika jendela yang ditentukan adalah jendela induk atau pemilik, DestroyWindow secara otomatis menghancurkan anak terkait atau jendela yang dimiliki saat menghancurkan jendela induk atau pemilik. Fungsi pertama-tama menghancurkan jendela anak atau milik, dan kemudian menghancurkan jendela induk atau pemilik.

DestroyWindow juga menghancurkan kotak dialog tanpa mode yang dibuat oleh fungsi CreateDialog .

Sintaks

BOOL DestroyWindow(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela yang akan dihancurkan.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Utas tidak dapat menggunakan DestroyWindow untuk menghancurkan jendela yang dibuat oleh utas yang berbeda.

Jika jendela yang dihancurkan adalah jendela anak yang tidak memiliki gaya WS_EX_NOPARENTNOTIFY , pesan WM_PARENTNOTIFY dikirim ke induk.

Contoh

Misalnya, lihat Menghancurkan Jendela.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-window-l1-1-0 (diperkenalkan dalam Windows 8)