Fungsi SetMenuItemBitmaps (winuser.h)

Artikel
08/28/2023

Mengaitkan bitmap yang ditentukan dengan item menu. Apakah item menu dipilih atau dihapus, sistem menampilkan bitmap yang sesuai di samping item menu.

Sintaks

BOOL SetMenuItemBitmaps(
  [in]           HMENU   hMenu,
  [in]           UINT    uPosition,
  [in]           UINT    uFlags,
  [in, optional] HBITMAP hBitmapUnchecked,
  [in, optional] HBITMAP hBitmapChecked
);

Parameter

[in] hMenu

Jenis: HMENU

Handel ke menu yang berisi item untuk menerima bitmap tanda centang baru.

[in] uPosition

Jenis: UINT

Item menu yang akan diubah, seperti yang ditentukan oleh parameter uFlags .

[in] uFlags

Jenis: UINT

Menentukan bagaimana parameter uPosition akan ditafsirkan. Parameter uFlags harus menjadi salah satu nilai berikut.

Nilai	Makna
MF_BYCOMMAND 0x00000000L	Menunjukkan bahwa uPosisi memberikan pengidentifikasi item menu. Jika MF_BYCOMMAND atau MF_BYPOSITION tidak ditentukan, MF_BYCOMMAND adalah bendera default.
MF_BYPOSITION 0x00000400L	Menunjukkan bahwa uPosisi memberikan posisi relatif berbasis nol dari item menu.

[in, optional] hBitmapUnchecked

Jenis: HBITMAP

Handel ke bitmap ditampilkan ketika item menu tidak dipilih.

[in, optional] hBitmapChecked

Jenis: HBITMAP

Handel ke bitmap ditampilkan ketika item menu dipilih.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika parameter hBitmapUnchecked atau hBitmapChecked adalah NULL, sistem tidak menampilkan apa pun di samping item menu untuk status pemeriksaan yang sesuai. Jika kedua parameter adalah NULL, sistem menampilkan bitmap tanda centang default saat item dipilih, dan menghapus bitmap saat item tidak dipilih.

Ketika menu dihancurkan, bitmap ini tidak dihancurkan; terserah aplikasi untuk menghancurkannya.

Bitmap yang dipilih dan jelas harus monokrom. Sistem ini menggunakan operator Boolean AND untuk menggabungkan bitmap dengan menu sehingga bagian putih menjadi transparan dan bagian hitam menjadi warna menu-item. Jika Anda menggunakan bitmap warna, hasilnya mungkin tidak diinginkan.

Gunakan fungsi GetSystemMetrics dengan nilai SM_CXMENUCHECK dan SM_CYMENUCHECK untuk mengambil dimensi bitmap.

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

Bagikan melalui