Fungsi CheckMenuItem (winuser.h)

Artikel
03/15/2023

[CheckMenuItem tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan SetMenuItemInfo. ]

Mengatur status atribut tanda centang item menu yang ditentukan ke dipilih atau dibersihkan.

Sintaks

DWORD CheckMenuItem(
  [in] HMENU hMenu,
  [in] UINT  uIDCheckItem,
  [in] UINT  uCheck
);

Parameter

[in] hMenu

Jenis: HMENU

Handel ke menu yang menarik.

[in] uIDCheckItem

Jenis: UINT

Item menu yang atribut tanda centangnya akan diatur, seperti yang ditentukan oleh parameter uCheck .

[in] uCheck

Jenis: UINT

Bendera yang mengontrol interpretasi parameter uIDCheckItem dan status atribut tanda centang item menu. Parameter ini dapat berupa kombinasi MF_BYCOMMAND, atau MF_BYPOSITION dan MF_CHECKED atau MF_UNCHECKED.

Nilai	Makna
MF_BYCOMMAND 0x00000000L	Menunjukkan bahwa parameter uIDCheckItem memberikan pengidentifikasi item menu. Bendera MF_BYCOMMAND adalah default, jika bendera MF_BYCOMMAND atau MF_BYPOSITION tidak ditentukan.
MF_BYPOSITION 0x00000400L	Menunjukkan bahwa parameter uIDCheckItem memberikan posisi relatif berbasis nol dari item menu.
MF_CHECKED 0x00000008L	Mengatur atribut tanda centang ke status yang dipilih.
MF_UNCHECKED 0x00000000L	Mengatur atribut tanda centang ke status jelas.

Mengembalikan nilai

Jenis: DWORD

Nilai yang dikembalikan menentukan status item menu sebelumnya (baik MF_CHECKED atau MF_UNCHECKED). Jika item menu tidak ada, nilai yang dikembalikan adalah –1.

Keterangan

Item di bilah menu tidak boleh memiliki tanda centang.

Parameter uIDCheckItem mengidentifikasi item yang membuka submenu atau item perintah. Untuk item yang membuka submenu, parameter uIDCheckItem harus menentukan posisi item. Untuk item perintah, parameter uIDCheckItem dapat menentukan posisi item atau pengidentifikasinya.

Contoh

Misalnya, lihat Mensimulasikan Kotak Centang di Menu.

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-menu-l1-1-0 (diperkenalkan di Windows 8)