Partager via


structure XINPUT_KEYSTROKE (xinput.h)

Spécifie les données de frappe retournées par XInputGetKeystroke.

Syntaxe

typedef struct _XINPUT_KEYSTROKE {
  WORD  VirtualKey;
  WCHAR Unicode;
  WORD  Flags;
  BYTE  UserIndex;
  BYTE  HidCode;
} XINPUT_KEYSTROKE, *PXINPUT_KEYSTROKE;

Membres

VirtualKey

Code de clé virtuelle de la touche, du bouton ou du mouvement du stick. Consultez XInput.h pour obtenir la liste des codes de clé virtuelle (VK_xxx) valides. Consultez également Remarques.

Unicode

Ce membre n’est pas utilisé et la valeur est égale à zéro.

Flags

Indicateurs qui indiquent l’état du clavier au moment de l’événement d’entrée. Ce membre peut être n’importe quelle combinaison des indicateurs suivants :

Valeur Description
XINPUT_KEYSTROKE_KEYDOWN La touche a été enfoncée. 
XINPUT_KEYSTROKE_KEYUP La clé a été libérée. 
XINPUT_KEYSTROKE_REPEAT Répétition d’une clé conservée. 

UserIndex

Index du joueur connecté associé à l’appareil. Il peut s’agir d’une valeur comprise entre 0 et 3.

HidCode

Code HID correspondant à l’entrée. S’il n’existe aucun code HID correspondant, cette valeur est égale à zéro.

Remarques

Les appareils futurs peuvent retourner des codes HID et des valeurs de clé virtuelle qui ne sont pas pris en charge sur les appareils actuels et qui ne sont actuellement pas définis. Les applications doivent ignorer ces valeurs inattendues.

Un code de clé virtuelle est une valeur d’octet qui représente une touche physique particulière sur le clavier, et non le caractère ou les caractères ( peut-être aucun) auxquels la touche peut être mappée en fonction de l’état du clavier. L’état du clavier au moment où une touche virtuelle est enfoncée modifie le caractère signalé. Par exemple, VK_4 peut représenter un « 4 » ou un « $ », selon l’état de la touche MAJ.

Un événement de clavier signalé inclut la touche virtuelle à l’origine de l’événement, si la touche a été enfoncée ou relâchée (ou se répète) et l’état du clavier au moment de l’événement. L’état du clavier inclut des informations indiquant si les touches CTRL, ALT ou MAJ sont arrêtées.

Si l’événement de clavier représente un caractère Unicode (par exemple, en appuyant sur la touche « A »), le membre Unicode contient ce caractère. Sinon, Unicode contiendra la valeur zéro.

Les codes de clé virtuelle (VK_xxx) valides sont définis dans XInput.h. En plus des codes qui indiquent des appuis sur la touche, les codes suivants indiquent l’entrée du contrôleur.

Valeur Description
VK_PAD_A Bouton
VK_PAD_B Bouton B
VK_PAD_X Bouton X
VK_PAD_Y Bouton Y
VK_PAD_RSHOULDER Épaule droite
VK_PAD_LSHOULDER Épaule gauche
VK_PAD_LTRIGGER Gâchette gauche
VK_PAD_RTRIGGER Gâchette droite
VK_PAD_DPAD_UP Pavé directionnel vers le haut
VK_PAD_DPAD_DOWN Pavé directionnel vers le bas
VK_PAD_DPAD_LEFT Pavé directionnel gauche
VK_PAD_DPAD_RIGHT Pavé directionnel vers la droite
VK_PAD_START Bouton DÉMARRER
VK_PAD_BACK Bouton PRÉCÉDENT
VK_PAD_LTHUMB_PRESS Cliquez sur la touche gauche
VK_PAD_RTHUMB_PRESS Cliquez sur le bouton droit
VK_PAD_LTHUMB_UP Baguette gauche vers le haut
VK_PAD_LTHUMB_DOWN Baguette gauche vers le bas
VK_PAD_LTHUMB_RIGHT Stick gauche droite
VK_PAD_LTHUMB_LEFT Touche gauche gauche
VK_PAD_LTHUMB_UPLEFT Baguette gauche vers le haut et la gauche
VK_PAD_LTHUMB_UPRIGHT Baguette gauche vers le haut et vers la droite
VK_PAD_LTHUMB_DOWNRIGHT Touche gauche vers le bas et la droite
VK_PAD_LTHUMB_DOWNLEFT Baguette gauche vers le bas et la gauche
VK_PAD_RTHUMB_UP Stick analogique droit vers le haut
VK_PAD_RTHUMB_DOWN Stick analogique droit vers le bas
VK_PAD_RTHUMB_RIGHT Stick analogique droit vers la droite
VK_PAD_RTHUMB_LEFT Stick analogique droit vers la gauche
VK_PAD_RTHUMB_UPLEFT Bâton droit vers le haut et vers la gauche
VK_PAD_RTHUMB_UPRIGHT Bâton droit vers le haut et vers la droite
VK_PAD_RTHUMB_DOWNRIGHT Bâton droit vers le bas et vers la droite
VK_PAD_RTHUMB_DOWNLEFT Bâton droit vers le bas et la gauche

Configuration requise

Condition requise Valeur
En-tête xinput.h

Voir aussi

XInputGetKeystroke