Freigeben über


CreatePopupMenu-Funktion (winuser.h)

Erstellt ein Dropdownmenü, ein Untermenü oder ein Kontextmenü. Das Menü ist zunächst leer. Sie können Menüelemente mithilfe der InsertMenuItem-Funktion einfügen oder anfügen. Sie können auch die InsertMenu-Funktion zum Einfügen von Menüelementen und die AppendMenu-Funktion verwenden, um Menüelemente anzufügen.

Syntax

HMENU CreatePopupMenu();

Rückgabewert

Typ: HMENU

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das neu erstellte Menü.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Anwendung kann das neue Menü einem vorhandenen Menü hinzufügen oder ein Kontextmenü anzeigen, indem die Funktionen TrackPopupMenuEx oder TrackPopupMenu Aufgerufen werden.

Ressourcen, die einem Menü zugeordnet sind, das einem Fenster zugewiesen ist, werden automatisch freigegeben. Wenn das Menü nicht einem Fenster zugewiesen ist, muss eine Anwendung systemressourcen freigeben, die dem Menü zugeordnet sind, bevor sie geschlossen wird. Eine Anwendung gibt Menüressourcen durch Aufrufen der DestroyMenu-Funktion frei.

Beispiele

Ein Beispiel finden Sie unter Hinzufügen von Linien und Diagrammen zu einem Menü.

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 (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-menu-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

AppendMenu

Konzept

CreateMenu

DestroyMenu

EinfügenMenü

InsertMenuItem

Menüs

Referenz

SetMenu

Trackpopupmenu

TrackPopupMenuEx