KEY_EVENT_RECORD structure

콘솔 INPUT_RECORD 구조의 키보드 입력 이벤트에 대해 설명합니다.

구문

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

멤버

bKeyDown
키를 누르면 이 멤버는 TRUE입니다. 그렇지 않으면 이 멤버는 FALSE입니다(키가 해제됨).

wRepeatCount
키가 보류 중임을 나타내는 반복 횟수입니다. 예를 들어 키를 누른 상태에서 이 멤버가 1인 이벤트 5개, 이 멤버가 5인 이벤트 하나 또는 이 멤버가 1보다 크거나 같은 여러 이벤트를 가져올 수 있습니다.

wVirtualKeyCode
지정된 키를 디바이스 독립적 방식으로 식별하는 가상 키 코드입니다.

wVirtualScanCode
키보드 하드웨어에서 생성된 디바이스 종속 값을 나타내는 지정된 키의 가상 검사 코드입니다.

uChar
다음 멤버의 공용 구조체입니다.

UnicodeChar
번역된 유니코드 문자입니다.

AsciiChar
번역된 ASCII 문자입니다.

dwControlKeyState
제어 키의 상태입니다. 이 멤버는 다음 값 중 하나 이상일 수 있습니다.

값	의미
CAPSLOCK_ON 0x0080	CAPS LOCK 표시등이 켜집니다.
ENHANCED_KEY 0x0100	키가 향상되었습니다. 발언을 참조 하세요.
LEFT_ALT_PRESSED 0x0002	왼쪽 ALT 키를 누릅니다.
LEFT_CTRL_PRESSED 0x0008	왼쪽 Ctrl 키를 누릅니다.
NUMLOCK_ON 0x0020	NUM LOCK 표시등이 켜집니다.
RIGHT_ALT_PRESSED 0x0001	오른쪽 ALT 키를 누릅니다.
RIGHT_CTRL_PRESSED 0x0004	오른쪽 Ctrl 키를 누릅니다.
SCROLLLOCK_ON 0x0040	SCROLL LOCK 표시등이 켜집니다.
SHIFT_PRESSED 0x0010	SHIFT 키를 눌렀습니다.

설명

IBM® 101 및 102 키 키보드의 향상된 키는 키패드의 왼쪽에 있는 클러스터의 INS, DEL, HOME, END, PAGE UP, PAGE DOWN 및 방향 키입니다. 키패드의 키 나누기(/) 및 ENTER 키

키보드 입력 이벤트는 컨트롤 키를 비롯한 모든 키를 누르거나 놓을 때 생성됩니다. 그러나 다른 문자와 결합하지 않고 누르고 놓을 때 ALT 키는 시스템에 특별한 의미가 있으며 애플리케이션에 전달되지 않습니다. 또한 입력 핸들이 처리 모드(ENABLE_PROCESSED_INPUT)인 경우 Ctrl+C 키 조합이 전달되지 않습니다.

예제

예제는 입력 버퍼 이벤트 읽기를 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	WinConTypes.h(WinCon.h를 통해 Windows.h 포함)

참고 항목

PeekConsoleInput

ReadConsoleInput

WriteConsoleInput

INPUT_RECORD