GetSystemMenu, fonction (winuser.h)
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) |
Voir aussi
Conceptuel
Référence