Win32 API. Функции и сообщения ввода информации с клавиатуры
Страница 28. Функция VkKeyScan
Страница 28 из 45

Функция VkKeyScan

(СканироватьВиртуальнуюКлавишу)

Функция VkKeyScan переводит символ в соответствующий код виртуальной клавиши и состояние переключения для текущей клавиатуры.

Синтаксис 

SHORT VkKeyScan
(
TCHAR ch// символ, который транслируется
);

Параметры
ch
Определяет символ, который будет оттранслирован в код виртуальной клавиши.

Возвращаемые значения
Если функция завершается успешно, младший байт величины возвращаемого значения содержит код виртуальной клавиши, а старший байт содержит состояние переключения, которое может быть комбинацией следующих битов флажка:

  • 1 бит - Нажата любая клавиша SHIFT.
  • 2 бит - Нажата любая клавиша CTRL.
  • 4 бит - Нажата любая клавиша ALT.

Если функция не находит клавишу, которая транслируется, чтобы послать код буквы, то младшие и старшие байты содержат – (минус)1.

Замечания
Для раскладок символов на клавиатуре, которые используют правостороннюю клавишу ALT как клавишу SHIFT (например, Французская раскладка символов на клавиатуре), состояние переключения представлено значением 6, потому что правосторонняя клавиша ALT внутренне преобразуется в CTRL+ALT.
Трансляция для цифрового клавишного поля (от VK_NUMPAD0 до VK_DIVIDE) игнорируется. Эта функция предназначена для того, чтобы переводить символы в нажатия клавиш только из главного раздела клавиатуры. Например, символ "7" транслируется в VK_7, не VK_NUMPAD7.
VkKeyScan используется прикладными программами, которые посылают символы, используя сообщения WM_KEYDOWN и WM_KEYUP.

Смотри также
GetAsyncKeyState, GetKeyboardState, GetKeyNameText, GetKeyState, SetKeyboardState, WM_KEYDOWN, WM_KEYUP

Размещение и совместимость VkKeyScan 

Windows NTДа 
Win95Да 
Win32sДа 
Импортируемая библиотекаuser32.lib 
Заголовочный файлwinuser.h 
UnicodeWinNT
Замечания по платформеНе имеется
 
« Предыдущая статья   Следующая статья »