Fungsi EnableMenuItem (winuser.h)

Artikel
03/04/2024

Mengaktifkan, menonaktifkan, atau memerintah item menu yang ditentukan.

Sintaks

BOOL EnableMenuItem(
  [in] HMENU hMenu,
  [in] UINT  uIDEnableItem,
  [in] UINT  uEnable
);

Parameter

[in] hMenu

Jenis: HMENU

Handel ke menu.

[in] uIDEnableItem

Jenis: UINT

Item menu yang akan diaktifkan, dinonaktifkan, atau berwarna abu-abu, seperti yang ditentukan oleh parameter uEnable . Parameter ini menentukan item di bilah menu, menu, atau submenu.

[in] uEnable

Jenis: UINT

Mengontrol interpretasi parameter uIDEnableItem dan menunjukkan apakah item menu diaktifkan, dinonaktifkan, atau berwarna abu-abu. Parameter ini harus merupakan kombinasi dari nilai berikut.

Nilai	Makna
MF_BYCOMMAND 0x00000000L	Menunjukkan bahwa uIDEnableItem memberikan pengidentifikasi item menu. Jika bendera MF_BYCOMMAND atau MF_BYPOSITION tidak ditentukan, bendera MF_BYCOMMAND adalah bendera default.
MF_BYPOSITION 0x00000400L	Menunjukkan bahwa uIDEnableItem memberikan posisi relatif berbasis nol dari item menu.
MF_DISABLED 0x00000002L	Menunjukkan bahwa item menu dinonaktifkan, tetapi tidak berwarna abu-abu, sehingga tidak dapat dipilih.
MF_ENABLED 0x00000000L	Menunjukkan bahwa item menu diaktifkan dan dipulihkan dari status abu-abu sehingga dapat dipilih.
MF_GRAYED 0x00000001L	Menunjukkan bahwa item menu dinonaktifkan dan berwarna abu-abu sehingga tidak dapat dipilih.

Mengembalikan nilai

Jenis: BOOL

Nilai yang dikembalikan menentukan status item menu sebelumnya ( baik MF_DISABLED, MF_ENABLED, atau MF_GRAYED). Jika item menu tidak ada, nilai yang dikembalikan adalah -1.

Keterangan

Aplikasi harus menggunakan bendera MF_BYPOSITION untuk menentukan handel menu yang benar. Jika handel menu ke bilah menu ditentukan, item menu tingkat atas (item di bilah menu) terpengaruh. Untuk mengatur status item di menu drop-down atau submenu menurut posisi, aplikasi harus menentukan handel ke menu drop-down atau submenu.

Ketika aplikasi menentukan bendera MF_BYCOMMAND , sistem memeriksa semua item yang membuka submenus di menu yang diidentifikasi oleh handel menu yang ditentukan. Oleh karena itu, kecuali item menu duplikat ada, menentukan handel menu ke bilah menu sudah cukup.

Fungsi InsertMenu, InsertMenuItem, LoadMenuIndirect, ModifikasiMenu, dan SetMenuItemInfo juga dapat mengatur status (diaktifkan, dinonaktifkan, atau berwarna abu-abu) dari item menu.

Saat Anda mengubah menu jendela, bilah menu tidak segera diperbarui. Untuk memaksa pembaruan, panggil DrawMenuBar.

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