RegisterHotKey

Функция RegisterHotKey определяет всей системы горячей клавиши.

(BOOL RegisterHotKey HWND  hWnd, / / окно, чтобы получить уведомление о горячих клавишint id, / / идентификатор горячей клавишиUINTfsModifiers, / / флаги Клавиша модификаторUINTВК / / виртуальный ключ код);
 

Параметры

hWnd

Дескриптор окна, которое будет получать WM_HOTKEY сообщения, генерируемые горячей клавиши. Если этот параметр имеет значение NULL, WM_HOTKEY сообщения помещаются в очередь сообщений вызывающего потока и должны быть обработаны в цикл обработки сообщений.

id

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

fsModifiers

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

Значение	Значение
MOD_ALT	Должны проводиться либо клавишу alt.
MOD_CONTROL	Либо ctrl ключ должен проводиться.
MOD_SHIFT	Должны проводиться либо клавишу shift.
MOD_WIN	Либо WINDOWS ключ был проведен. Эти ключи помечены с логотипом Microsoft Windows.

вк

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

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

Если функция выполнена успешно, возвращаемое значение не равно нулю.

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

Примечания

При нажатии клавиши, система ищет матч против всех горячих клавиш. После нахождения на матч, система должностей WM_HOTKEY сообщение в очередь сообщений потока, зарегистрированные горячей клавиши. Это сообщение разносится в начало очереди, так что он удаляется от следующей итерации цикла обработки сообщений.

Эта функция не может сопоставить Горячий ключ с окно, созданное другим потоком.

RegisterHotKey не выполняется, если нажатия клавиш, указанные для горячей клавиши уже были зарегистрированы на другой горячей клавиши.

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

Windows CE: Windows CE версии 2.0 и более поздних поддерживают дополнительный флаг, под названием MOD_KEYUP, для параметра fsModifiers . Если установлен флаг MOD_KEYUP, окно будет отправлено сообщение WM_HOTKEY на ключ до событий, так и по ключевым событие.

RegisterHotKey могут быть использованы для регистрации горячие клавиши по потокам.

QuickInfo

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

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

Обзор ввода клавиатуры, функций ввода клавиатуры, GlobalAddAtom, UnregisterHotKey, WM_HOTKEY

Index