WM_SETHOTKEY

Приложение отправляет сообщение WM_SETHOTKEY в окно связать горячей клавиши с окном. Когда пользователь нажимает клавишу, система активирует окно.

WM_SETHOTKEY wParam = (WPARAM) MAKEWORD (vkey, модификаторы) / / код виртуального ключа и модификаторы горячие ключевые lParam = 0;                                   / / не используется; должно быть равно нулю

Параметры

vkey

Значение wParam. Указывает код виртуального ключа и модификаторы горячей клавиши для связи с окном. Виртуальная клавиша код находится в низкой байт параметра и флаги модификатора в старший байт. Установка этого параметра в NULL удаляет Горячий ключ, связанный с окном. Модификатор байтов может представлять собой сочетание следующих флагов.

Значение	Значение
HOTKEYF_ALT	Клавиша ALT
HOTKEYF_CONTROL	Клавиша CTRL
HOTKEYF_EXT	Расширенный ключ
HOTKEYF_SHIFT	Клавиша SHIFT

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

Возвращаемое значение является один из следующих:

Значение	Значение
1	Функция неудачно — недопустимый Горячий ключ.
..0	Функция неудачно — окно является недопустимым.
..1	Функция выполнена успешно, и не другой окно имеет тот же Горячий ключ.
..2	Функция выполнена успешно, но другое окно уже есть же Горячий ключ.

Примечания

Горячий ключ не может быть связан с дочернее окно.

VK_ESCAPE, VK_SPACE и VK_TAB являются недействительными горячие клавиши.

Когда пользователь нажимает клавишу, система генерирует WM_SYSCOMMAND сообщение с wParam SC_HOTKEY и lParam равны на дескриптор окна. Если это сообщение передается DefWindowProc, система принесет последний активный всплывающих окон (если он существует) или само (если нет всплывающего окна) окно на передний план.

Окно может быть только один Горячий ключ. Если окно уже Горячий ключ, связанный с ним, новый горячий ключ заменяет старую. Если же Горячий ключ имеет более одного окна, окно, которое активируется путем горячей клавиши случайных.

Эти горячие клавиши, не связаны с горячих клавиш, установленные RegisterHotKey.

QuickInfo

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

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

Обзор ввода клавиатуры ввода сообщений клавиатуры, RegisterHotKey, WM_GETHOTKEY, WM_SYSCOMMAND

Index