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
Referenz