STRUKTUR MENUITEMINFOW (winuser.h)

Berisi informasi tentang item menu.

typedef struct tagMENUITEMINFOW {
  UINT      cbSize;
  UINT      fMask;
  UINT      fType;
  UINT      fState;
  UINT      wID;
  HMENU     hSubMenu;
  HBITMAP   hbmpChecked;
  HBITMAP   hbmpUnchecked;
  ULONG_PTR dwItemData;
  LPWSTR    dwTypeData;
  UINT      cch;
  HBITMAP   hbmpItem;
} MENUITEMINFOW, *LPMENUITEMINFOW;

cbSize

Jenis: UINT

Ukuran struktur, dalam byte. Penelepon harus mengatur anggota ini ke sizeof(MENUITEMINFO).

fMask

Jenis: UINT

Menunjukkan anggota yang akan diambil atau diatur. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

fType

Jenis: UINT

Jenis item menu. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai MFT_BITMAP, MFT_SEPARATOR, dan MFT_STRING tidak dapat digabungkan satu sama lain. Atur fMask ke MIIM_TYPE untuk menggunakan fType.

fType hanya digunakan jika fMask memiliki nilai MIIM_FTYPE.

fState

Jenis: UINT

Status item menu. Anggota ini bisa menjadi satu atau beberapa nilai ini. Atur fMask ke MIIM_STATE untuk menggunakan fState.

wID

Jenis: UINT

Nilai yang ditentukan aplikasi yang mengidentifikasi item menu. Atur fMask ke MIIM_ID untuk menggunakan wID.

hSubMenu

Jenis: HMENU

Handel ke menu drop-down atau submenu yang terkait dengan item menu. Jika item menu bukan item yang membuka menu drop-down atau submenu, anggota ini adalah NULL. Atur fMask ke MIIM_SUBMENU untuk menggunakan hSubMenu.

hbmpChecked

Jenis: HBITMAP

Handel ke bitmap untuk ditampilkan di samping item jika dipilih. Jika anggota ini NULL, bitmap default akan digunakan. Jika nilai jenis MFT_RADIOCHECK ditentukan, bitmap default adalah poin. Jika tidak, itu adalah tanda centang. Atur fMask ke MIIM_CHECKMARKS untuk menggunakan hbmpChecked.

hbmpUnchecked

Jenis: HBITMAP

Handel ke bitmap untuk ditampilkan di samping item jika tidak dipilih. Jika anggota ini NULL, tidak ada bitmap yang digunakan. Atur fMask ke MIIM_CHECKMARKS untuk menggunakan hbmpUnchecked.

dwItemData

Jenis: ULONG_PTR

Nilai yang ditentukan aplikasi yang terkait dengan item menu. Atur fMask ke MIIM_DATA untuk menggunakan dwItemData.

dwTypeData

Jenis: LPTSTR

Isi item menu. Arti anggota ini tergantung pada nilai fType dan hanya digunakan jika bendera MIIM_TYPE diatur dalam anggota fMask .

Untuk mengambil item menu jenis MFT_STRING, pertama-tama temukan ukuran string dengan mengatur anggota dwTypeDatamenuITEMINFO ke NULL lalu memanggil GetMenuItemInfo. Nilai cch+1 adalah ukuran yang diperlukan. Kemudian alokasikan buffer ukuran ini, letakkan pointer ke buffer di dwTypeData, tahapan cch, dan panggil GetMenuItemInfo sekali lagi untuk mengisi buffer dengan string. Jika item menu yang diambil dari beberapa jenis lain, maka GetMenuItemInfo mengatur anggota dwTypeData ke nilai yang jenisnya ditentukan oleh anggota fType .

Saat menggunakan dengan fungsi SetMenuItemInfo , anggota ini harus berisi nilai yang jenisnya ditentukan oleh anggota fType .

dwTypeData hanya digunakan jika bendera MIIM_STRING diatur di anggota fMask

cch

Jenis: UINT

Panjang teks item menu, dalam karakter, saat informasi diterima tentang item menu dari jenis MFT_STRING . Namun, cch hanya digunakan jika bendera MIIM_TYPE diatur dalam anggota fMask dan nol sebaliknya. Selain itu, cch diabaikan ketika konten item menu diatur dengan memanggil SetMenuItemInfo.

Perhatikan bahwa, sebelum memanggil GetMenuItemInfo, aplikasi harus mengatur cch ke panjang buffer yang diarahkan oleh anggota dwTypeData . Jika item menu yang diambil berjenis MFT_STRING (seperti yang ditunjukkan oleh anggota fType ), maka GetMenuItemInfo mengubah cch menjadi panjang teks item menu. Jika item menu yang diambil dari beberapa jenis lain, GetMenuItemInfo mengatur bidang cch ke nol.

Anggota cch digunakan ketika bendera MIIM_STRING diatur dalam anggota fMask .

hbmpItem

Jenis: HBITMAP

Handel ke bitmap yang akan ditampilkan, atau bisa menjadi salah satu nilai dalam tabel berikut. Ini digunakan ketika bendera MIIM_BITMAP diatur dalam anggota fMask .

Struktur MENUITEMINFO digunakan dengan fungsi GetMenuItemInfo, InsertMenuItem, dan SetMenuItemInfo .

Menu dapat menampilkan item menggunakan teks, bitmap, atau keduanya.

Konseptual

GetMenuItemInfo

InsertMenuItem

Menu

Referensi

SetMenuItemInfo

WM_DRAWITEM

WM_MEASUREITEM