Partager via

KEYBDINPUT, structure (winuser.h)

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;

Members

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 être 0.

wScan

Type : WORD

Code d’analyse matérielle de la clé. Si dwFlags spécifie KEYEVENTF_UNICODE, wScan spécifie un caractère Unicode à envoyer à 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 Meaning
KEYEVENTF_EXTENDEDKEY
0x0001
 Si 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, consultezExtended-Key Indicateur .
KEYEVENTF_KEYUP
0x0002
 Si elle est spécifiée, la clé est libérée. Si elle n’est pas spécifiée, la touche est enfoncée.
KEYEVENTF_SCANCODE
0x0008
 Si spécifié, wScan identifie la clé et wVk est ignoré.
KEYEVENTF_UNICODE
0x0004
 S’il est spécifié, le système synthétise une séquence de touches VK_PACKET . 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 non-clé(par exemple, 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 de 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 GetMessage ou PeekMessage 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 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 du 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.

Spécifications

Requirement Valeur
Client minimum requis Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Header winuser.h (include Windows.h)

Voir aussi

  • Last updated on