На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

MapVirtualKeyEx



[Now Supported on Windows NT]

The MapVirtualKeyEx function translates (maps) a virtual-key code into a scan code or character value, or translates a scan code into a virtual-key code. The function translates the codes using the input language and physical keyboard layout identified by the given keyboard layout handle.

UINT MapVirtualKeyEx(

UINT uCode, // virtual-key code or scan code
UINT uMapType, // translation to perform
HKL dwhkl // keyboard layout handle
);


Parameters

uCode

Specifies the virtual-key code or scan code for a key. How this value is interpreted depends on the value of the uMapType parameter.

uMapType

Specifies the translation to perform. The value of this parameter depends on the value of the uCode parameter:

Value Meaning
0 uCode is a virtual-key code and is translated into a scan code. If it is a virtual-key code that does not distinguish between left- and right-hand keys, the left-hand scan code is returned. If there is no translation, the function returns 0.
1 uCode is a scan code and is translated into a virtual-key code that does not distinguish between left- and right-hand keys. If there is no translation, the function returns 0.
2 uCode is a virtual-key code and is translated into an unshifted character value in the low order word of the return value. Dead keys (diacritics) are indicated by setting the top bit of the return value. If there is no translation, the function returns 0.
3 uCode is a scan code and is translated into a virtual-key code that distinguishes between left- and right-hand keys. If there is no translation, the function returns 0.


dwhkl

Identifies the keyboard layout to use for translating the given code. This parameter can be any keyboard layout handle previously returned by the LoadKeyboardLayout function.



Return Values

The return value is either a scan code, a virtual-key code, or a character value, depending on the value of uCode and uMapType. If there is no translation, the return value is zero.

Remarks

An application can use MapVirtualKeyEx to translate scan codes to the virtual-key code constants VK_SHIFT, VK_CONTROL, and VK_MENU, and vice versa. These translations do not distinguish between the left and right instances of the SHIFT, CTRL, or ALT keys. An application can get the scan code corresponding to the left or right instance of one of these keys by calling MapVirtualKeyEx with uCode set to one of the following virtual-key code constants:

VK_LSHIFT VK_RSHIFT
VK_LCONTROL VK_RCONTROL
VK_LMENU VK_RMENU


These left- and right-distinguishing constants are available to an application only through the GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyState, MapVirtualKey, and MapVirtualKeyEx functions.

See Also

GetAsyncKeyState, GetKeyboardState, GetKeyState, LoadKeyboardLayout, MapVirtualKey, SetKeyboardState


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

MapVirtualKeyEx



[Теперь Поддерживанное на Windows NT]

Функция MapVirtualKeyEx переводится (карты) виртуальный-ключевой код в сканирование кодовая или символьная величина или переводится код сканирования в виртуальный-ключевой код. Функция переводится кодировать использование входного языка и физический клавишный формат идентифицировался данной клавишной ручкой формата.

UINT MapVirtualKeyEx(

UINT uCode, // ВИРТУАЛЬНЫЙ-ключевой кодовый или код сканирования UINT uMapType, // перевода, чтобы выполнять HKL dwhkl // клавишную ручку формата
);


Параметры

uCode

Определяет виртуальный-ключевой кодовый или код сканирования для ключа. Как эта величина интерпретирована зависеть от величины параметра uMapType.

uMapType

Определяет перевод, чтобы выполняться. Величина этого параметра зависит от величины параметра uCode:

Значение Величины
0 uCode - виртуальный-ключевой код и переведен в код сканирования. Если это - виртуальный-ключевой код, что не различается между левыми- и правосторонними ключами, левый код сканирования возвращан. Если нет перевода, функциональный возврат 0.
1 uCode - код сканирования и переведен в виртуальный-ключевой код, что не различается между левыми- и правосторонними ключами. Если нет перевода, функциональный возврат 0.
2 uCode - виртуальный-ключевой код и переведен в unshifted символьную величину в низком слове порядка обратной величины. Мертвые ключи (диакритические) указаны установкой верхнего бита обратной величины. Если нет перевода, функциональный возврат 0.
3 uCode - код сканирования и переведен в виртуальный-ключевой код, что различается между левыми- и правосторонними ключами. Если нет перевода, функциональный возврат 0.


dwhkl

Идентифицирует клавишный формат, чтобы использоваться для перевода данного кода. Этот параметр может быть любой клавишной ручкой формата прежде возвращанной функцией LoadKeyboardLayout.



Обратные Величины

Обратная величина - также код сканирования, виртуальный-ключевой код, или символьная величина, в зависимости от величины uCode и uMapType. Если нет перевода, обратная величина нулевая.

Замечания

Приложение может использовать MapVirtualKeyEx, чтобы переводиться коды сканирования в виртуальные-ключевые кодовые константы VK_SHIFT, VK_CONTROL, и VK_MENU, и наоборот. Эти переводы не различаются между левыми и правыми примерами СДВИГА, CTRL, или клавиш ALT. Приложение может получить код сканирования, соответствующий налево или пример права одной из этих клавиш вызывая MapVirtualKeyEx с uCode установленное в одну из следующих виртуальных-ключевых кодовых констант:

VK_LSHIFT VK_RSHIFT VK_LCONTROL VK_RCONTROL VK_LMENU VK_RMENU


Эти остались- и правые-отличительные константы пригодные для приложения только через GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyState, MapVirtualKey, и функции MapVirtualKeyEx.

Смотри Также

GetAsyncKeyState, GetKeyboardState, GetKeyState, LoadKeyboardLayout, MapVirtualKey, SetKeyboardState


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz