STRUCTURE KEYBDINPUT (winuser.h)

  • Article

Contient des informations sur un événement de clavier simulé.

Syntaxe

typedef struct tagKEYBDINPUT {
  WORD      wVk;
  WORD      wScan;
  DWORD     dwFlags;
  DWORD     time;
  ULONG_PTR dwExtraInfo;
} KEYBDINPUT, *PKEYBDINPUT, *LPKEYBDINPUT;

Membres

wVk

Type : WORD

Code de clé virtuelle. Le code doit être une valeur comprise entre 1 et 254. Si le membre dwFlags spécifie KEYEVENTF_UNICODE, wVk doit avoir la valeur 0.

wScan

Type : WORD

Code d’analyse matérielle pour la clé. Si dwFlags spécifie KEYEVENTF_UNICODE, wScan spécifie un caractère Unicode qui doit être envoyé à l’application de premier plan.

dwFlags

Type : DWORD

Spécifie différents aspects d’une séquence de touches. Ce membre peut être certaines combinaisons des valeurs suivantes.

Valeur Signification
KEYEVENTF_EXTENDEDKEY
0x0001
 S’il est spécifié, le code d’analyse wScan se compose d’une séquence de deux octets, où le premier octet a une valeur de 0xE0. Pour plus d’informations, consultez Indicateur de clé étendue .
KEYEVENTF_KEYUP
0x0002
 Si elle est spécifiée, la clé est en cours de libération. Si elle n’est pas spécifiée, la touche est en cours d’appui.
KEYEVENTF_SCANCODE
0x0008
 S’il est spécifié, wScan identifie la clé et wVk est ignoré.
KEYEVENTF_UNICODE
0x0004
 S’il est spécifié, le système synthétise une VK_PACKET séquence de touches. Le paramètre wVk doit être égal à zéro. Cet indicateur ne peut être combiné qu’avec l’indicateur KEYEVENTF_KEYUP . Pour plus d'informations, consultez la section Notes.

time

Type : DWORD

Horodatage de l’événement, en millisecondes. Si ce paramètre est égal à zéro, le système fournit son propre horodatage.

dwExtraInfo

Type : ULONG_PTR

Valeur supplémentaire associée à la séquence de touches. Utilisez la fonction GetMessageExtraInfo pour obtenir ces informations.

Remarques

INPUT_KEYBOARD prend en charge les méthodes d’entrée nonkeyboard, telles que la reconnaissance de l’écriture manuscrite ou la reconnaissance vocale, comme s’il s’agissait d’une entrée de texte à l’aide de l’indicateur KEYEVENTF_UNICODE . Si KEYEVENTF_UNICODE est spécifié, SendInput envoie un message WM_KEYDOWN ou WM_KEYUP à la file d’attente de messages du thread de premier plan avec wParam égal à VK_PACKET. Une fois que GetMessage ou PeekMessage a obtenu ce message, le passage du message à TranslateMessage publie un message WM_CHAR avec le caractère Unicode spécifié à l’origine par wScan. Ce caractère Unicode est automatiquement converti en la valeur ANSI appropriée s’il est publié dans une fenêtre ANSI.

Définissez l’indicateur KEYEVENTF_SCANCODE pour définir l’entrée au clavier en termes de code d’analyse. Cela est utile pour simuler une séquence de touches physique, quel que soit le clavier actuellement utilisé. Vous pouvez également passer l’indicateur KEYEVENTF_EXTENDEDKEY si le code d’analyse est une clé étendue. La valeur de la touche virtuelle d’une touche peut changer en fonction de la disposition actuelle du clavier ou des autres touches enfoncées, mais le code d’analyse sera toujours le même.

Configuration requise

Condition requise 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 winuser.h (inclure Windows.h)

Voir aussi