Fungsi DestroyWindow (winuser.h)
Menghancurkan jendela yang ditentukan. Fungsi ini mengirim WM_DESTROY dan WM_NCDESTROY pesan ke jendela untuk menonaktifkannya dan menghapus fokus keyboard darinya. Fungsi ini juga menghancurkan menu jendela, 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 atau jendela yang dimiliki terkait saat menghancurkan jendela induk atau pemilik. Fungsi ini 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 .
BOOL DestroyWindow(
[in] HWND hWnd
);
[in] hWnd
Jenis: HWND
Handel ke jendela yang akan dihancurkan.
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.
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.
Misalnya, lihat Menghancurkan Jendela.
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 (sertakan Windows.h) |
Pustaka | User32.lib |
DLL | User32.dll |
Set API | ext-ms-win-ntuser-window-l1-1-0 (diperkenalkan di Windows 8) |
Konseptual
Referensi