На главную

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 | Скачать Вниз

GetKeyboardState



The GetKeyboardState function copies the status of the 256 virtual keys to the specified buffer.

BOOL GetKeyboardState(

PBYTE lpKeyState // address of array to receive status data
);


Parameters

lpKeyState

Points to the 256-byte array that will receive the status data for each virtual key.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

An application can call this function to retrieve the current status of all the virtual keys. The status changes as a thread removes keyboard messages from its message queue. The status does not change as keyboard messages are posted to the message queue.
When the function returns, each member of the array pointed to by the lpKeyState parameter contains status data for a virtual key. If the high-order bit is 1, the key is down; otherwise, it is up. If the low-order bit is 1, the key is toggled. A key, such as the CAPS LOCK key, is toggled if it is turned on. The key is off and untoggled if the low-order bit is 0. A toggle key's indicator light (if any) on the keyboard will be on when the key is toggled, and off when the key is untoggled.

To retrieve status information for an individual key, use the GetKeyState function.
An application can use the virtual-key code constants VK_SHIFT, VK_CONTROL and VK_MENU as indices into the array pointed to by lpKeyState. This gives the status of the SHIFT, CTRL, or ALT keys without distinguishing between left and right. An application can also use the following virtual-key code constants as indices to distinguish between the left and right instances of those keys:

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, and MapVirtualKey functions.

See Also

GetKeyState, GetAsyncKeyState, MapVirtualKey, SetKeyboardState


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

GetKeyboardState



Функция GetKeyboardState копирует статус 256 виртуальных ключей в определенный буфер.

BOOL GetKeyboardState(

АДРЕС PBYTE lpKeyState // массива должен получать данные статуса
);


Параметры

lpKeyState

Точки на 256- байтовый массив, которые получат данные статуса для каждой виртуальной клавиши.



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

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Приложение может назвать эту функцию, чтобы извлекать текущий статус всех виртуальных клавиш. Статус изменяется так как резьба удаляет клавишные сообщения из своей очереди сообщения. Статус не изменяется так как клавишные сообщения объявлены в очередь сообщения.
Когда функция возвращается, каждый элемент массива указанного, чтобы параметром lpKeyState содержит данные статуса для виртуальной клавиши. Если старший бит - 1, клавиша нажатая; в противном случае, это - по. Если младший бит - 1, клавиша переключена. Клавиша, как например, КОЛПАЧКИ ЗАПИРАЮТ клавишу, переключены если он включен. Клавиша - и untoggled если младший бит - 0. Свет ключевого указателя переключателя (если имеется) на клавиатуре будет находиться на когда клавиша переключена, и когда клавиша untoggled.

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

VK_LSHIFT VK_RSHIFT VK_LCONTROL VK_RCONTROL VK_LMENU VK_RMENU


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

Смотри Также

GetKeyState, GetAsyncKeyState, MapVirtualKey, SetKeyboardState


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