На главную

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

RegisterHotKey



The RegisterHotKey function defines a hot key for the current thread.

BOOL RegisterHotKey(

HWND hWnd, // window to receive hot-key notification
int id, // identifier of hot key
UINT fsModifiers, // key-modifier flags
UINT vk // virtual-key code
);


Parameters

hWnd

Identifies the window that will receive WM_HOTKEY messages generated by the hot key. If this parameter is NULL, WM_HOTKEY messages are posted to the message queue of the calling thread and must be processed in the message loop.

id

Specifies the identifier of the hot key. No other hot key in the calling thread should have the same identifier. An application must specify a value in the range 0x0000 through 0xBFFF. A shared dynamic-link library (DLL) must specify a value in the range 0xC000 through 0xFFFF (the range returned by the GlobalAddAtom function). To avoid conflicts with hot-key identifiers defined by other shared DLLs, a DLL should use the GlobalAddAtom function to obtain the hot-key identifier.

fsModifiers

Specifies keys that must be pressed in combination with the key specified by the nVirtKey parameter in order to generate the WM_HOTKEY message. The fsModifiers parameter can be a combination of the following values:

Value Meaning
MOD_ALT Either ALT key must be held down.
MOD_CONTROL Either CTRL key must be held down.
MOD_SHIFT Either SHIFT key must be held down.


vk

Specifies the virtual-key code of the hot key.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.

Remarks

When a key is pressed, the system looks for a match against all thread hot keys. Upon finding a match, the system posts the WM_HOTKEY message to the message queue of the thread that registered the hot key. This message is posted to the beginning of the queue so it is removed by the next iteration of the message loop.
This function cannot associate a hot key with a window created by another thread.
RegisterHotKey fails if the keystrokes specified for the hot key have already been registered by another hot key.

If the window identified by the hWnd parameter already registered a hot key with the same identifier as that specified by the id parameter, the new values for the fsModifiers and vk parameters replace the previously specified values for these parameters.

See Also

GlobalAddAtom, UnregisterHotKey, WM_HOTKEY


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

RegisterHotKey



Функция RegisterHotKey определяет горячий ключ для текущей резьбы.

BOOL RegisterHotKey(

HWND hWnd, // ОКНО, чтобы получать горячее-ключевое уведомление int id, // идентификатор горячего ключа UINT fsModifiers, // ключевой-модификатор сигнализирует UINT vk // виртуальный-ключевой код
);


Параметры

hWnd

Идентифицирует окно, которое получит сообщения WM_HOTKEY сгенерированные горячим ключом. Если этот параметр НЕДЕЙСТВИТЕЛЕН, сообщения WM_HOTKEY объявлены в очередь сообщения разговора резьбы и должно быть обработано в цикле сообщения.

id

Определяет идентификатор горячего ключа. Никакой другой горячий ключ в разговоре резьбы не должен иметь тот же идентификатор. Приложение должно определить величину в дипазоне 0x0000 через 0xBFFF. Динамическая связь коллективной библиотеки (DLL) должна определить величину в дипазоне 0xC000 через 0xFFFF ( дипазон возвращался функцией GlobalAddAtom). Для того, чтобы избегать конфликтов с горячими-ключевыми идентификаторами определенными другими коллективными DLLs, DLL должен использовать функцию GlobalAddAtom, чтобы получать горячий-ключевой идентификатор.

fsModifiers

Определяет ключи, которые должны быть нажаты в комбинацию с ключом определенным параметром nVirtKey для того, чтобы генерировать сообщение WM_HOTKEY. Параметр fsModifiers может быть комбинацией следующего величин:

Значение Величины
MOD_ALT Также ключ ALT должен быть придержан.
MOD_CONTROL Также клавиша CTRL должна быть придержана.
MOD_SHIFT Также клавиша СДВИГА должна быть придержана.


vk

Определяет виртуальный-ключевой код горячей клавиши.



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

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая.

Замечания

Когда клавиша нажата, система ищет сопоставление против всех горячих клавиш резьбы. В обнаружении сопоставления, система посылает сообщение WM_HOTKEY в очередь сообщения резьбы, которая регистрировала горячую клавишу. Это сообщение объявлено в начало очереди, так что оно удалено следующей итерацией цикла сообщения.
Эта функция не может соединить горячую клавишу с окном созданным другой резьбой.
RegisterHotKey ТЕРПИТ неудачу если нажатия клавиши определенные для горячей клавиши уже зарегистрированы другой горячей клавишей.

Если окно идентифицировалось бы параметром hWnd уже зарегистрировавшим горячую клавишу с тем же идентификатором как, что определялся id параметром, новые величины для fsModifiers и vk параметров заменяют прежде определенные величины для этих параметров.

Смотри Также

GlobalAddAtom, UnregisterHotKey, WM_HOTKEY


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