Fungsi IsDlgButtonChecked (winuser.h)

Fungsi IsDlgButtonChecked menentukan apakah kontrol tombol dicentang atau apakah kontrol tombol tiga status dicentang, tidak dicentang, atau tidak ditentukan.

Sintaks

UINT IsDlgButtonChecked(
  [in] HWND hDlg,
  [in] int  nIDButton
);

Parameter

[in] hDlg

Jenis: HWND

Handel ke kotak dialog yang berisi kontrol tombol.

[in] nIDButton

Jenis: int

Pengidentifikasi kontrol tombol.

Nilai kembali

Jenis: UINT

Nilai yang dikembalikan dari tombol yang dibuat dengan gaya BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON, atau BS_3STATE bisa menjadi salah satu nilai dalam tabel berikut ini. Jika tombol memiliki gaya lain, nilai yang dikembalikan adalah nol.

Menampilkan kode Deskripsi
BST_CHECKED
Tombol dicentang.
BST_INDETERMINATE
Tombol dalam status tidak ditentukan (hanya berlaku jika tombol memiliki gaya BS_3STATE atau BS_AUTO3STATE ).
BST_UNCHECKED
Tombol tidak dicentang.

Keterangan

Fungsi IsDlgButtonChecked mengirimkan pesan BM_GETCHECK ke kontrol tombol yang ditentukan.

Contoh

Misalnya, lihat bagian berjudul "Membuat Kotak Dialog Tanpa Mode" di Menggunakan Kotak Dialog.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header winuser.h (sertakan Windows.h)
Pustaka User32.lib
DLL User32.dll
Set API ext-ms-win-ntuser-dialogbox-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

CheckDlgButton