DeleteMenu-Funktion (winuser.h)

Artikel
08/27/2023

Löscht ein Element aus dem angegebenen Menü. Wenn das Menüelement ein Menü oder Untermenü öffnet, zerstört diese Funktion den Handle zum Menü oder Untermenü und gibt den vom Menü oder Untermenü verwendeten Arbeitsspeicher frei.

Syntax

BOOL DeleteMenu(
  [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. Das MF_BYCOMMAND-Flag ist das Standardflag, wenn weder das MF_BYCOMMAND noch MF_BYPOSITION-Flag angegeben ist.
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.

Beispiele

Ein Beispiel finden Sie unter Beispiel für eine Zwischenablageanzeige.

Anforderungen


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 (in Windows 8 eingeführt)