Fungsi EnableWindow (winuser.h)

Artikel
08/27/2023

Mengaktifkan atau menonaktifkan input mouse dan keyboard ke jendela atau kontrol yang ditentukan. Ketika input dinonaktifkan, jendela tidak menerima input seperti klik mouse dan penekanan tombol. Ketika input diaktifkan, jendela menerima semua input.

Sintaks

BOOL EnableWindow(
  [in] HWND hWnd,
  [in] BOOL bEnable
);

Parameter

[in] hWnd

Jenis: HWND

Handel ke jendela yang akan diaktifkan atau dinonaktifkan.

[in] bEnable

Jenis: BOOL

Menunjukkan apakah akan mengaktifkan atau menonaktifkan jendela. Jika parameter ini TRUE, jendela diaktifkan. Jika parameternya FALSE, jendela dinonaktifkan.

Nilai kembali

Jenis: BOOL

Jika jendela sebelumnya dinonaktifkan, nilai yang dikembalikan bukan nol.

Jika jendela sebelumnya tidak dinonaktifkan, nilai yang dikembalikan adalah nol.

Keterangan

Jika jendela dinonaktifkan, sistem akan mengirim pesan WM_CANCELMODE . Jika status jendela yang diaktifkan berubah, sistem akan mengirim pesan WM_ENABLE setelah pesan WM_CANCELMODE . (Pesan-pesan ini dikirim sebelum EnableWindow kembali.) Jika jendela sudah dinonaktifkan, jendela anaknya secara implisit dinonaktifkan, meskipun jendela tersebut tidak dikirimi pesan WM_ENABLE .

Jendela harus diaktifkan sebelum dapat diaktifkan. Misalnya, jika aplikasi menampilkan kotak dialog tanpa mode dan telah menonaktifkan jendela utamanya, aplikasi harus mengaktifkan jendela utama sebelum menghancurkan kotak dialog. Jika tidak, jendela lain akan menerima fokus keyboard dan diaktifkan. Jika jendela anak dinonaktifkan, jendela diabaikan ketika sistem mencoba menentukan jendela mana yang harus menerima pesan mouse.

Secara default, jendela diaktifkan saat dibuat. Untuk membuat jendela yang awalnya dinonaktifkan, aplikasi dapat menentukan gaya WS_DISABLED dalam fungsi CreateWindow atau CreateWindowEx . Setelah jendela dibuat, aplikasi dapat menggunakan EnableWindow untuk mengaktifkan atau menonaktifkan jendela.

Aplikasi dapat menggunakan fungsi ini untuk mengaktifkan atau menonaktifkan kontrol dalam kotak dialog. Kontrol yang dinonaktifkan tidak dapat menerima fokus keyboard, pengguna juga tidak dapat memperoleh akses ke kontrol tersebut.

Persyaratan


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-4 (diperkenalkan dalam Windows 10, versi 10.0.14393)