RemoveMenu-Funktion (winuser.h)

Artikel
03/13/2024

Löscht ein Menüelement oder trennt ein Untermenü aus dem angegebenen Menü. Wenn das Menüelement ein Dropdownmenü oder untermenü öffnet, zerstört RemoveMenu das Menü oder den zugehörigen Handle nicht, sodass das Menü wiederverwendet werden kann. Bevor diese Funktion aufgerufen wird, sollte die GetSubMenu-Funktion ein Handle im Dropdownmenü oder Untermenü abrufen.

Syntax

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

Parameter

[in] hMenu

Typ: HMENU

Ein Handle für das zu ändernde Menü.

[in] uPosition

Typ: UINT

Das zu löschende Menüelement, wie durch den uFlags-Parameter bestimmt.

[in] uFlags

Typ: UINT

Gibt an, wie der uPosition-Parameter interpretiert wird. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
MF_BYCOMMAND 0x00000000L	Gibt an, dass uPosition den Bezeichner des Menüelements angibt. Wenn weder das MF_BYCOMMAND - noch MF_BYPOSITION-Flag angegeben wird, ist das MF_BYCOMMAND-Flag das Standardflagge.
MF_BYPOSITION 0x00000400L	Gibt an, dass uPosition die nullbasierte relative Position des Menüelements angibt.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Anwendung muss die DrawMenuBar-Funktion aufrufen, wenn sich ein Menü ändert, unabhängig davon, ob sich das Menü in einem angezeigten Fenster befindet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-menu-l1-1-0 (eingeführt in Windows 8)