Fungsi AppendMenuA (winuser.h)

Menambahkan item baru ke akhir bilah menu, menu drop-down, submenu, atau menu pintasan yang ditentukan. Anda dapat menggunakan fungsi ini untuk menentukan konten, tampilan, dan perilaku item menu.

Sintaks

BOOL AppendMenuA(
  [in]           HMENU    hMenu,
  [in]           UINT     uFlags,
  [in]           UINT_PTR uIDNewItem,
  [in, optional] LPCSTR   lpNewItem
);

Parameter

[in] hMenu

Jenis: HMENU

Handel ke bilah menu, menu drop-down, submenu, atau menu pintasan yang akan diubah.

[in] uFlags

Jenis: UINT

Mengontrol tampilan dan perilaku item menu baru. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai Makna
MF_BITMAP
0x00000004L
Menggunakan bitmap sebagai item menu. Parameter lpNewItem berisi handel ke bitmap.
MF_CHECKED
0x00000008L
Menempatkan tanda centang di samping item menu. Jika aplikasi menyediakan bitmap tanda centang (lihat SetMenuItemBitmaps, bendera ini menampilkan bitmap tanda centang di samping item menu.
MF_DISABLED
0x00000002L
Menonaktifkan item menu sehingga tidak dapat dipilih, tetapi bendera tidak berwarna abu-abu.
MF_ENABLED
0x00000000L
Memfungsikan item menu agar bisa dipilih, dan memulihkannya dari status abu-abu.
MF_GRAYED
0x00000001L
Nonaktifkan item menu dan abu-abu sehingga tidak dapat dipilih.
MF_MENUBARBREAK
0x00000020L
Fungsinya sama dengan bendera MF_MENUBREAK untuk bilah menu. Untuk menu drop-down, submenu, atau menu pintasan, kolom baru dipisahkan dari kolom lama dengan garis vertikal.
MF_MENUBREAK
0x00000040L
Menempatkan item pada baris baru (untuk bilah menu) atau di kolom baru (untuk menu drop-down, submenu, atau menu pintasan) tanpa memisahkan kolom.
MF_OWNERDRAW
0x00000100L
Menentukan bahwa item tersebut adalah item yang digambar pemilik. Sebelum menu ditampilkan untuk pertama kalinya, jendela yang memiliki menu menerima pesan WM_MEASUREITEM untuk mengambil lebar dan tinggi item menu. Pesan WM_DRAWITEM kemudian dikirim ke prosedur jendela jendela pemilik setiap kali tampilan item menu harus diperbarui.
MF_POPUP
0x00000010L
Menentukan bahwa item menu membuka menu drop-down atau submenu. Parameter uIDNewItem menentukan handel ke menu drop-down atau submenu. Bendera ini digunakan untuk menambahkan nama menu ke bilah menu, atau item menu yang membuka submenu ke menu drop-down, submenu, atau menu pintasan.
MF_SEPARATOR
0x00000800L
Menggambar garis pembagian horizontal. Bendera ini hanya digunakan di menu drop-down, submenu, atau menu pintasan. Garis tidak dapat berwarna abu-abu, dinonaktifkan, atau disorot. Parameter lpNewItem dan uIDNewItem diabaikan.
MF_STRING
0x00000000L
Menentukan bahwa item menu adalah string teks; parameter lpNewItem adalah penunjuk ke string.
MF_UNCHECKED
0x00000000L
Tidak menempatkan tanda centang di samping item (default). Jika aplikasi menyediakan bitmap tanda centang (lihat SetMenuItemBitmaps), bendera ini menampilkan bitmap yang jelas di samping item menu.

[in] uIDNewItem

Jenis: UINT_PTR

Pengidentifikasi item menu baru atau, jika parameter uFlags diatur ke MF_POPUP, handel ke menu drop-down atau submenu.

[in, optional] lpNewItem

Jenis: LPCTSTR

Konten item menu baru. Interpretasi lpNewItem tergantung pada apakah parameter uFlags menyertakan nilai berikut.

Nilai Makna
MF_BITMAP
0x00000004L
Berisi handel bitmap.
MF_OWNERDRAW
0x00000100L
Berisi nilai yang disediakan aplikasi yang dapat digunakan untuk mempertahankan data tambahan yang terkait dengan item menu. Nilai berada dalam anggota itemData dari struktur yang diacu oleh parameter lParam dari pesan WM_MEASUREITEM atau WM_DRAWITEM yang dikirim saat menu dibuat atau tampilannya diperbarui.
MF_STRING
0x00000000L
Berisi penunjuk ke string yang dihentikan null.

Mengembalikan nilai

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

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 . Untuk informasi selengkapnya, lihat Menu Gambar Pemilik dan Pesan WM_MENUCHAR.

Grup bendera berikut tidak dapat digunakan bersama-sama:

  • MF_BITMAP, MF_STRING, dan MF_OWNERDRAW
  • MF_CHECKED dan MF_UNCHECKED
  • MF_DISABLED, MF_ENABLED, dan MF_GRAYED
  • MF_MENUBARBREAK dan MF_MENUBREAK

Contoh

Misalnya, lihat Menambahkan Garis dan Grafik ke Menu.

Catatan

Header winuser.h mendefinisikan AppendMenu sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

   
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)

Lihat juga

Konseptual

CreateMenu

DeleteMenu

DestroyMenu

DrawMenuBar

InsertMenu

InsertMenuItem

Menu

ModifikasiMenu

Referensi

RemoveMenu

SetMenuItemBitmaps