WM_SETHOTKEY訊息

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

#define WM_SETHOTKEY                    0x0032

參數

wParam

低序字會指定要與視窗建立關聯的虛擬機器碼程式碼。

高階字可以是 CommCtrl.h 的下列一或多個值。

將 wParam 設定為 Null 會移除與視窗相關聯的熱鍵。

值	意義
HOTKEYF_ALT 0x04	ALT 鍵
HOTKEYF_CONTROL 0x02	CTRL 鍵
HOTKEYF_EXT 0x08	擴充金鑰
HOTKEYF_SHIFT 0x01	SHIFT 鍵

lParam

不使用這個參數。

傳回值

傳回值是下列其中一項。

傳回值	描述
-1	函式不成功;熱鍵無效。
0	函式不成功;視窗無效。
1	函式成功，而且沒有其他視窗具有相同的熱鍵。
2	函式成功，但另一個視窗已經有相同的熱鍵。

備註

熱鍵無法與子視窗相關聯。

VK_ESCAPE、 VK_SPACE和 VK_TAB 是不正確熱鍵。

當使用者按下熱鍵時，系統會產生wParam等於SC_HOTKEY且lParam等於視窗控制碼的WM_SYSCOMMAND訊息。 如果此訊息傳遞至 DefWindowProc，系統會將視窗的最後一個作用中快顯 (如果視窗存在) 或視窗本身 (沒有快顯視窗) 前景。

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

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Winuser.h (包含 Windows.h)

另請參閱

參考

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

概念

鍵盤輸入