estrutura XINPUT_KEYSTROKE (xinput.h)
Especifica os dados de pressionamento de tecla retornados por XInputGetKeystroke.
Sintaxe
typedef struct _XINPUT_KEYSTROKE {
WORD VirtualKey;
WCHAR Unicode;
WORD Flags;
BYTE UserIndex;
BYTE HidCode;
} XINPUT_KEYSTROKE, *PXINPUT_KEYSTROKE;
Membros
VirtualKey
Código de chave virtual da tecla, botão ou movimento do joystick. Consulte XInput.h para obter uma lista de códigos válidos de chave virtual (VK_xxx). Além disso, consulte Comentários.
Unicode
Esse membro não é utilizado e o valor é zero.
Flags
Sinalizadores que indicam o estado do teclado no momento do evento de entrada. Esse membro pode ser qualquer combinação dos seguintes sinalizadores:
| Valor | Descrição |
|---|---|
| XINPUT_KEYSTROKE_KEYDOWN | A tecla foi pressionada. |
| XINPUT_KEYSTROKE_KEYUP | A chave foi liberada. |
| XINPUT_KEYSTROKE_REPEAT | Uma repetição de uma chave mantida. |
UserIndex
Índice do jogador conectado associado ao dispositivo. Pode ser um valor no intervalo de 0 a 3.
HidCode
Código HID correspondente à entrada. Se não houver nenhum código HID correspondente, esse valor será zero.
Comentários
Dispositivos futuros podem retornar códigos HID e valores de chave virtual que não têm suporte em dispositivos atuais e atualmente são indefinidos. Os aplicativos devem ignorar esses valores inesperados.
Um código de tecla virtual é um valor de byte que representa uma tecla física específica no teclado, não o caractere ou caracteres (possivelmente nenhum) para o qual a tecla pode ser mapeada com base no estado do teclado. O estado do teclado no momento em que uma tecla virtual é pressionada modifica o caractere relatado. Por exemplo, VK_4 pode representar um "4" ou um "$", dependendo do estado da chave SHIFT.
Um evento de teclado relatado inclui a tecla virtual que causou o evento, se a tecla foi pressionada ou liberada (ou está se repetindo) e o estado do teclado no momento do evento. O estado do teclado inclui informações sobre se as teclas CTRL, ALT ou SHIFT estão inativas.
Se o evento de teclado representar um caractere Unicode (por exemplo, pressionando a tecla "A"), o membro Unicode conterá esse caractere. Caso contrário, Unicode conterá o valor zero.
Os códigos válidos de chave virtual (VK_xxx) são definidos em XInput.h. Além dos códigos que indicam pressionamentos de tecla, os códigos a seguir indicam a entrada do controlador.
| Valor | Descrição |
|---|---|
| VK_PAD_A | Um botão |
| VK_PAD_B | Botão B |
| VK_PAD_X | Botão X |
| VK_PAD_Y | Botão Y |
| VK_PAD_RSHOULDER | Botão direito do ombro |
| VK_PAD_LSHOULDER | Botão do ombro esquerdo |
| VK_PAD_LTRIGGER | Gatilho esquerdo |
| VK_PAD_RTRIGGER | Gatilho direito |
| VK_PAD_DPAD_UP | Direcional para cima |
| VK_PAD_DPAD_DOWN | Direcional para baixo |
| VK_PAD_DPAD_LEFT | Teclado direcional para a esquerda |
| VK_PAD_DPAD_RIGHT | Direcional para a direita |
| VK_PAD_START | Botão INICIAR |
| VK_PAD_BACK | Botão VOLTAR |
| VK_PAD_LTHUMB_PRESS | Clique no botão esquerdo |
| VK_PAD_RTHUMB_PRESS | Clique no botão direito do mouse |
| VK_PAD_LTHUMB_UP | Botão esquerdo para cima |
| VK_PAD_LTHUMB_DOWN | Botão esquerdo para baixo |
| VK_PAD_LTHUMB_RIGHT | Polegar esquerdo para a direita |
| VK_PAD_LTHUMB_LEFT | Botão esquerdo esquerdo |
| VK_PAD_LTHUMB_UPLEFT | Botão esquerdo para cima e para a esquerda |
| VK_PAD_LTHUMB_UPRIGHT | Botão esquerdo para cima e para a direita |
| VK_PAD_LTHUMB_DOWNRIGHT | Botão esquerdo para baixo e para a direita |
| VK_PAD_LTHUMB_DOWNLEFT | Botão esquerdo para baixo e para a esquerda |
| VK_PAD_RTHUMB_UP | Botão direito para cima |
| VK_PAD_RTHUMB_DOWN | Botão direito para baixo |
| VK_PAD_RTHUMB_RIGHT | Botão direito para a direita |
| VK_PAD_RTHUMB_LEFT | Botão direito para a esquerda |
| VK_PAD_RTHUMB_UPLEFT | Botão direito para cima e para a esquerda |
| VK_PAD_RTHUMB_UPRIGHT | Botão direito para cima e para a direita |
| VK_PAD_RTHUMB_DOWNRIGHT | Botão direito para baixo e para a direita |
| VK_PAD_RTHUMB_DOWNLEFT | Polegar direito para baixo e para a esquerda |
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | xinput.h |