GetSystemMenu-Funktion (winuser.h)

Artikel
03/04/2024

Ermöglicht der Anwendung den Zugriff auf das Fenstermenü (auch als Systemmenü oder Steuerungsmenü bezeichnet) zum Kopieren und Ändern.

Syntax

HMENU GetSystemMenu(
  [in] HWND hWnd,
  [in] BOOL bRevert
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster, das eine Kopie des Fenstermenüs besitzt.

[in] bRevert

Typ: BOOL

Die zu ergreifende Aktion. Wenn dieser Parameter FALSE ist, gibt GetSystemMenu ein Handle an die Kopie des derzeit verwendeten Fenstermenüs zurück. Die Kopie ist zunächst mit dem Fenstermenü identisch, kann aber geändert werden. Wenn dieser Parameter TRUE ist, setzt GetSystemMenu das Fenstermenü wieder auf den Standardzustand zurück. Falls vorhanden, wird das Menü des vorherigen Fensters zerstört.

Rückgabewert

Typ: HMENU

Wenn der bRevert-ParameterFALSE ist, ist der Rückgabewert ein Handle für eine Kopie des Fenstermenüs. Wenn der bRevert-ParameterTRUE ist, ist der Rückgabewert NULL.

Hinweise

Jedes Fenster, das nicht die GetSystemMenu-Funktion verwendet, um eine eigene Kopie des Fenstermenüs zu erstellen, erhält das Standardfenstermenü.

Das Fenstermenü enthält zunächst Elemente mit verschiedenen Bezeichnerwerten, z. B. SC_CLOSE, SC_MOVE und SC_SIZE.

Menüelemente im Fenstermenü senden WM_SYSCOMMAND Nachrichten.

Alle vordefinierten Fenstermenüelemente weisen Bezeichnernummern auf, die größer als 0xF000 sind. Wenn eine Anwendung dem Fenstermenü Befehle hinzufügt, sollten Bezeichnernummern verwendet werden, die kleiner als 0xF000 sind.

Je nach Situation graut das System Elemente im Standardfenstermenü automatisch ab. Die Anwendung kann eine eigene Überprüfung oder Grauung durchführen, indem sie auf die WM_INITMENU Nachricht reagiert, die gesendet wird, bevor ein Menü angezeigt wird.

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-0 (eingeführt in Windows 8)