DeleteMenu-Funktion (winuser.h)

  • Artikel

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)

Siehe auch

Konzept

DrawMenuBar

Menüs

Referenz

RemoveMenu