Partager via


message WM_SETHOTKEY

Envoyé à une fenêtre pour associer une touche chaude à la fenêtre. Lorsque l’utilisateur appuie sur la touche chaude, le système active la fenêtre.

#define WM_SETHOTKEY                    0x0032

Paramètres

wParam

L’octet faible du mot de bas ordre spécifie le code de clé virtuelle à associer à la fenêtre.

L’octet élevé du mot de bas ordre peut être une ou plusieurs des valeurs suivantes de CommCtrl.h.

Valeur Sens
HOTKEYF_ALT
0x04
Touche Alt
HOTKEYF_CONTROL
0x02
Touche Ctrl
HOTKEYF_EXT
0x08
Clé étendue
HOTKEYF_SHIFT
0x01
Touche majuscule

Le mot d’ordre élevé de wParam est ignoré.

La définition de wParam sur NULL supprime la clé chaude associée à une fenêtre.

lParam

Ce paramètre n’est pas utilisé.

Valeur retournée

La valeur de retour est l’une des valeurs suivantes.

Valeur retournée Descriptif
-1
La fonction échoue ; la clé chaude n’est pas valide.
0
La fonction échoue ; la fenêtre n’est pas valide.
1
La fonction réussit et aucune autre fenêtre n’a la même touche à chaud.
2
La fonction réussit, mais une autre fenêtre a déjà la même touche à chaud.

Remarques

Une clé chaude ne peut pas être associée à une fenêtre enfant.

VK_ESCAPE, VK_SPACE, VK_TAB et VK_PACKET ne sont pas valides.

Lorsque l’utilisateur appuie sur la touche chaude, 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 amène la dernière fenêtre contextuelle active de la fenêtre (s’il 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 à chaud. Si la fenêtre a déjà une clé chaude associée, la nouvelle touche chaude remplace l’ancienne. Si plusieurs fenêtres ont la même touche chaude, la fenêtre activée par la clé chaude est aléatoire.

Ces touches chaudes ne sont pas liées aux clés chaudes définies par RegisterHotKey.

Spécifications

Besoin 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 de page
Winuser.h (y compris Windows.h)

Voir aussi

Référence

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

conceptuelle

d’entrée clavier