KEY_EVENT_RECORD, structure

Décrit un événement d’entrée clavier dans une structure INPUT_RECORD console.

Syntaxe

typedef struct _KEY_EVENT_RECORD {
  BOOL  bKeyDown;
  WORD  wRepeatCount;
  WORD  wVirtualKeyCode;
  WORD  wVirtualScanCode;
  union {
    WCHAR UnicodeChar;
    CHAR  AsciiChar;
  } uChar;
  DWORD dwControlKeyState;
} KEY_EVENT_RECORD;

Membres

bKeyDown
Si la touche est enfoncée, ce membre a la valeur TRUE. Sinon, ce membre a la valeur FALSE (la clé est libérée).

wRepeatCount
Nombre de répétitions, qui indique qu’une clé est conservée en panne. Par exemple, lorsqu’une clé est arrêtée, vous pouvez obtenir cinq événements avec ce membre égal à 1, un événement avec ce membre égal à 5 ou plusieurs événements avec ce membre supérieur ou égal à 1.

wVirtualKeyCode
Code de clé virtuelle qui identifie la clé donnée de manière indépendante de l’appareil.

wVirtualScanCode
Code d’analyse virtuel de la clé donnée qui représente la valeur dépendante de l’appareil générée par le matériel clavier.

uChar
Union des membres suivants.

UnicodeChar
Caractère Unicode traduit.

AsciiChar
Caractère ASCII traduit.

dwControlKeyState
État des clés de contrôle. Ce membre peut être une ou plusieurs des valeurs suivantes.

Remarques

Les touches améliorées pour les claviers IBM® 101 et 102 touches sont les touches INS, DEL, HOME, END, PAGE UP, PAGE DOWN et direction dans les clusters à gauche du pavé numérique ; et les touches De division (/) et Entrée dans le pavé numérique.

Les événements d’entrée du clavier sont générés quand une touche, y compris les touches de contrôle, est enfoncée ou libérée. Toutefois, la touche ALT lorsqu’elle est enfoncée et libérée sans combiner avec un autre caractère, a une signification particulière pour le système et n’est pas transmise à l’application. En outre, la combinaison de touches Ctrl+C n’est pas transmise si le handle d’entrée est en mode traité (ENABLE_PROCESSED_INPUT).

Exemples

Pour obtenir un exemple, consultez Lecture des événements de mémoire tampon d’entrée.

Spécifications

Voir aussi

PeekConsoleInput

ReadConsoleInput

WriteConsoleInput

INPUT_RECORD