_Message WM SETHOTKEY

Envoyé à une fenêtre pour associer une touche d’accès rapide à la fenêtre. Quand l’utilisateur appuie sur la touche d’accès rapide, le système active la fenêtre.

#define WM_SETHOTKEY                    0x0032

Paramètres

wParam

Le mot de poids faible spécifie le code de la touche virtuelle à associer à la fenêtre.

Le mot de poids fort peut être une ou plusieurs des valeurs suivantes à partir de CommCtrl. h.

Le fait de définir wParam sur null supprime la touche d’accès rapide associée à une fenêtre.

Valeur Signification
HOTKEYF _ ALT
0x04
touche ALT
HOTKEYF _ CONTRÔLE
0x02
Touche CTRL
HOTKEYF _
0x08
de l’ext.
Clé étendue
HOTKEYF _ DÉCALAGE
0x01
Touche Maj

lParam

Ce paramètre n'est pas utilisé.

Valeur de retour

La valeur de retour est l’une des suivantes.

Valeur de retour Description
-1
La fonction échoue ; la touche d’accès rapide n’est pas valide.
0
La fonction échoue ; la fenêtre n’est pas valide.
1
La fonction est réussie et aucune autre fenêtre n’a la même touche d’accès rapide.
2
La fonction réussit, mais une autre fenêtre a déjà la même touche d’accès rapide.

Notes

Une touche d’accès rapide ne peut pas être associée à une fenêtre enfant.

VK _ Les touches d’accès rapide, d' _ espace de VK et de VK _ sont des touches d’accès non valides.

Quand l’utilisateur appuie sur la touche d’accès rapide, le système génère un message WM _ SYSCOMMAND avec wParam égal à SC _ Hotkey et lParam égal au handle de la fenêtre. Si ce message est transmis à DefWindowProc, le système affiche la dernière fenêtre active de la fenêtre (si elle existe) ou la fenêtre elle-même (s’il n’y a pas de fenêtre contextuelle) au premier plan.

Une fenêtre ne peut avoir qu’une seule touche d’accès rapide. Si la fenêtre est déjà associée à une touche d’accès rapide, la nouvelle touche d’accès rapide remplace l’ancienne. Si plusieurs fenêtres possèdent la même touche d’accès rapide, la fenêtre qui est activée par la touche d’accès rapide est aléatoire.

Ces touches d’accès rapide ne sont pas liées aux touches d’accès rapide définies par RegisterHotKey.

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
Winuser. h (inclure Windows. h)

Voir aussi

Référence

RegisterHotKey

_GETHOTKEY WM

_SYSCOMMAND WM

Conceptuel

Entrée au clavier