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