Freigeben über


RemoveMenu-Funktion (winuser.h)

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)

Siehe auch

Konzept

CreatePopupMenu

DeleteMenu

DrawMenuBar

GetSubMenu

Menüs

Referenz