XINPUT_KEYSTROKE struttura (xinput.h)

Specifica i dati di sequenza di tasti restituiti da XInputGetKeystroke.

Sintassi

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

Members

VirtualKey

Codice chiave virtuale del tasto, del pulsante o dello spostamento dello stick. Per un elenco di codici di chiave virtuale (VK_xxx) validi, vedere XInput.h. Vedere Anche le osservazioni.

Unicode

Questo membro è inutilizzato e il valore è zero.

Flags

Flag che indicano lo stato della tastiera al momento dell'evento di input. Questo membro può essere una combinazione dei flag seguenti:

Valore	Descrizione
XINPUT_KEYSTROKE_KEYDOWN	Il tasto è stato premuto.
XINPUT_KEYSTROKE_KEYUP	La chiave è stata rilasciata.
XINPUT_KEYSTROKE_REPEAT	Una ripetizione di una chiave mantenuta.

UserIndex

Indice del gamer connesso associato al dispositivo. Può essere un valore nell'intervallo 0-3.

HidCode

Codice HID corrispondente all'input. Se non esiste codice HID corrispondente, questo valore è zero.

Commenti

I dispositivi futuri possono restituire codici HID e valori di chiave virtuale non supportati nei dispositivi correnti e attualmente non definiti. Le applicazioni devono ignorare questi valori imprevisti.

Un codice chiave virtuale è un valore di byte che rappresenta un tasto fisico specifico sulla tastiera, non il carattere o i caratteri (possibilmente nessuno) a cui è possibile eseguire il mapping del tasto in base allo stato della tastiera. Lo stato della tastiera al momento in cui viene premuto un tasto virtuale modifica il carattere segnalato. Ad esempio, VK_4 potrebbe rappresentare un "4" o un "$", a seconda dello stato della chiave MAIUSC.

Un evento tastiera segnalato include il tasto virtuale che ha causato l'evento, se il tasto è stato premuto o rilasciato (o è ripetuto) e lo stato della tastiera al momento dell'evento. Lo stato della tastiera include informazioni su se i tasti CTRL, ALT o MAIUSC sono inattivi.

Se l'evento della tastiera rappresenta un carattere Unicode, ad esempio premendo il tasto "A", il membro Unicode conterrà tale carattere. In caso contrario, Unicode conterrà il valore zero.

I codici di chiave virtuale validi (VK_xxx) sono definiti in XInput.h. Oltre ai codici che indicano la pressione dei tasti, i codici seguenti indicano l'input del controller.

Valore	Descrizione
VK_PAD_A	Pulsante
VK_PAD_B	Pulsante B
VK_PAD_X	Pulsante X
VK_PAD_Y	Pulsante Y
VK_PAD_RSHOULDER	Pulsante spalla destra
VK_PAD_LSHOULDER	Pulsante spalla sinistra
VK_PAD_LTRIGGER	Trigger sinistro
VK_PAD_RTRIGGER	Trigger destro
VK_PAD_DPAD_UP	Riquadro direzionale su
VK_PAD_DPAD_DOWN	Riquadro direzionale verso il basso
VK_PAD_DPAD_LEFT	Riquadro direzionale sinistro
VK_PAD_DPAD_RIGHT	Riquadro direzionale destro
VK_PAD_START	Pulsante START
VK_PAD_BACK	Pulsante BACK
VK_PAD_LTHUMB_PRESS	Clic sul pollice sinistro
VK_PAD_RTHUMB_PRESS	Fare clic con il pulsante destro del mouse
VK_PAD_LTHUMB_UP	Pollice sinistro verso l'alto
VK_PAD_LTHUMB_DOWN	Pollice sinistro verso il basso
VK_PAD_LTHUMB_RIGHT	Pollice sinistro a destra
VK_PAD_LTHUMB_LEFT	Pollice sinistro sinistro
VK_PAD_LTHUMB_UPLEFT	Pollice sinistro verso l'alto e sinistra
VK_PAD_LTHUMB_UPRIGHT	Levetta sinistra verso l'alto e verso destra
VK_PAD_LTHUMB_DOWNRIGHT	Pollice sinistro verso il basso e destra
VK_PAD_LTHUMB_DOWNLEFT	Pollice sinistro verso il basso e sinistra
VK_PAD_RTHUMB_UP	Levetta destra su
VK_PAD_RTHUMB_DOWN	Levetta destra giù
VK_PAD_RTHUMB_RIGHT	Levetta destra a destra
VK_PAD_RTHUMB_LEFT	Levetta destra a sinistra
VK_PAD_RTHUMB_UPLEFT	Pollice destro verso l'alto e sinistra
VK_PAD_RTHUMB_UPRIGHT	Pollice destro verso l'alto e destra
VK_PAD_RTHUMB_DOWNRIGHT	Levetta destra verso il basso e destra
VK_PAD_RTHUMB_DOWNLEFT	Levetta destra verso il basso e sinistra

Requisiti

Requisito	Valore
Intestazione	xinput.h

Vedi anche

XInputGetKeystroke