MapVirtualKeyExA 함수(winuser.h)

가상 키 코드를 검색 코드 또는 문자 값으로 변환(매핑)하거나 스캔 코드를 가상 키 코드로 변환합니다. 이 함수는 입력 언어 및 입력 로캘 식별자를 사용하여 코드를 번역합니다.

통사론

UINT MapVirtualKeyExA(
  [in]                UINT uCode,
  [in]                UINT uMapType,
  [in, out, optional] HKL  dwhkl
);

매개 변수

[in] uCode

형식: UINT

가상 키 코드는 또는 검색 코드에서 키를 검색합니다. 이 값을 해석하는 방법은 uMapType 매개 변수의 값에 따라 달라집니다.

[in] uMapType

형식: UINT

수행할 번역입니다. 이 매개 변수의 값은 uCode 매개 변수의 값에 따라 달라집니다.

[in, out, optional] dwhkl

형식: HKL

지정된 코드를 번역하는 데 사용할 입력 로캘 식별자입니다. 이 매개 변수는 LoadKeyboardLayout 함수에서 이전에 반환한 입력 로캘 식별자일 수 있습니다.

반환 값

형식: UINT

반환 값은 uCode 및 uMapType값에 따라 검색 코드, 가상 키 코드 또는 문자 값입니다. 번역이 없으면 반환 값은 0입니다.

발언

입력 로캘 식별자는 음성 텍스트 변환기, IME(입력 메서드 편집기) 또는 다른 형식의 입력을 포함할 수도 있으므로 키보드 레이아웃보다 더 광범위한 개념입니다.

애플리케이션은 MapVirtualKeyEx 사용하여 검사 코드를 VK_SHIFT, VK_CONTROL및 VK_MENU가상 키 코드 상수로 변환할 수 있으며 그 반대의 경우도 마찬가지입니다. 이러한 변환은 Shift, Ctrl 또는 Alt 키의 왼쪽 및 오른쪽 인스턴스를 구분하지 않습니다.

애플리케이션은 uCode 다음 가상 키 코드 상수 중 하나로 설정된 MapVirtualKeyEx 호출하여 이러한 키 중 하나의 왼쪽 또는 오른쪽 인스턴스에 해당하는 검사 코드를 가져올 수 있습니다.

• VK_LSHIFT
• VK_RSHIFT
• VK_LCONTROL
• VK_RCONTROL
• VK_LMENU
• VK_RMENU

이러한 왼쪽 및 오른쪽 구분 상수는 GetKeyboardState, SetKeyboardState, getAsyncKeyState, GetKeyState, MapVirtualKey및 MapVirtualKeyEx 함수를 통해서만 애플리케이션에서 사용할 수 있습니다. 가상 키 코드의 전체 테이블을 나열하려면 가상 키 코드참조하세요.

MAPVK_VK_TO_CHAR 모드에서는 'A'가상 키 코드를 . Z' 키는 대문자 'A'로 변환됩니다. 현재 키보드 레이아웃에 관계없이 Z의 문자입니다. 가상 키 코드를 해당 문자로 변환하려면 ToAscii 함수를 사용합니다.

요구 사항

참고 항목

• GetAsyncKeyState
• GetKeyState
• GetKeyboardState
• GetSystemMetrics
• MapVirtualKey
• SetKeyboardState
• LoadKeyboardLayout
• 키보드 입력
• 키보드 입력 개요