Fungsi SetMenuItemBitmaps (winuser.h)

  • Artikel

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

Lihat juga

Menu