TranslateMessage

TranslateMessage функция переводит виртуальный ключ сообщения в символов сообщения. Символ отправки сообщений в очередь сообщений вызывающего потока для чтения на следующий раз поток вызывает GetMessage или функцию PeekMessage.

(BOOL TranslateMessage CONST MSG  * lpMsg / / адрес структуры с сообщением);
 

Параметры

lpMsg
Указатель на структуру MSG , содержащая сведения о сообщениях, полученных из очереди сообщений вызывающего потока, используя функции GetMessage или PeekMessage.

Возвращаемые значения

Если сообщение переводится (то есть, символ сообщение отправляется очереди сообщений потока), возвращаемое значение не равно нулю.

Если сообщение является WM_KEYDOWN, WM_KEYUP, WM_SYSKEYDOWN или WM_SYSKEYUP, возвращаемое значение не равно нулю, вне зависимости от перевода.

Если сообщение не переведены (то есть, символ сообщение не отправляется очереди сообщений потока), возвращаемое значение равно нулю.

Примечания

Функция TranslateMessage не изменяет сообщения, который указывает параметр lpMsg.

Комбинации WM_KEYUP и WM_KEYDOWN производят сообщение WM_CHAR или WM_DEADCHAR . Комбинации WM_SYSKEYUP и WM_SYSKEYDOWN производят на WM_SYSCHAR или WM_SYSDEADCHAR сообщение.

TranslateMessage производит сообщения WM_CHAR только для ключей, которые сопоставляются с ASCII символы драйвер клавиатуры.

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

Windows CE: Windows CE поддерживает не проверка кодов или расширенного ключа флаги, поэтому он не поддерживает значения 16-24 в параметре lKeyData (lParam) сообщения WM_CHAR, генерируемых функцией TranslateMessage.

TranslateMessage может использоваться только для перевода сообщений, полученных от вызовов GetMessage или PeekMessage.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Использование user32.lib.

Родственные слова

Обзор очереди сообщений и сообщений, сообщений и функции очереди сообщений, TranslateAccelerator GetMessage, PeekMessage WM_CHAR, WM_DEADCHAR, WM_KEYDOWN, WM_KEYUP, WM_SYSCHAR, WM_SYSDEADCHAR, WM_SYSKEYDOWN, WM_SYSKEYUP

Index