CreateMenu-Funktion (winuser.h)

Erstellt ein Menü. Das Menü ist zunächst leer, kann aber mit den Funktionen InsertMenuItem, AppendMenu und InsertMenu mit Menüelementen gefüllt werden.

Syntax

HMENU CreateMenu();

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

Ressourcen, die einem Menü zugeordnet sind, das einem Fenster zugewiesen ist, werden automatisch freigegeben. Wenn das Menü keinem Fenster zugewiesen ist, muss eine Anwendung Systemressourcen freigeben, die dem Menü zugeordnet sind, bevor sie geschlossen wird. Eine Anwendung gibt Menüressourcen frei, indem die DestroyMenu-Funktion aufgerufen wird.

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-2 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

AppendMenu

Konzept

CreatePopupMenu

DestroyMenu

InsertMenu

InsertMenuItem

Menüs

Referenz

SetMenu