WM_SETHOTKEY訊息

傳送至視窗以將作用中索引鍵與窗口產生關聯。 當使用者按下熱鍵時，系統會啟動視窗。

#define WM_SETHOTKEY                    0x0032

參數

wParam

低序字組的低位元組會指定要與視窗建立關聯的虛擬索引鍵程序代碼。

低序字的高位元組可以是來自 CommCtrl.h 的下列一或多個值。

價值觀	意義
HOTKEYF_ALT 0x04	ALT 鍵
HOTKEYF_CONTROL 0x02	CTRL 鍵
HOTKEYF_EXT 0x08	擴充金鑰
HOTKEYF_SHIFT 0x01	換檔鍵

會忽略 wParam 的高序字。

將 wParam 設定為 NULL 會移除與視窗相關聯的快速鍵。

lParam

不使用此參數。

返回值

傳回值是下列其中一項。

返回值	說明
-1	函式失敗;作用中索引鍵無效。
0	函式失敗;窗口無效。
1	函式成功，而且沒有其他視窗具有相同的熱鍵。
2	函式成功，但另一個窗口已經有相同的熱鍵。

備註

作用中索引鍵無法與子視窗相關聯。

VK_ESCAPE、 VK_SPACE、 VK_TAB和 VK_PACKET 是無效的快捷鍵。

當使用者按下熱鍵時，系統會產生 wParam 等於 SC_HOTKEY 且 lParam 等於視窗句柄的WM_SYSCOMMAND訊息。 如果此訊息傳遞至 DefWindowProc，系統會將視窗的最後一個作用中彈出視窗（如果有的話）或視窗本身（如果沒有彈出視窗）帶到前景。

視窗只能有一個作用鍵。 如果窗口已經有與其相關聯的熱鍵，新的熱鍵會取代舊的索引鍵。 如果有多個視窗具有相同的熱鍵，熱鍵所啟動的視窗是隨機的。

這些快捷鍵與 RegisterHotKey 所設定的快捷鍵無關。

需求

要求	價值觀
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
頁首	Winuser.h （包括 Windows.h）

另請參閱

參考

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

概念性的

鍵盤輸入