SetMenu-Funktion (winuser.h)

Weist dem angegebenen Fenster ein neues Menü zu.

Syntax

BOOL SetMenu(
  [in]           HWND  hWnd,
  [in, optional] HMENU hMenu
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster, dem das Menü zugewiesen werden soll.

[in, optional] hMenu

Typ: HMENU

Ein Handle zum neuen Menü. Wenn dieser Parameter NULL ist, wird das aktuelle Menü des Fensters entfernt.

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

Das Fenster wird neu gezeichnet, um die Menüänderung widerzuspiegeln. Ein Menü kann jedem Fenster zugewiesen werden, das kein untergeordnetes Fenster ist.

Die SetMenu-Funktion ersetzt das vorherige Menü, falls vorhanden, aber es wird nicht zerstört. Eine Anwendung sollte die DestroyMenu-Funktion aufrufen, um diese Aufgabe auszuführen.

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

Siehe auch

Konzept

DestroyMenu

GetMenu

Menüs

Referenz