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

Функция ToAscii

(в ASCII)

Функция ToAscii переводит заданный код виртуальной клавиши и состояние клавиатуры в соответствующий символ или символы Windows. Функция переводит код, используя язык ввода данных и физическую раскладку символов на клавиатуре, идентифицированную данным дескриптором раскладки символов.

Синтаксис 

int ToAscii
(
UINT uVirtKey,// код виртуальной клавиши
UINT uScanCode,// скэн-код
PBYTE lpKeyState,// адрес массива состояния клавиши
LPWORD lpChar,// буфер для трансляции клавиши
UINT uFlags// флажок активного меню
);

Параметры
uVirtKey
Определяет код виртуальной клавиши, который будет оттранслирован.
uScanCode
Определяет аппаратный скэн-код клавиши, которая будет оттранслирована. Старший бит этого значения установлен, если клавиша вверху (не нажата).
lpKeyState
Указывает на 256-байтовый массив, который содержит текущее состояние клавиатуры. Каждый элемент (байт) в массиве содержит состояние в одной из клавиш. Если старший бит байта установлен, клавиша - внизу (нажата).
Если установлен младший бит, он указывает на то, что клавиша подключена. В этой функции важен только бит подключения клавиши CAPS LOCK. Состояние переключения клавиш NUM LOCK и SCROLL LOCK игнорируется.
lpChar
Указывает на буфер, который примет оттранслированный символ или символы Windows.
uFlags
Определяет, является ли меню активным. Этот параметр должен быть 1, если меню активно, или иначе 0.

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

  • 0 - Заданная виртуальная клавиша не транслируется для текущего состояния клавиатуры.
  • 1 - Один символ Windows был скопирован в буфер.
  • 2 - Два символа были скопированы в буфер. Это обычно случается тогда, когда символ мертвой клавиши (знак ударения или диакритический знак), сохраненный в раскладке символов на клавиатуре, не может быть скомбинирован с заданной виртуальной клавишей, чтобы сформировать единый символ.

Замечания
Параметров, данных в функции ToAscii, может быть не достаточно, чтобы транслировать код виртуальной клавиши, потому что предыдущая мертвая клавиша сохраняется в раскладке символов на клавиатуре.
Как правило, ToAscii исполняет трансляцию, опираясь на код виртуальной клавиши. Однако в некоторых случаях, бит 15 параметра uScanCode может быть использован, чтобы различить между нажатием клавиши и её отпуском. Скэн-код используется для трансляции комбинации клавиш ALT + числовая клавиша.
Хотя NUM LOCK - клавиша - переключатель, которая воздействует на поведение клавиатуры, ToAscii игнорирует установку переключателя (младший бит) lpKeyState (VK_NUMLOCK), потому что одного параметра uVirtKey достаточно, чтобы отличить клавиши управления курсором (VK_HOME, VK_INSERT и так далее) от числовых клавиш (VK_DECIMAL, VK_NUMPAD0 - VK_NUMPAD9).

Смотри также
OemKeyScan, ToUnicode, VkKeyScan

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

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