WM_SYSCOMMAND message
Une fenêtre reçoit ce message lorsque l’utilisateur choisit une commande dans le menu Fenêtre (anciennement menu système ou contrôle) ou lorsque l’utilisateur choisit le bouton agrandir, réduire, restaurer ou fermer.
#define WM_SYSCOMMAND 0x0112
Exemple
case WM_SYSCOMMAND:
if ((wParam & 0xFFF0) == SC_CLOSE)
{
EndDialog (hDlg, TRUE);
return(TRUE);
}
break;
Exemples classiques Windows sur GitHub.
Paramètres
-
wParam
-
Type de commande système demandée. Ce paramètre peut prendre les valeurs suivantes.
Valeur Signification - SC_CLOSE
- 0xF060
Ferme la fenêtre. - SC_CONTEXTHELP
- 0xF180
Remplace le curseur par un point d’interrogation avec un pointeur. Si l’utilisateur clique ensuite sur un contrôle dans la boîte de dialogue, celui-ci reçoit un message WM_HELP . - SC_DEFAULT
- 0xF160
Sélectionne l’élément par défaut ; l’utilisateur a double-cliqué sur le menu de la fenêtre. - SC_HOTKEY
- 0xF150
Active la fenêtre associée à la touche de raccourci spécifiée par l’application. Le paramètre lParam identifie la fenêtre à activer. - SC_HSCROLL
- 0xF080
Fait défiler horizontalement. - SCF_ISSECURE
- 0x00000001
Indique si l’économiseur d’écran est sécurisé. - SC_KEYMENU
- 0xF100
Récupère le menu de la fenêtre à la suite d’une frappe. Pour plus d'informations, consultez la section Notes. - SC_MAXIMIZE
- 0xF030
Agrandit la fenêtre. - SC_MINIMIZE
- 0xF020
Réduit la fenêtre. - SC_MONITORPOWER
- 0xF170
Définit l’état de l’affichage. Cette commande prend en charge les appareils qui ont des fonctionnalités d’économie d’énergie, comme un ordinateur personnel alimenté par batterie.
Le paramètre lParam peut avoir les valeurs suivantes :- -1 (l’affichage s’allume)
- 1 (l’affichage va à faible puissance)
- 2 (l’affichage est en cours d’arrêt)
- SC_MOUSEMENU
- 0xF090
Récupère le menu de la fenêtre à la suite d’un clic de souris. - SC_MOVE
- 0xF010
Déplace la fenêtre. - SC_NEXTWINDOW
- 0xF040
Passe à la fenêtre suivante. - SC_PREVWINDOW
- 0xF050
Se déplace vers la fenêtre précédente. - SC_RESTORE
- 0xF120
Restaure la position et la taille normales de la fenêtre. - SC_SCREENSAVE
- 0xF140
Exécute l’application d’économiseur d’écran spécifiée dans la section [démarrage] du fichier System.ini. - SC_SIZE
- 0xF000
Dimensionne la fenêtre. - SC_TASKLIST
- 0xF130
Active le menu Démarrer . - SC_VSCROLL
- 0xF070
Fait défiler verticalement. -
lParam
-
Le mot d’ordre bas spécifie la position horizontale du curseur, dans les coordonnées de l’écran, si une commande de menu de fenêtre est choisie avec la souris. Sinon, ce paramètre n’est pas utilisé.
Le mot d’ordre élevé spécifie la position verticale du curseur, dans les coordonnées de l’écran, si une commande de menu de fenêtre est choisie avec la souris. Ce paramètre est 1 si la commande est choisie à l’aide d’un accélérateur système, ou zéro si vous utilisez un mnémonique.
Valeur retournée
Une application doit retourner zéro si elle traite ce message.
Notes
Pour obtenir les coordonnées de position dans les coordonnées d’écran, utilisez le code suivant :
xPos = GET_X_LPARAM(lParam); // horizontal position
yPos = GET_Y_LPARAM(lParam); // vertical position
La fonction DefWindowProc exécute la demande de menu de fenêtre pour les actions prédéfinies spécifiées dans le tableau précédent.
Dans WM_SYSCOMMAND messages, les quatre bits d’ordre inférieur du paramètre wParam sont utilisés en interne par le système. Pour obtenir le résultat correct lors du test de la valeur de wParam, une application doit combiner la valeur 0xFFF0 avec la valeur wParam à l’aide de l’opérateur AND au niveau du bit.
Les éléments de menu d’un menu de fenêtre peuvent être modifiés à l’aide des fonctions GetSystemMenu, AppendMenu, InsertMenu, ModifyMenu, InsertMenuItem et SetMenuItemInfo . Les applications qui modifient le menu de la fenêtre doivent traiter WM_SYSCOMMAND messages.
Une application peut exécuter n’importe quelle commande système à tout moment en transmettant un message WM_SYSCOMMAND à DefWindowProc. Tous les messages WM_SYSCOMMAND non gérés par l’application doivent être passés à DefWindowProc. Toutes les valeurs de commande ajoutées par une application doivent être traitées par l’application et ne peuvent pas être transmises à DefWindowProc.
Si la protection par mot de passe est activée par la stratégie, l’économiseur d’écran est démarré indépendamment de ce qu’une application fait avec la notification SC_SCREENSAVE même si ne parvient pas à la transmettre à DefWindowProc.
Les touches d’accélérateur définies pour choisir des éléments dans le menu de la fenêtre sont converties en messages WM_SYSCOMMAND ; toutes les autres frappes d’accélérateur sont traduites en messages WM_COMMAND .
Si le wParam est SC_KEYMENU, lParam contient le code de caractère de la clé utilisée avec la touche ALT pour afficher le menu contextuel. Par exemple, en appuyant sur ALT+F pour afficher la fenêtre contextuelle Fichier, un WM_SYSCOMMAND avec wParam égal à SC_KEYMENU et lParam égal à 'f'.
Spécifications
| 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] |
| En-tête |
|
Voir aussi
-
Référence
-
Conceptuel