Compartir a través de


Estructura de KEY_EVENT_RECORD

Describe un evento de entrada de teclado en una estructura de INPUT_RECORD de consola.

Sintaxis

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

Miembros

bKeyDown
Si se presiona la tecla, este miembro es TRUE. De lo contrario, este miembro es FALSE (se libera la clave).

wRepeatCount
Recuento de repeticiones, que indica que se mantiene presionada una clave. Por ejemplo, cuando se mantiene presionada una clave, puede obtener cinco eventos con este miembro igual a 1, un evento con este miembro igual a 5 o varios eventos con este miembro mayor o igual que 1.

wVirtualKeyCode
Código de clave virtual que identifica la clave especificada de forma independiente del dispositivo.

wVirtualScanCode
Código de examen virtual de la tecla especificada que representa el valor dependiente del dispositivo generado por el hardware del teclado.

uChar
Unión de los siguientes miembros.

UnicodeChar
Carácter Unicode traducido.

AsciiChar
Carácter ASCII traducido.

dwControlKeyState
Estado de las claves de control. Este miembro puede ser uno o varios de los siguientes valores.

Importancia Significado
CAPSLOCK_ON 0x0080 La luz CAPS LOCK está activada.
ENHANCED_KEY 0x0100 La clave se ha mejorado. Vea los comentarios.
LEFT_ALT_PRESSED 0x0002 Se presiona la tecla ALT izquierda.
LEFT_CTRL_PRESSED 0x0008 Se presiona la tecla CTRL izquierda.
NUMLOCK_ON 0x0020 La luz NUM LOCK está activada.
RIGHT_ALT_PRESSED 0x0001 Se presiona la tecla ALT derecha.
RIGHT_CTRL_PRESSED 0x0004 Se presiona la tecla CTRL derecha.
SCROLLLOCK_ON 0x0040 La luz SCROLL LOCK está activada.
SHIFT_PRESSED 0x0010 Se presiona la tecla MAYÚS.

Observaciones

Las teclas mejoradas para los teclados IBM® 101- y 102-key son las teclas INS, DEL, HOME, END, PAGE UP, PAGE DOWN y direction en los clústeres a la izquierda del teclado; y las teclas dividir (/) y ENTRAR en el teclado.

Los eventos de entrada del teclado se generan cuando se presiona o suelta cualquier tecla, incluidas las teclas de control. Sin embargo, la tecla ALT cuando se presiona y suelta sin combinar con otro carácter, tiene un significado especial para el sistema y no se pasa a la aplicación. Además, la combinación de teclas CTRL+C no se pasa a través si el identificador de entrada está en modo procesado (ENABLE_PROCESSED_INPUT).

Ejemplos

Para obtener un ejemplo, consulte Lectura de eventos de búfer de entrada.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Cabecera WinConTypes.h (a través de WinCon.h, incluya Windows.h)

Consulte también

PeekConsoleInput

ReadConsoleInput

WriteConsoleInput

INPUT_RECORD