GetSystemMenu, fonction (winuser.h)

Article
08/27/2023

Permet à l’application d’accéder au menu de la fenêtre (également appelé menu système ou menu de contrôle) pour la copie et la modification.

Syntaxe

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

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre qui possédera une copie du menu de la fenêtre.

[in] bRevert

Type : BOOL

Action à entreprendre. Si ce paramètre a la valeur FALSE, GetSystemMenu retourne un handle à la copie du menu de fenêtre actuellement utilisé. La copie est initialement identique au menu de la fenêtre, mais elle peut être modifiée. Si ce paramètre a la valeur TRUE, GetSystemMenu rétablit l’état par défaut du menu de la fenêtre. Le menu de la fenêtre précédente, le cas échéant, est détruit.

Valeur retournée

Type : HMENU

Si le paramètre bRevert a la valeur FALSE, la valeur de retour est un handle pour une copie du menu de la fenêtre. Si le paramètre bRevert a la valeur TRUE, la valeur de retour est NULL.

Remarques

Toute fenêtre qui n’utilise pas la fonction GetSystemMenu pour créer sa propre copie du menu de la fenêtre reçoit le menu de la fenêtre standard.

Le menu de la fenêtre contient initialement des éléments avec différentes valeurs d’identificateur, telles que SC_CLOSE, SC_MOVE et SC_SIZE.

Les éléments de menu du menu de la fenêtre envoient WM_SYSCOMMAND messages.

Tous les éléments de menu de fenêtre prédéfinis ont des numéros d’identificateur supérieurs à 0xF000. Si une application ajoute des commandes au menu de la fenêtre, elle doit utiliser des numéros d’identificateur inférieurs à 0xF000.

Le système grise automatiquement les éléments du menu de la fenêtre standard, en fonction de la situation. L’application peut effectuer sa propre vérification ou grisage en répondant au message WM_INITMENU envoyé avant l’affichage d’un menu.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-menu-l1-1-0 (introduit dans Windows 8)