GetKeyState, fonction (winuser.h)

Récupère l’état de la clé virtuelle spécifiée. L’état spécifie si la touche est vers le haut, vers le bas ou bascule (activée, désactivée, en alternant chaque fois que la touche est enfoncée).

Syntaxe

SHORT GetKeyState(
  [in] int nVirtKey
);

Paramètres

[in] nVirtKey

Type : int

Clé virtuelle. Si la clé virtuelle souhaitée est une lettre ou un chiffre (A à Z, a z ou 0 à 9), nVirtKey doit être défini sur la valeur ASCII de ce caractère. Pour d’autres clés, il doit s’agir d’un code de clé virtuelle.

Si une disposition de clavier autre que l’anglais est utilisée, les touches virtuelles avec des valeurs de la plage ASCII A à Z et 0 à 9 sont utilisées pour spécifier la plupart des touches de caractères. Par exemple, pour la disposition du clavier allemand, la clé virtuelle de valeur ASCII O (0x4F) fait référence à la touche « o », tandis que VK_OEM_1 fait référence à la touche « o with umlaut ».

Valeur retournée

Type : SHORT

La valeur de retour spécifie l’état de la clé virtuelle spécifiée, comme suit :

• Si le bit d’ordre élevé est 1, la clé est en panne ; sinon, c’est là.
• Si le bit de faible ordre est 1, la clé est activée. Une clé, telle que la clé CAPS LOCK, est activée si elle est activée. La clé est désactivée et désactivée si le bit de faible ordre est 0. La lumière d’indicateur d’indicateur d’une touche bascule (le cas échéant) sur le clavier est activée lorsque la touche est basculée et désactivée lorsque la touche est déboguée.

Remarques

L’état de la clé retourné par cette fonction change en tant que thread lit les messages clés de sa file d’attente de messages. L’état ne reflète pas l’état de niveau interruption associé au matériel. Utilisez la fonction GetAsyncKeyState pour récupérer ces informations.

Une application appelle GetKeyState en réponse à un message d’entrée au clavier. Cette fonction récupère l’état de la clé lorsque le message d’entrée a été généré.

Pour récupérer les informations d’état de toutes les clés virtuelles, utilisez la fonction GetKeyboardState .

Une application peut utiliser les constantes de code de clé virtuelleVK_SHIFT, VK_CONTROL et VK_MENU comme valeurs pour le paramètre nVirtKey . Cela donne l’état des touches Maj, Ctrl ou Alt sans distinguer les touches gauche et droite. Une application peut également utiliser les constantes de code de clé virtuelle suivantes comme valeurs pour nVirtKey pour faire la distinction entre les instances de gauche et de droite de ces clés :

VK_LSHIFTVK_RSHIFTVK_LCONTROLVK_RCONTROLVK_LMENUVK_RMENU Ces constantes de gauche et de droite sont disponibles uniquement pour une application via les fonctions GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyState et MapVirtualKey.

Examples

Pour obtenir un exemple, consultez Affichage de l’entrée du clavier.

Spécifications

Voir aussi

• GetAsyncKeyState
• GetKeyState
• GetKeyboardState
• MapVirtualKey
• SetKeyboardState
• Entrée du clavier