Fungsi RemoveMenu (winuser.h)

Artikel
03/13/2024

Menghapus item menu atau mencopot submenu dari menu yang ditentukan. Jika item menu membuka menu drop-down atau submenu, RemoveMenu tidak menghancurkan menu atau handelnya, memungkinkan menu digunakan kembali. Sebelum fungsi ini dipanggil, fungsi GetSubMenu harus mengambil handel ke menu drop-down atau submenu.

Sintaks

BOOL RemoveMenu(
  [in] HMENU hMenu,
  [in] UINT  uPosition,
  [in] UINT  uFlags
);

Parameter

[in] hMenu

Jenis: HMENU

Handel ke menu yang akan diubah.

[in] uPosition

Jenis: UINT

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

[in] uFlags

Jenis: UINT

Menunjukkan bagaimana parameter uPosisi ditafsirkan. Parameter ini harus menjadi salah satu nilai berikut.

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

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.

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)