Fungsi SetMenuItemInfoA (winuser.h)

Artikel
03/04/2024

Mengubah informasi tentang item menu.

Sintaks

BOOL SetMenuItemInfoA(
  [in] HMENU            hmenu,
  [in] UINT             item,
       BOOL             fByPositon,
  [in] LPCMENUITEMINFOA lpmii
);

Parameter

[in] hmenu

Jenis: HMENU

Handel ke menu yang berisi item menu.

[in] item

Jenis: UINT

Pengidentifikasi atau posisi item menu yang akan diubah. Arti parameter ini tergantung pada nilai fByPosition.

fByPositon

[in] lpmii

Jenis: LPMENUITEMINFO

Penunjuk ke struktur MENUITEMINFO yang berisi informasi tentang item menu dan menentukan atribut item menu mana yang akan diubah.

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, gunakan fungsi GetLastError .

Keterangan

Aplikasi harus memanggil fungsi DrawMenuBar setiap kali menu berubah, apakah menu berada di jendela yang ditampilkan.

Agar akselerator keyboard berfungsi dengan bitmap atau item menu yang digambar pemilik, pemilik menu harus memproses pesan WM_MENUCHAR . Lihat Menu Yang Digambar Pemilik dan Pesan WM_MENUCHAR untuk informasi selengkapnya.

Contoh

Misalnya, lihat Contoh Item Menu Owner-Drawn.

Catatan

Header winuser.h mendefinisikan SetMenuItemInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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)