鍵盤事件的鍵值

下表列出了 KeyboardEvent.key 屬性的標準值,並解釋了每個鍵的通常用途。在可用時,還包含了常見平臺的相應虛擬鍵碼。

特殊值

除了標識特定按鍵或字元外,具有特殊含義的 key 值。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"Unidentified"

使用者代理無法將事件的虛擬鍵碼對映到特定的鍵值。

這可能是由於硬體或軟體限制,或由於使用者代理執行平臺的限制造成的。

不定 不定 不定 不定

修飾鍵

修飾鍵是特殊的按鍵,當與其他按鍵組合使用時,用於生成特殊字元或引發特殊操作。例如 ShiftControl 鍵,以及諸如 Caps LockNumLock 之類的鎖定鍵。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"Alt" [4] Alt (Alternative) 鍵。 VK_MENU (0x12)
VK_LMENU (0xA4)
VK_RMENU (0xA5)
kVK_Option (0x3A)
kVK_RightOption (0x3D)
GDK_KEY_Alt_L (0xFFE9)
GDK_KEY_Alt_R (0xFFEA)
Qt::Key_Alt (0x01000023)
KEYCODE_ALT_LEFT (57)
KEYCODE_ALT_RIGHT (58)
"AltGraph" [4] AltGrAltGraph (Alternate Graphics) 鍵。啟用 ISO 3 級 shift 修飾符(其中 Shift 是 2 級修飾符)。 GDK_KEY_Mode_switch (0xFF7E)
GDK_KEY_ISO_Level3_Shift (0xFE03)
GDK_KEY_ISO_Level3_Latch (0xFE04)
GDK_KEY_ISO_Level3_Lock (0xFE05)
GDK_KEY_ISO_Level5_Shift (0xFE11)
GDK_KEY_ISO_Level5_Latch (0xFE12)
GDK_KEY_ISO_Level5_Lock (0xFE13)
Qt::Key_AltGr (0x01001103
Qt::Key_Mode_switch (0x0100117E)
"CapsLock" Caps Lock 鍵。開啟和關閉後續輸入的大寫字元鎖定。 VK_CAPITAL (0x14) kVK_CapsLock (0x39) GDK_KEY_Caps_Lock (0xFFE5)
Qt::Key_CapsLock (0x01000024)
KEYCODE_CAPS_LOCK (115)
"Control" ControlCtrlCtl 鍵。允許輸入控制字元。 VK_CONTROL (0x11)
VK_LCONTROL (0xA2)
VK_RCONTROL (0xA3)
kVK_Control (0x3B)
kVK_RightControl (0x3E)
GDK_KEY_Control_L (0xFFE3)
GDK_KEY_Control_R (0xFFE4)
Qt::Key_Control (0x01000021)
KEYCODE_CTRL_LEFT (113)
KEYCODE_CTRL_RIGHT (114)
"Fn" Fn (Function modifier) 鍵。用於在沒有專用功能鍵區的鍵盤上生成功能鍵(例如 F1F15)字元。通常由硬體處理,因此不會為此鍵生成事件。 kVK_Function (0x3F) KEYCODE_FUNCTION (119)
"FnLock" FnLockF-Lock (Function Lock) 鍵。開啟和關閉 "Fn" 所描述的功能鍵模式。通常由硬體處理,因此不會為此鍵生成事件。
"Hyper" [3] Hyper 鍵。 GDK_KEY_Hyper_L (0xFFED)
GDK_KEY_Hyper_R (0xFFEE)
Qt::Key_Hyper_L (0x01000056)
Qt::Key_Hyper_R (0x01000057)
"Meta" [1] Meta 鍵。允許發出特殊命令輸入。這是 Windows 的 Windows 徽標鍵,或 Mac 鍵盤上的 Command 鍵。 VK_LWIN (0x5B)
VK_RWIN (0x5C)
kVK_Command (0x37)
kVK_RightCommand (0x36)
GDK_KEY_Meta_L (0xFFE7)
GDK_KEY_Meta_R (0xFFE8)
Qt::Key_Meta (0x01000022)
KEYCODE_META_LEFT (117)
KEYCODE_META_RIGHT (118)
"NumLock" NumLock (Number Lock) 鍵。在數字輸入和其他模式(通常是方向箭頭)之間切換數字鍵盤。 VK_NUMLOCK (0x90) GDK_KEY_Num_Lock (0xFF7F)
Qt::Key_NumLock (0x01000025)
KEYCODE_NUM_LOCK (143)
"ScrollLock" [2] Scroll Lock 鍵。在滾動和游標移動模式之間切換。 VK_SCROLL (0x91) GDK_KEY_Scroll_Lock (0xFF14)
Qt::Key_ScrollLock (0x01000026)
KEYCODE_SCROLL_LOCK (116)
"Shift" Shift 鍵。修改按鍵,以允許輸入大寫(或其他)字母,並支援輸入標點符號和其他特殊字元。 VK_SHIFT (0x10)
VK_LSHIFT (0xA0)
VK_RSHIFT (0xA1)
kVK_Shift (0x38)
kVK_RightShift (0x3C)
GDK_KEY_Shift_L (0xFFE1)
GDK_KEY_Shift_R (0xFFE2)
Qt::Key_Shift (0x01000020)
KEYCODE_SHIFT_LEFT (59)
KEYCODE_SHIFT_RIGHT (60)
"Super" [3] Super 鍵。 GDK_KEY_Super_L (0xFFEB)
GDK_KEY_Super_R (0xFFEC)
Qt::Key_Super_L (0x01000053)
Qt::Key_Super_R (0x01000054)
"Symbol" Symbol 修飾鍵(在某些虛擬鍵盤上找到)。 KEYCODE_SYM (63) [2]
"SymbolLock" Symbol Lock 鍵。

[1] 在 Firefox 中,Windows 鍵被報告為 "OS" 而不是 "Meta"。根據 Firefox bug 1232918,這將在 Firefox 中更改。在此修復之前,Firefox 將以下鍵返回為 "OS":Windows 上的 VK_LWIN (0x5B) 和 VK_RWIN (0x5C),以及 Linux 上的 GDK_KEY_Super_L (0xFFEB)、GDK_KEY_Super_R (0xFFEC)、GDK_KEY_Hyper_L (0xFFED) 和 GDK_KEY_Hyper_R (0xFFEE)。

[2] Firefox 直到 Firefox 37 才新增對 Symbol 鍵的支援。

[3] Firefox 為 SuperHyper 鍵生成鍵值 "OS",而不是 "Super""Hyper"

[4] Chrome 67 和 Firefox 63 現在可以正確解釋將右側 Alt 鍵對映為 AltGr 的鍵盤佈局。有關詳細資訊,請參閱 Firefox bug 900750Chrome bug 25503

空白鍵

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"Enter" Enter 鍵(有時標記為 Return)。 VK_RETURN (0x0D) kVK_Return (0x24)
kVK_ANSI_KeypadEnter (0x4C)
kVK_Powerbook_KeypadEnter (0x34)
GDK_KEY_Return (0xFF0D)
GDK_KEY_KP_Enter (0xFF8D)
GDK_KEY_ISO_Enter (0xFE34)
GDK_KEY_3270_Enter (0xFD1E)
Qt::Key_Return (0x01000004)
Qt::Key_Enter (0x01000005)
KEYCODE_ENTER (66)
KEYCODE_NUMPAD_ENTER (160)
KEYCODE_DPAD_CENTER (23)
"Tab" 水平製表鍵 Tab VK_TAB (0x09) kVK_Tab (0x30) GDK_KEY_Tab (0xFF09)
GDK_KEY_KP_Tab (0xFF89)
GDK_KEY_ISO_Left_Tab (0xFE20)
Qt::Key_Tab (0x01000001)
KEYCODE_TAB (61)
" " [1] 空格鍵 Space Bar VK_SPACE (0x20) kVK_Space (0x31)

GDK_KEY_space (0x20)
GDK_KEY_KP_Space (0xFF80)
Qt::Key_Space (0x20)

KEYCODE_SPACE (62)

[1] 舊版瀏覽器可能會為空格鍵 Space Bar 返回 "Spacebar" 而不是 " "。Firefox 在 37 版之前是這樣做的。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"ArrowDown" [1] 下箭頭鍵。 VK_DOWN (0x28) kVK_DownArrow (0x7D) GDK_KEY_Down (0xFF54)
GDK_KEY_KP_Down (0xFF99)
Qt::Key_Down (0x01000015)
KEYCODE_DPAD_DOWN (20)
"ArrowLeft" [1] 左箭頭鍵。 VK_LEFT (0x25) kVK_LeftArrow (0x7B) GDK_KEY_Left (0xFF51)
GDK_KEY_KP_Left (0xFF96)
Qt::Key_Left (0x01000012)
KEYCODE_DPAD_LEFT (21)
"ArrowRight" [1] 右箭頭鍵。 VK_RIGHT (0x27) kVK_RightArrow (0x7C) GDK_KEY_Right (0xFF53)
GDK_KEY_KP_Right (0xFF98)
Qt::Key_Right (0x01000014)
KEYCODE_DPAD_RIGHT (22)
"ArrowUp" [1] 上箭頭鍵。 VK_UP (0x26) kVK_UpArrow (0x7E) GDK_KEY_Up (0xFF52)
GDK_KEY_KP_Up (0xFF97)
Qt::Key_Up (0x01000013)
KEYCODE_DPAD_UP (19)
"End" End 鍵。移動到內容的末尾。 VK_END (0x23) kVK_End (0x77) GDK_KEY_End (0xFF57)
GDK_KEY_KP_End (0xFF9C)
Qt::Key_End (0x01000011)
KEYCODE_MOVE_END (123)
"Home" Home 鍵。移動到內容的開頭。 VK_HOME (0x24) kVK_Home (0x73) GDK_KEY_Home (0xFF50)
GDK_KEY_KP_Home (0xFF95)
Qt::Key_Home (0x01000010)
KEYCODE_MOVE_HOME (122)
"PageDown" Page Down (或 PgDn) 鍵。向下滾動或顯示內容的下一頁。 VK_NEXT (0x22) kVK_PageDown (0x79) GDK_KEY_Page_Down (0xFF56)
GDK_KEY_KP_Page_Down (0xFF9B)
Qt::Key_PageDown (0x01000017)
KEYCODE_PAGE_DOWN (93)
"PageUp" Page Up (或 PgUp) 鍵。向上滾動或顯示內容的上一頁。 VK_PRIOR (0x21) kVK_PageUp (0x74) GDK_KEY_Page_Up (0xFF55)
GDK_KEY_KP_Page_Up (0xFF9A)
Qt::Key_PageUp (0x01000016)
KEYCODE_PAGE_UP (92)

[1] Edge (16 及更早版本) 和 Firefox (36 及更早版本) 使用 "Left""Right""Up""Down" 而不是 "ArrowLeft""ArrowRight""ArrowUp""ArrowDown"

編輯鍵

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"Backspace" Backspace 鍵。此鍵在 Mac 鍵盤上標記為 Delete VK_BACK (0x08) kVK_Delete (0x33) GDK_KEY_BackSpace (0xFF08)
Qt::Key_Backspace (0x01000003)
KEYCODE_DEL (67)
"Clear" Clear 鍵。移除當前選定的輸入。 VK_CLEAR (0x0C)
VK_OEM_CLEAR (0xFE)
kVK_ANSI_KeypadClear (0x47) GDK_KEY_Clear (0xFF0B)
Qt::Key_Clear (0x0100000B)
KEYCODE_CLEAR (28)
"Copy" Copy 鍵(在某些擴充套件鍵盤上)。 APPCOMMAND_COPY GDK_KEY_Copy (0x1008FF57)
Qt::Key_Copy (0x010000CF)
"CrSel" [3] 游標選擇鍵,CrSel VK_CRSEL (0xF7) GDK_KEY_3270_CursorSelect (0xFD1C)
"Cut" Cut 鍵(在某些擴充套件鍵盤上)。 APPCOMMAND_CUT GDK_KEY_Cut (0x1008FF58)
Qt::Key_Cut (0x010000D0)
"Delete" [2] Delete 鍵,Del VK_DELETE (0x2E) kVK_ForwardDelete (0x75) [1] GDK_KEY_Delete (0xFFFF)
GDK_KEY_KP_Delete (0xFF9F)
Qt::Key_Delete (0x01000007)
KEYCODE_FORWARD_DEL (112)
"EraseEof" 擦除到欄位末尾。刪除從當前游標位置到當前欄位末尾的所有字元。 VK_EREOF (0xF9) GDK_KEY_3270_ExSelect (0xFD1B)
"ExSel" [4] ExSel (Extend Selection) 鍵。 VK_EXSEL (0xF8) GDK_KEY_3270_ExSelect (0xFD1B)
"Insert" Insert 鍵,Ins。在插入和覆蓋文字之間切換。 VK_INSERT (0x2D) GDK_KEY_Insert (0xFF63)
GDK_KEY_KP_Insert (0xFF9E)
Qt::Key_Insert (0x01000006)
KEYCODE_INSERT (124)
"Paste" 從剪貼簿貼上。 APPCOMMAND_PASTE GDK_KEY_Paste (0x1008FF6D)
Qt::Key_Paste (0x010000E2)
"Redo" 重做上一個操作。 APPCOMMAND_REDO GDK_KEY_Redo (0xFF66)
"Undo" 撤銷上一個操作。 APPCOMMAND_UNDO GDK_KEY_Undo (0xFF65)

[1] 在沒有專用 Del 鍵的鍵盤上,當 FnDelete (在其他平臺上是 Backspace) 一起按下時,Mac 會生成 "Delete" 值。

[2] Firefox 36 及更早版本使用 "Del" 而不是 "Delete" 來表示 Del 鍵。

[3] Firefox 36 及更早版本在按下 CrSel 鍵時生成 "Crsel" 而不是 "CrSel"

[4] Firefox 36 及更早版本在按下 ExSel 鍵時生成 "Exsel" 而不是 "ExSel"

UI 鍵

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"Accept" AcceptCommitOK 鍵或按鈕。接受當前選定的選項或輸入法序列轉換。 VK_ACCEPT (0x1E) KEYCODE_DPAD_CENTER (23)
"Again" Again 鍵。重做或重複上一個操作。 GDK_KEY_Redo (0xFF66)
"Attn" [4] Attn (Attention) 鍵。 VK_OEM_ATTN (0xF0) GDK_KEY_3270_Attn (0xFD0E)
"Cancel" [1] Cancel 鍵。 GDK_KEY_Cancel (0xFF69)
"ContextMenu" [3] 顯示上下文選單。通常位於鍵盤右側的 Windows(或 OS)鍵和 Control 鍵之間。 VK_APPS (0x5D) kVK_PC_ContextMenu (0x6E) GDK_KEY_Menu (0xFF67)
Qt::Key_Menu (0x01000055)
KEYCODE_MENU (82)
"Escape" [2] Esc (Escape) 鍵。通常用作退出、取消或“轉義此操作”的按鈕。歷史上,跳脫字元用於表示一個稱為“轉義序列”的特殊控制字元序列的開始。 VK_ESCAPE (0x1B) kVK_Escape (0x35) GDK_KEY_Escape (0xFF1B)
Qt::Key_Escape (0x01000000)
KEYCODE_ESCAPE (111)
"Execute" Execute 鍵。 VK_EXECUTE (0x2B) Qt::Key_Execute (0x01020003)
"Find" Find 鍵。開啟一個用於執行查詢/搜尋操作的介面(通常是對話方塊)。 APPCOMMAND_FIND GDK_KEY_Find (0xFF68)
"Finish" [5] Finish 鍵。 VK_OEM_FINISH (0xF1)
"Help" Help 鍵。開啟或切換幫助資訊的顯示。 VK_HELP (0x2F)
APPCOMMAND_HELP
kVK_Help (0x72) GDK_KEY_Help (0xFF6A)
Qt::Key_Help (0x01000058)
KEYCODE_HELP (259)
"Pause" Pause 鍵。如果適用,暫停當前應用程式或狀態。

注意:不應與 "MediaPause" 鍵值混淆,後者用於媒體控制器,而不是控制應用程式和程序。

VK_PAUSE (0x13) GDK_KEY_Pause (0xFF13)
GDK_KEY_Break (0xFF6B)
Qt::Key_Pause (0x01000008)
KEYCODE_BREAK (121)
"Play" Play 鍵。如果適用,恢復先前暫停的應用程式。

注意:不應與 "MediaPlay" 鍵值混淆,後者用於媒體控制器,而不是控制應用程式和程序。

VK_PLAY (0xFA) GDK_KEY_3270_Play (0xFD16)
Qt::Key_Play (0x01020005)
"Props" Props (Properties) 鍵。
"Select" Select 鍵。 VK_SELECT (0x29) GDK_KEY_Select (0xFF60) KEYCODE_BUTTON_SELECT (109)
"ZoomIn" [6] ZoomIn 鍵。 GDK_KEY_ZoomIn (0x1008FF8B)
Qt::Key_ZoomIn (0x010000F6)
KEYCODE_ZOOM_IN (168)
"ZoomOut" [6] ZoomOut 鍵。 GDK_KEY_ZoomOut (0x1008FF8C)
Qt::Key_ZoomOut (0x010000F7)
KEYCODE_ZOOM_OUT (169)

[1] 在 Google Chrome 52 中,Cancel 鍵錯誤地返回了 "Pause" 鍵碼。此問題在 Chrome 53 中已修復。(詳見 Chrome bug 612749。)

[2] 在 Firefox 36 及更早版本中,Esc 鍵返回 "Esc" 而不是 "Escape"

[3] Firefox 36 及更早版本為上下文選單鍵報告 "Apps" 而不是 "ContextMenu"

[4] 在 Firefox 和 Google Chrome 中,Attn 鍵生成 "Unidentified" 鍵碼,除非使用日語鍵盤佈局,在這種情況下它會生成 "KanaMode"

[5] 在 Firefox 中,Finish 鍵生成 "Unidentified" 鍵碼,除非使用日語鍵盤佈局,在這種情況下它會生成 "Katakana"

[6] Firefox 直到 Firefox 37 才支援 "ZoomIn""ZoomOut" 鍵。

裝置鍵

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"BrightnessDown" 亮度降低鍵。通常用於降低顯示器的亮度。 GDK_KEY_MonBrightnessDown (0x1008FF03)
Qt::Key_MonBrightnessDown (0x010000B3)
KEYCODE_BRIGHTNESS_DOWN (220)
"BrightnessUp" 亮度增加鍵。通常增加顯示器的亮度。 GDK_KEY_MonBrightnessUp (0x1008FF02)
Qt::Key_MonBrightnessUp (0x010000B2)
KEYCODE_BRIGHTNESS_UP (221)
"Eject" Eject 鍵。彈出可移動媒體(或切換光碟機托盤的開啟和關閉)。 GDK_KEY_Eject (0x1008FF2C)
Qt::Key_Eject (0x010000B9)
KEYCODE_MEDIA_EJECT (129)
"LogOff" [2] LogOff 鍵。 GDK_KEY_LogOff (0x1008FF61)
Qt::Key_LogOff (0x010000D9)
"Power" Power 按鈕或鍵,用於開關電源。

注意:並非所有系統都會將此鍵傳遞給使用者代理。

KEYCODE_POWER (26)
"PowerOff" PowerOffPowerDown 鍵。關閉系統。 GDK_KEY_PowerDown (0x1008FF21)
GDK_KEY_PowerOff (0x1008FF2A)
Qt::Key_PowerDown (0x0100010B)
Qt::Key_PowerOff (0x010000B7)
"PrintScreen" PrintScreenPrtScr 鍵。有時是 SnapShot。捕捉螢幕並列印或儲存到磁碟。 VK_SNAPSHOT (0x2C) GDK_KEY_3270_PrintScreen (0xFD1D)
GDK_KEY_Print (0xFF61)
GDK_KEY_Sys_Req (0xFF15)
Qt::Key_Print (0x01000009)
Qt::Key_SysReq (0x0100000A)
KEYCODE_SYSRQ (120)
"Hibernate" [2] Hibernate 鍵。將計算機狀態儲存到磁碟然後關閉;計算機可以透過恢復儲存的狀態資訊返回到之前的狀態。 GDK_KEY_Hibernate (0x1008FFA8)
Qt::Key_Hibernate (0x01000108)
"Standby" [1] Standby 鍵。(也稱為 SuspendSleep。)這會關閉顯示器並將計算機置於低功耗模式,而不會完全關閉電源。 VK_SLEEP (0x5F) GDK_KEY_Standby (0x1008FF10)
GDK_KEY_Suspend (0x1008FFA7)
GDK_KEY_Sleep (0x1008FF2F)
Qt::Key_Standby (0x01000093)
Qt::Key_Suspend (0x0100010C)
Qt::Key_Sleep (0x01020004)
KEYCODE_SLEEP (223)
"WakeUp" [2] WakeUp 鍵。用於從休眠或待機模式喚醒計算機。 GDK_KEY_WakeUp (0x1008FF2B)
Qt::Key_WakeUp (0x010000B8)
KEYCODE_WAKEUP (224)

[1] Firefox 36 及更早版本不支援 Standby 鍵,因此它被報告為 "Unidentified"

[2] 在 Firefox 37 之前,此鍵生成 "Unidentified" 值。

IME 與編輯鍵

在使用輸入法編輯器 (IME) 輸入無法透過簡單按鍵輸入的文字時使用的鍵,例如那些字形比鍵盤上的字元輸入鍵多的語言的文字。常見的例子包括中文、日文、韓文和印地文。

一些鍵在多種語言中是通用的,而另一些只存在於針對特定語言的鍵盤上。此外,並非所有鍵盤都擁有所有這些鍵。

通用 IME 鍵

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"AllCandidates" All Candidates(所有候選)鍵,啟動多候選模式,在該模式下為正在進行的輸入顯示多個候選詞。 GDK_KEY_MultipleCandidate (0xFF3D
Qt::Key_MultipleCandidate (0x0100113D)
"Alphanumeric" Alphanumeric(字母數字)鍵。 VK_OEM_ATTN (0xF0) GDK_KEY_Eisu_Shift (0xFF2F)
GDK_KEY_Eisu_toggle (0xFF30)
Qt::Key_Eisu_Shift (0x0100112f)
Qt::Key_Eisu_toggle (0x01001130)
"CodeInput" Code Input(程式碼輸入)鍵,啟用程式碼輸入模式,讓使用者透過鍵入其碼點(通常是其 Unicode 字元編號)來輸入字元。 GDK_KEY_Codeinput (0xFF37)
Qt::Key_Codeinput (0x01001137)
"Compose" Compose 鍵。 GDK_KEY_Multi_key (0xFF20) [1]
Qt::Key_Multi_key (0x01001120)
"Convert" [4] Convert(轉換)鍵,指示 IME 將當前的輸入法序列轉換為結果字元。 VK_CONVERT (0x1C) GDK_KEY_Henkan (0xFF23)
Qt::Key_Henkan (0x01001123)
KEYCODE_HENKAN (214)
"Dead"

一個“死”組合鍵;也就是說,一個與其他鍵一起使用以生成帶重音符號和其他修飾字符的鍵。如果單獨按下,它不會生成字元。

如果您希望識別按下了哪個特定的死鍵(在存在多個死鍵的情況下),您可以透過檢查 KeyboardEvent 的相關 compositionupdate 事件的 data 屬性來做到這一點。

見下文Linux 的死鍵鍵碼
"FinalMode" Final (Final Mode) 鍵在一些亞洲鍵盤上用於在使用 IME 時進入最終模式。 VK_FINAL (0x18)
"GroupFirst" ISO/IEC 9995 鍵盤上切換到第一個字元組。每個鍵可能有多個字元組,每個組在自己的列中。按下此鍵指示裝置在後續擊鍵中將按鍵解釋為來自第一列。 GDK_KEY_ISO_First_Group (0xFE0C)
"GroupLast" ISO/IEC 9995 鍵盤上切換到最後一個字元組。 GDK_KEY_ISO_Last_Group (0xFE0E)
"GroupNext" [4] ISO/IEC 9995 鍵盤上切換到下一個字元組。 GDK_KEY_ISO_Next_Group (0xFE08) KEYCODE_LANGUAGE_SWITCH (204)
"GroupPrevious" ISO/IEC 9995 鍵盤上切換到上一個字元組。 GDK_KEY_ISO_Prev_Group (0xFE0A)
"ModeChange" [5] 模式更改鍵。在 IME 的輸入模式之間切換或迴圈。 VK_MODECHANGE (0x1F) GDK_KEY_Mode_switch (0xFF7E)
GDK_KEY_script_switch (0xFF7E)
Qt::Key_Mode_switch (0x0100117E)
KEYCODE_SWITCH_CHARSET (95)
"NextCandidate" 下一個候選功能鍵。為正在進行的輸入選擇下一個可能的匹配項。
"NonConvert" [2] NonConvert(“不轉換”)鍵。在使用 IME 時,此鍵接受當前的輸入法序列而不進行轉換。 VK_NONCONVERT (0x1D) GDK_KEY_Muhenkan (0xFF22)
Qt::Key_Muhenkan (0x01001122)
KEYCODE_MUHENKAN (213)
"PreviousCandidate" 上一個候選鍵。為正在進行的輸入選擇上一個可能的匹配項。 GDK_KEY_PreviousCandidate (0xFF3E)
Qt::Key_PreviousCandidate (0x0100113E)
"Process" [3] Process(處理)鍵。指示 IME 處理轉換。 VK_PROCESSKEY (0xE5)
"SingleCandidate" [4] 單個候選鍵。啟用單個候選模式(相對於多候選模式);在此模式下,一次只顯示一個候選詞。 GDK_KEY_SingleCandidate (0xFF3C)
Qt::Key_SingleCandidate (0x0100113C)

[1] 在 X Window System 上,Compose 鍵被稱為 Multi 鍵。

[2] Firefox 版本 36 及更早版本將 NonConvert 鍵報告為 "Nonconvert" 而不是正確的 "NonConvert"

[3] Process 鍵當前在 Firefox 中返回 "Unidentified"。Google Chrome 返回該鍵的值,就像沒有使用 IME 一樣。

[4] 在 Firefox 37 之前,這些鍵是 "Unidentified"

[5] Firefox 生成鍵值 "AltGraph" 而不是 "ModeChange"

僅限韓語鍵盤

這些鍵僅在韓語鍵盤上可用。有其他由各種平臺為韓語鍵盤定義的鍵,但這些是最常見的,也是 UI 事件規範所識別的。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"HangulMode" Hangul(韓文字元集)模式鍵,在韓文和英文輸入模式之間切換。 VK_HANGUL (0x15) [1] GDK_KEY_Hangul (0xFF31)
Qt::Key_Hangul (0x01001131)
"HanjaMode" 選擇 Hanja 模式,用於將 Hangul 字元轉換為更具體的 Hanja 字元。 VK_HANJA (0x19) [1] GDK_KEY_Hangul_Hanja (0xFF34)
Qt::Key_Hangul_Hanja (0x01001134)
"JunjaMode" 選擇 Junja 模式,在該模式下,韓語使用單位元組拉丁字元表示。 VK_JUNJA (0x17) GDK_KEY_Hangul_Jeonja (0xFF38)
Qt::Key_Hangul_Jeonja (0x01001138)

[1] 在 Windows 上,VK_HANGULVK_KANA 共享相同的數字鍵值,VK_HANJAVK_KANJI 也是如此。

僅限日語鍵盤

這些鍵僅在日語鍵盤上可用。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"Eisu" [1] Eisu 鍵。此鍵的用途由 IME 定義,但可用於關閉 IME。 kVK_JIS_Eisu (0x66) GDK_KEY_Eisu_toggle (0xFF2F)
Qt::Key_Eisu_toggle (0x01001130)
KEYCODE_EISU (212)
"Hankaku" [3] Hankaku(半形字元)鍵。 VK_OEM_AUTO (0xF3) GDK_KEY_Hankaku (0xFF29)
Qt::Key_Hankaku (0x01001129)
"Hiragana" Hiragana(平假名)鍵;選擇假名字元模式。 VK_OEM_COPY (0xF2) GDK_KEY_Hiragana (0xFF25)
Qt::Key_Hiragana (0x01001125)
"HiraganaKatakana" [6] 在平假名和片假名書寫系統之間切換。 GDK_KEY_Hiragana_Katakana (0xFF27)
Qt::Key_Hiragana_Katakana (0x01001127)
KEYCODE_KATAKANA_HIRAGANA (215)
"KanaMode" Kana Mode(假名鎖定)鍵。 VK_KANA (0x15) [2]
VK_ATTN (0xF6)
GDK_KEY_Kana_Lock (0xFF2D)
GDK_KEY_Kana_Shift (0xFF2E)
Qt::Key_Kana_Lock (0x0100112D)
Qt::Key_Kana_Shift (0x0100112E)
"KanjiMode" Kanji Mode(漢字模式)鍵。啟用使用源自中國的表意文字輸入日語文字。 VK_KANJI [2] kVK_JIS_Kana (0x68) GDK_KEY_Kanji (0xFF21)
Qt::Key_Kanji (0x01001121)
KEYCODE_KANA (218)
"Katakana" Katakana(片假名)鍵。 VK_OEM_FINISH (0xF1) GDK_KEY_Katakana (0xFF26)
Qt::Key_Katakana (0x01001126)
"Romaji" [5] Romaji(羅馬字)鍵;選擇羅馬字元集。 VK_OEM_BACKTAB (0xF5) GDK_KEY_Romaji (0xFF24)
Qt::Key_Romaji (0x01001124)
"Zenkaku" [4] Zenkaku(全形)字元鍵。 VK_OEM_ENLW (0xF4) GDK_KEY_Zenkaku (0xFF28)
Qt::Key_Zenkaku (0x01001128)
"ZenkakuHankaku" [6] Zenkaku/Hankaku(全形/半形)切換鍵。 GDK_KEY_Zenkaku_Hankaku (0xFF2A)
Qt::Zenkaku_Hankaku (0x0100112A)

KEYCODE_ZENKAKU_HANKAKU (211)

[1] 在 Firefox 37 之前,Eisu 鍵錯誤地對映為 "RomanCharacters"

[2] 在 Windows 上,VK_HANGULVK_KANA 共享相同的數字鍵值,VK_HANJAVK_KANJI 也是如此。

[3] 在 Firefox 37 之前,Hankaku(半形)鍵在 Firefox 上生成鍵值 "HalfWidth"

[4] Firefox 36 及更早版本在日語鍵盤佈局上將此鍵識別為 "FullWidth",在所有其他鍵盤佈局上識別為 "Unidentified"。Firefox 37 及更高版本以及所有版本的 Google Chrome 都能正確返回 "Zenkaku"

[5] Firefox 36 及更早版本在日語鍵盤上將 Romaji 鍵識別為 "RomanCharacters",在其他鍵盤上識別為 "Unidentified";在 Firefox 37 及更高版本中,這已更正為返回 "Romaji"

[6] 在 Firefox 37 之前,此鍵被報告為 "Unidentified"

Linux 的死鍵鍵碼

Linux 使用特殊的死鍵生成帶重音的字元。死鍵是與字元鍵組合按下以生成這些字元的帶重音形式的鍵。您可以透過檢查 KeyboardEvent 的相關 compositionupdate 事件的 data 屬性來識別使用了哪個特定的死鍵(如果存在多個)。

您可以在使用 GTK 的 Linux 上找到一個死鍵表,以及它們可以與哪些字元一起使用來生成帶重音或其他特殊字元。

data 的值將是以下之一

CompositionEvent.data 符號 註釋
GDK_KEY_dead_grave (0xFE50)
Qt::Key_Dead_Grave (0x01001250)
`
GDK_KEY_dead_acute (0xFE51)
Qt::Key_Dead_Acute (0x01001251)
´
GDK_KEY_dead_circumflex (0xFE52)
Qt::Key_Dead_Circumflex (0x01001252)
ˆ
GDK_KEY_dead_tilde (0xFE53)
Qt::Key_Dead_Tilde (0x01001253)
˜
GDK_KEY_dead_perispomeni (0xFE53) ͂
GDK_KEY_dead_macron (0xFE54)
Qt::Key_Dead_Macron (0x01001254)
¯
GDK_KEY_dead_breve (0xFE55)
Qt::Key_Dead_Breve (0x01001255)
˘
GDK_KEY_dead_abovedot (0xFE56)
Qt::Key_Dead_Abovedot (0x01001256)
˙
GDK_KEY_dead_diaeresis (0xFE57)
Qt::Key_Dead_Diaeresis (0x01001257)
¨ 也稱為變音符號。
GDK_KEY_dead_abovering (0xFE58)
Qt::Key_Dead_Abovering (0x01001258)
˚
GDK_KEY_dead_doubleacute (0xFE59)
Qt::Key_Dead_Doubleacute (0x01001259)
˝
GDK_KEY_dead_caron (0xFE5A)
Qt::Key_Dead_Caron (0x0100125A)
ˇ 也稱為 háček;用於捷克語等語言。
GDK_KEY_dead_cedilla (0xFE5B)
Qt::Key_Dead_Cedilla (0x0100125B)
¸
GDK_KEY_dead_ogonek (0xFE5C)
Qt::Key_Dead_Ogonek (0x0100125C)
˛ 也稱為 nosinė;用於波蘭語和古愛爾蘭語。
GDK_KEY_dead_iota (0xFE5D)
Qt::Key_Dead_Iota (0x0100125D)
ͅ Iota 下標。
GDK_KEY_dead_voiced_sound (0xFE5E)
Qt::Key_Dead_Voiced_Sound (0x0100125E)
GDK_KEY_dead_semivoiced_sound (0xFE5F)
Qt::Key_Dead_Semivoiced_Sound (0x0100125F)
GDK_KEY_dead_belowdot (0xFE60)
Qt::Key_Dead_Belowdot (0x01001260)
̣̣
GDK_KEY_dead_hook (0xFE61)
Qt::Key_Dead_Hook (0x01001261)
̡
GDK_KEY_dead_horn (0xFE62)
Qt::Key_Dead_Horn (0x01001262)
̛
GDK_KEY_dead_stroke (0xFE63) ̶̶
GDK_KEY_dead_abovecomma (0xFE64) ̓̓
GDK_KEY_dead_psili (0xFE64) ᾿
GDK_KEY_dead_abovereversedcomma (0xFE65) ʽ
GDK_KEY_dead_dasia (0xFE65)
GDK_KEY_dead_doublegrave (0xFE66) ̏
GDK_KEY_dead_belowring (0xFE67) ˳
GDK_KEY_dead_belowmacron (0xFE68) ̱
GDK_KEY_dead_belowcircumflex (0xFE69)
GDK_KEY_dead_belowtilde (0xFE6A) ̰
GDK_KEY_dead_belowbreve (0xFE6B) ̮
GDK_KEY_dead_belowdiaeresis (0xFE6C) ̤
GDK_KEY_dead_invertedbreve (0xFE6D) ̯
GDK_KEY_dead_belowcomma (0xFE6E) ̦
GDK_KEY_dead_currency (0xFE6F)
GDK_KEY_dead_a (0xFE80)
GDK_KEY_dead_A (0xFE81)
GDK_KEY_dead_e (0xFE82)
GDK_KEY_dead_E (0xFE83)
GDK_KEY_dead_i (0xFE84)
GDK_KEY_dead_I (0xFE85)
GDK_KEY_dead_o (0xFE86)
GDK_KEY_dead_O (0xFE87)
GDK_KEY_dead_u (0xFE88)
GDK_KEY_dead_U (0xFE89)
GDK_KEY_dead_small_schwa (0xFE8A) ə
GDK_KEY_dead_capital_schwa (0xFE8B) Ə
GDK_KEY_dead_greek (0xFE8C)

功能鍵

儘管不同平臺支援不同數量的通用功能鍵,例如 F1F12(或 F1F10F1F15 等),但前幾個是特別定義的,如下所示。

如果還有更多功能鍵可用,它們的名稱將延續此處的模式,繼續增加每個鍵名稱中的數字部分,例如,"F24" 是一個有效的鍵值。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"F1" 第一個通用功能鍵,F1 VK_F1 (0x70) kVK_F1 (0x7A) GDK_KEY_F1 (0xFFBE)
GDK_KEY_KP_F1 (0xFF91)
Qt::Key_F1 (0x01000030)
KEYCODE_F1 (131)
"F2" F2 鍵。 VK_F2 (0x71) kVK_F2 (0x78) GDK_KEY_F2 (0xFFBF)
GDK_KEY_KP_F2 (0xFF92)
Qt::Key_F2 (0x01000031)
KEYCODE_F2 (132)
"F3" F3 鍵。 VK_F3 (0x72) kVK_F3 (0x63) GDK_KEY_F3 (0xFFC0)
GDK_KEY_KP_F3 (0xFF93)
Qt::Key_F3 (0x01000032)
KEYCODE_F3 (133)
"F4" F4 鍵。 VK_F4 (0x73) kVK_F4 (0x76) GDK_KEY_F4 (0xFFC1)
GDK_KEY_KP_F4 (0xFF94)
Qt::Key_F4 (0x01000033)
KEYCODE_F4 (134)
"F5" F5 鍵。 VK_F5 (0x74) kVK_F5 (0x60) GDK_KEY_F5 (0xFFC2)
Qt::Key_F5 (0x01000034)
KEYCODE_F5 (135)
"F6" F6 鍵。 VK_F6 (0x75) kVK_F6 (0x61) GDK_KEY_F6 (0xFFC3)
Qt::Key_F6 (0x01000035)
KEYCODE_F6 (136)
"F7" F7 鍵。 VK_F7 (0x76) kVK_F7 (0x62) GDK_KEY_F7 (0xFFC4)
Qt::Key_F7 (0x01000036)
KEYCODE_F7 (137)
"F8" F8 鍵。 VK_F8 (0x77) kVK_F8 (0x64) GDK_KEY_F8 (0xFFC5)
Qt::Key_F8 (0x01000037)
KEYCODE_F8 (138)
"F9" F9 鍵。 VK_F9 (0x78) kVK_F9 (0x65) GDK_KEY_F9 (0xFFC6)
Qt::Key_F9 (0x01000038)
KEYCODE_F9 (139)
"F10" F10 鍵。 VK_F10 (0x79) kVK_F10 (0x6D) GDK_KEY_F10 (0xFFC7)
Qt::Key_F10 (0x01000039)
KEYCODE_F10 (140)
"F11" F11 鍵。 VK_F11 (0x7A) kVK_F11 (0x67) GDK_KEY_F11 (0xFFC8)
Qt::Key_F11 (0x0100003A)
KEYCODE_F11 (141)
"F12" F12 鍵。 VK_F12 (0x7B) kVK_F12 (0x6F) GDK_KEY_F12 (0xFFC9)
Qt::Key_F12 (0x0100003B)
KEYCODE_F12 (142)
"F13" F13 鍵。 VK_F13 (0x7C) kVK_F13 (0x69) GDK_KEY_F13 (0xFFCA)
Qt::Key_F13 (0x0100003C)
KEYCODE_F13
"F14" F14 鍵。 VK_F14 (0x7D) kVK_F14 (0x6B) GDK_KEY_F14 (0xFFCB)
Qt::Key_F14 (0x0100003D)
KEYCODE_F14
"F15" F15 鍵。 VK_F15 (0x7E) kVK_F15 (0x71) GDK_KEY_F15 (0xFFCC)
Qt::Key_F15 (0x0100003E)
KEYCODE_F15
"F16" F16 鍵。 VK_F16 (0x7F) kVK_F16 (0x6A) GDK_KEY_F16 (0xFFCD)
Qt::Key_F16 (0x0100003F)
KEYCODE_F16
"F17" F17 鍵。 VK_F17 (0x80) kVK_F17 (0x40) GDK_KEY_F17 (0xFFCE)
Qt::Key_F17 (0x01000040)
KEYCODE_F17
"F18" F18 鍵。 VK_F18 (0x81) kVK_F18 (0x4F) GDK_KEY_F18 (0xFFCF)
Qt::Key_F18 (0x01000041)
KEYCODE_F18
"F19" F19 鍵。 VK_F19 (0x82) kVK_F19 (0x50) GDK_KEY_F19 (0xFFD0)
Qt::Key_F19 (0x01000042)
KEYCODE_F19
"F20" F20 鍵。 VK_F20 (0x83) kVK_F20 (0x5A) GDK_KEY_F20 (0xFFD1)
Qt::Key_F20 (0x01000043)
KEYCODE_F20
"Soft1" 第一個通用虛擬功能鍵。 Qt::Key_Context1 (0x01100000)
"Soft2" 第二個通用虛擬功能鍵。 Qt::Key_Context2 (0x01100001)
"Soft3" 第三個通用虛擬功能鍵。 Qt::Key_Context3 (0x01100002)
"Soft4" 第四個通用虛擬功能鍵。 Qt::Key_Context4 (0x01100003)

電話鍵

這些按鍵代表通常存在於現代智慧手機上的按鈕。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"AppSwitch" 呈現最近使用的應用程式列表,讓使用者快速切換應用。 KEYCODE_APP_SWITCH (187)
"Call" Call 鍵。撥打已輸入的號碼。 Qt::Key_Call (0x01100004) KEYCODE_CALL (5)
"Camera" Camera 鍵。啟用相機。 Qt::Key_Camera (0x01100020) KEYCODE_CAMERA (27)
"CameraFocus" Focus 鍵。對焦相機。 Qt::Key_CameraFocus (0x01100021) KEYCODE_FOCUS (80)
"EndCall" End CallHang Up 按鈕。 Qt::Key_Hangup (0x01100005) KEYCODE_ENDCALL (6)
"GoBack" Back 按鈕。 KEYCODE_BACK (4)
"GoHome" [1] Home 按鈕。將使用者返回到手機主螢幕(通常是應用程式啟動器)。 KEYCODE_HOME (3)
"HeadsetHook" Headset Hook 鍵。這通常是耳機上的一個按鈕,用於結束通話電話和播放或暫停媒體。 Qt::Key_ToggleCallHangup (0x01100007) KEYCODE_HEADSETHOOK (79)
"LastNumberRedial" Redial 按鈕。重撥最後一個通話號碼。 Qt::Key_LastNumberRedial (0x01100009)
"Notification" Notification 鍵。 KEYCODE_NOTIFICATION (83)
"MannerMode" 一個在通知模式(靜音、振動、響鈴等)之間迴圈的按鈕。 KEYCODE_MANNER_MODE (205)
"VoiceDial" Voice Dial 鍵。啟動語音撥號。 Qt::Key_VoiceDial (0x01100008) KEYCODE_VOICE_ASSIST (231)

[1] 在 Firefox 37 之前,Home 按鈕生成的鍵碼為 "Exit"。從 Firefox 37 開始,該按鈕生成的鍵碼為 "MozHomeScreen"

多媒體鍵

多媒體鍵是用於控制媒體裝置的額外按鈕或按鍵,常見於一些鍵盤上。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"ChannelDown" 切換到上一個頻道。 APPCOMMAND_MEDIA_CHANNEL_DOWN Qt::Key_ChannelDown (0x01000119) KEYCODE_CHANNEL_DOWN (167)
"ChannelUp" 切換到下一個頻道。 APPCOMMAND_MEDIA_CHANNEL_UP Qt::Key_ChannelUp (0x01000118) KEYCODE_CHANNEL_UP (166)
"MediaFastForward" [2] 開始、繼續或增加媒體快進的速度。 APPCOMMAND_MEDIA_FAST_FORWARD GDK_KEY_AudioForward (0x1008FF97)
Qt:Key_AudioForward
(0x01000102)
KEYCODE_MEDIA_FAST_FORWARD (90)
"MediaPause"

暫停當前播放的媒體。

注意:一些舊的應用程式使用 "Pause",但這是不正確的。

APPCOMMAND_MEDIA_PAUSE GDK_KEY_AudioPause (0x1008FF31)
Qt::Key_MediaPause (0x1000085)
KEYCODE_MEDIA_PAUSE (127)
"MediaPlay" 如果尚未以正常速度播放媒體,則開始或繼續播放。否則無效果。 APPCOMMAND_MEDIA_PLAY GDK_KEY_AudioPlay (0x1008FF14) KEYCODE_MEDIA_PLAY (126)
"MediaPlayPause" 在播放和暫停當前媒體之間切換。 VK_MEDIA_PLAY_PAUSE (0xB3)
APPCOMMAND_MEDIA_PLAY_PAUSE
Qt::Key_MediaTogglePlayPause (0x1000086) KEYCODE_MEDIA_PLAY_PAUSE (85)
"MediaRecord" 開始或恢復錄製媒體。 APPCOMMAND_MEDIA_RECORD GDK_KEY_AudioRecord (0x1008FF1C)
Qt::Key_MediaRecord (0x01000084)
KEYCODE_MEDIA_RECORD (130)
"MediaRewind" 開始、繼續或增加媒體快退的速度。 APPCOMMAND_MEDIA_REWIND GDK_KEY_AudioRewind (0x1008FF3E)
Qt::Key_AudioRewind (0x010000C5)
KEYCODE_MEDIA_REWIND (89)
"MediaStop" 停止當前的媒體活動(如播放、錄製、暫停、快進或快退)。如果媒體當前已停止,則無效果。 VK_MEDIA_STOP (0xB2)
APPCOMMAND_MEDIA_STOP
GDK_KEY_AudioStop (0x1008FF15)
Qt::Key_MediaStop (0x01000081)
KEYCODE_MEDIA_STOP (86)
"MediaTrackNext" [1] 尋找下一個媒體或節目軌道。 VK_MEDIA_NEXT_TRACK (0xB0)
APPCOMMAND_MEDIA_NEXTTRACK
GDK_KEY_AudioNext (0x1008FF17)
Qt::Key_MediaNext (0x01000083)
KEYCODE_MEDIA_NEXT (87)
"MediaTrackPrevious" [1] 尋找上一個媒體或節目軌道。 VK_MEDIA_PREV_TRACK (0xB1)
APPCOMMAND_MEDIA_PREVIOUSTRACK
GDK_KEY_AudioPrev (0x1008FF16)
Qt::Key_MediaPrevious (0x01000082)
KEYCODE_MEDIA_PREVIOUS (88)

[1] 舊版 Edge 和 Firefox(36 及更早版本)使用 "MediaNextTrack""MediaPreviousTrack",而不是 "MediaTrackNext""MediaTrackPrevious"

[2] 在 Firefox 37 之前,Firefox 在某些平臺上生成 "FastFwd" 鍵碼,在其他平臺上生成 "Unidentified",而不是 "MediaFastForward"

音訊控制鍵

這些媒體鍵專門用於控制音訊。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"AudioBalanceLeft" 向左調整音訊平衡。 VK_AUDIO_BALANCE_LEFT
"AudioBalanceRight" 向右調整音訊平衡。 VK_AUDIO_BALANCE_RIGHT
"AudioBassDown" 減少低音量。 APPCOMMAND_BASS_DOWN
"AudioBassBoostDown" 減少低音增強或在低音增強模式或狀態中向下迴圈。 VK_BASS_BOOST_DOWN
"AudioBassBoostToggle" 開啟和關閉低音增強。 APPCOMMAND_BASS_BOOST
"AudioBassBoostUp" 增加低音增強量,或在一組低音增強模式或狀態中向上迴圈。 VK_BASS_BOOST_UP
"AudioBassUp" 增加低音量。 APPCOMMAND_BASS_UP
"AudioFaderFront" 向前調整音訊推子。 VK_FADER_FRONT
"AudioFaderRear" 向後調整音訊推子。 VK_FADER_REAR
"AudioSurroundModeNext" 選擇下一個可用的環繞聲模式。 VK_SURROUND_MODE_NEXT
"AudioTrebleDown" 減少高音量。 APPCOMMAND_TREBLE_DOWN
"AudioTrebleUp" 增加高音量。 APPCOMMAND_TREBLE_UP
"AudioVolumeDown" [1] 降低音量。 VK_VOLUME_DOWN (0xAE)
APPCOMMAND_VOLUME_DOWN
kVK_VolumeDown (0x49) GDK_KEY_AudioLowerVolume (0x1008FF11)
Qt::Key_VolumeDown (0x01000070)
KEYCODE_VOLUME_DOWN (25)
"AudioVolumeMute" [1] 靜音。 VK_VOLUME_MUTE (0xAD)
APPCOMMAND_VOLUME_MUTE
kVK_Mute (0x4A) GDK_KEY_AudioMute (0x1008FF12)
Qt::Key_VolumeMute (0x01000071)
KEYCODE_VOLUME_MUTE (164)
"AudioVolumeUp" [1] 增加音量。 VK_VOLUME_UP (0xAF)
APPCOMMAND_VOLUME_UP
kVK_VolumeUp (0x48) GDK_KEY_AudioRaiseVolume (0x1008FF13)
Qt::Key_VolumeUp (0x01000072)
KEYCODE_VOLUME_UP (24)
"MicrophoneToggle" 開啟和關閉麥克風。 APPCOMMAND_MIC_ON_OFF_TOGGLE
"MicrophoneVolumeDown" 降低麥克風的輸入音量。 APPCOMMAND_MICROPHONE_VOLUME_DOWN Qt::Key_MicVolumeDown (0x0100011E)
"MicrophoneVolumeMute" 靜音麥克風輸入。 APPCOMMAND_MICROPHONE_VOLUME_MUTE GDK_KEY_AudioMicMute (0x1008FFB2)
Qt::Key_MicMute (0x01000113)
KEYCODE_MUTE (91)
"MicrophoneVolumeUp" 增加麥克風的輸入音量。 APPCOMMAND_MICROPHONE_VOLUME_UP Qt::Key_MicVolumeUp (0x0100011D)

[1] 舊版 Edge 和 Firefox(48 及更早版本)使用 "VolumeUp""VolumeDown""VolumeMute",而不是 "AudioVolumeUp""AudioVolumeDown""AudioVolumeMute"。在 Firefox 49 中,它們已更新以匹配最新的規範。

電視控制鍵

這些鍵值代表電視裝置上或具有電視支援的計算機或手機上的按鈕或按鍵。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"TV" [1] 切換到電視觀看模式。 KEYCODE_TV (170)
"TV3DMode" 開啟和關閉 3D 電視模式。 KEYCODE_3D_MODE (206)
"TVAntennaCable" 在天線和有線輸入之間切換。 KEYCODE_TV_ANTENNA_CABLE (242)
"TVAudioDescription" 開啟和關閉音訊描述模式。 KEYCODE_TV_AUDIO_DESCRIPTION (252)
"TVAudioDescriptionMixDown" 降低音訊描述的混音音量;相對於節目聲音減少音訊描述的音量。 KEYCODE_TV_AUDIO_DESCRIPTION_MIX_DOWN (254)
"TVAudioDescriptionMixUp" 增加音訊描述的混音音量;相對於節目聲音增加音訊描述的音量。 KEYCODE_TV_AUDIO_DESCRIPTION_MIX_UP (253)
"TVContentsMenu" 顯示或隱藏可播放的媒體內容(這可能是顯示當前正在播放的節目的頻道指南,或要播放的媒體檔案列表)。 KEYCODE_TV_CONTENTS_MENU (256)
"TVDataService" 顯示或隱藏電視的資料服務選單。 KEYCODE_TV_DATA_SERVICE (230)
"TVInput" [2] 在外部電視上迴圈輸入模式。 KEYCODE_TV_INPUT (178)
"TVInputComponent1" 切換到輸入“Component 1”。 KEYCODE_TV_INPUT_COMPONENT_1 (249)
"TVInputComponent2" 切換到輸入“Component 2”。 KEYCODE_TV_INPUT_COMPONENT_2 (250)
"TVInputComposite1" 切換到輸入“Composite 1”。 KEYCODE_TV_INPUT_COMPOSITE_1 (247)
"TVInputComposite2" 切換到輸入“Composite 2”。 KEYCODE_TV_INPUT_COMPOSITE_2 (248)
"TVInputHDMI1" 切換到輸入“HDMI 1”。 KEYCODE_TV_INPUT_HDMI_1 (243)
"TVInputHDMI2" 切換到輸入“HDMI 2”。 KEYCODE_TV_INPUT_HDMI_2 (244)
"TVInputHDMI3" 切換到輸入“HDMI 3”。 KEYCODE_TV_INPUT_HDMI_3 (245)
"TVInputHDMI4" 切換到輸入“HDMI 4”。 KEYCODE_TV_INPUT_HDMI_4 (246)
"TVInputVGA1" 切換到輸入“VGA 1”。 KEYCODE_TV_INPUT_VGA_1 (251)
"TVMediaContext" 媒體上下文選單鍵。 KEYCODE_TV_MEDIA_CONTEXT_MENU (257)
"TVNetwork" 開啟和關閉電視的網路連線。 KEYCODE_TV_NETWORK (241)
"TVNumberEntry" 將電視置於數字輸入模式。 KEYCODE_TV_NUMBER_ENTRY (234)
"TVPower" [2] 裝置的電源按鈕。 KEYCODE_TV_POWER (177)
"TVRadioService" 收音機按鈕。 KEYCODE_TV_RADIO_SERVICE (232)
"TVSatellite" 衛星按鈕。 KEYCODE_TV_SATELLITE (237)
"TVSatelliteBS" 廣播衛星按鈕。 KEYCODE_TV_SATELLITE_BS (238)
"TVSatelliteCS" 通訊衛星按鈕。 KEYCODE_TV_SATELLITE_CS (239)
"TVSatelliteToggle" 在可用衛星之間切換。 KEYCODE_TV_SATELLITE_SERVICE (240)
"TVTerrestrialAnalog" 選擇模擬地面電視服務(模擬有線或天線接收)。 KEYCODE_TV_TERRESTRIAL_ANALOG (235)
"TVTerrestrialDigital" 選擇數字地面電視服務(數字有線或天線接收)。 KEYCODE_TV_TERRESTRIAL_DIGITAL (236)
"TVTimer" 定時器程式設計按鈕。 KEYCODE_TV_TIMER_PROGRAMMING (258)

[1] Firefox 在 Firefox 37 中添加了對 "TV" 鍵的正確支援;在此之前,此鍵生成的鍵碼為 "Live"

[2] 在 Firefox 37 之前,這些鍵是 "Unidentified"

媒體控制器鍵

因為現代媒體裝置的遙控器通常包含超出本文件其他部分所涵蓋的基本控制的按鈕,所以為這些額外的按鈕定義了廣泛的鍵值。

以下值部分源自一些消費電子技術規範

注意:遙控器通常包含其值已在別處定義的鍵,例如在多媒體鍵音訊控制鍵下。這些鍵的值將與這些表中記錄的內容匹配。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"AVRInput" [3] 更改外部音訊/影片接收器 (AVR) 單元上的輸入模式。 KEYCODE_AVR_INPUT (182)
"AVRPower" [3] 切換外部 AVR 單元的電源。 KEYCODE_AVR_POWER (181)
"ColorF0Red" [3] 通用媒體功能鍵,顏色編碼為紅色。在彩色鍵中,其索引為 0 VK_COLORED_KEY_0 KEYCODE_PROG_RED (183)
"ColorF1Green" [3] 通用媒體功能鍵,顏色編碼為綠色。在彩色鍵中,其索引為 1 VK_COLORED_KEY_1 KEYCODE_PROG_GREEN (184)
"ColorF2Yellow" [3] 通用媒體功能鍵,顏色編碼為黃色。在彩色鍵中,其索引為 2 VK_COLORED_KEY_2 KEYCODE_PROG_YELLOW (185)
"ColorF3Blue" [3] 通用媒體功能鍵,顏色編碼為藍色。在彩色鍵中,其索引為 3 VK_COLORED_KEY_3 KEYCODE_PROG_BLUE (186)
"ColorF4Grey" 通用媒體功能鍵,顏色編碼為灰色。在彩色鍵中,其索引為 4 VK_COLORED_KEY_4 KEYCODE_PROG_GREY
"ColorF5Brown" 通用媒體功能鍵,顏色編碼為棕色。在彩色鍵中,其索引為 5 VK_COLORED_KEY_5 KEYCODE_PROG_BROWN
"ClosedCaptionToggle" 開啟和關閉隱藏式字幕。 VK_CC KEYCODE_CAPTIONS (175)
"Dimmer" 透過在兩個亮度級別之間切換在多個亮度級別之間迴圈來調整裝置的亮度。 VK_DIMMER GDK_KEY_BrightnessAdjust (0x1008FF3B)
"DisplaySwap" 在影片源之間迴圈。 VK_DISPLAY_SWAP
"DVR" 將輸入源切換到數字影片錄影機 (DVR)。 KEYCODE_DVR (173)
"Exit" 退出按鈕,用於退出當前應用程式或選單。 VK_EXIT Qt::Key_Exit (0x0102000a)
"FavoriteClear0" 清除儲存在第一個收藏夾列表插槽中的節目或內容。 VK_CLEAR_FAVORITE_0
"FavoriteClear1" 清除儲存在第二個收藏夾列表插槽中的節目或內容。 VK_CLEAR_FAVORITE_1
"FavoriteClear2" 清除儲存在第三個收藏夾列表插槽中的節目或內容。 VK_CLEAR_FAVORITE_2
"FavoriteClear3" 清除儲存在第四個收藏夾列表插槽中的節目或內容。 VK_CLEAR_FAVORITE_3
"FavoriteRecall0" 選擇(呼叫)儲存在第一個收藏夾列表插槽中的節目或內容。 VK_RECALL_FAVORITE_0
"FavoriteRecall1" 選擇(呼叫)儲存在第二個收藏夾列表插槽中的節目或內容。 VK_RECALL_FAVORITE_1
"FavoriteRecall2" 選擇(呼叫)儲存在第三個收藏夾列表插槽中的節目或內容。 VK_RECALL_FAVORITE_2
"FavoriteRecall3" 選擇(呼叫)儲存在第四個收藏夾列表插槽中的節目或內容。 VK_RECALL_FAVORITE_3
"FavoriteStore0" 將當前節目或內容儲存到第一個收藏夾列表插槽中。 VK_STORE_FAVORITE_0
"FavoriteStore1" 將當前節目或內容儲存到第二個收藏夾列表插槽中。 VK_STORE_FAVORITE_1
"FavoriteStore2" 將當前節目或內容儲存到第三個收藏夾列表插槽中。 VK_STORE_FAVORITE_2
"FavoriteStore3" 將當前節目或內容儲存到第四個收藏夾列表插槽中。 VK_STORE_FAVORITE_3
"Guide" 切換節目或內容指南的顯示。 VK_GUIDE Qt::Key_Guide (0x0100011A) KEYCODE_GUIDE (172)
"GuideNextDay" 如果當前正在顯示指南,此按鈕會告訴指南顯示第二天的內容。 VK_NEXT_DAY
"GuidePreviousDay" 如果當前正在顯示指南,此按鈕會告訴指南顯示前一天的內容。 VK_PREV_DAY
"Info" 切換顯示有關當前所選內容、節目或媒體的資訊。 VK_INFO Qt::Key_Info (0x0100011B) KEYCODE_INFO (165)
"InstantReplay" 告訴裝置執行即時回放(通常是某種形式的跳回一小段時間然後再次播放,可能但通常不是慢動作)。 VK_INSTANT_REPLAY
"Link" 如果可用且可能,開啟連結到當前節目的內容。 VK_LINK
"ListProgram" 列出當前節目。 VK_LIST
"LiveContent" 切換顯示當前可用的直播內容或節目列表。 VK_LIVE
“Lock” 鎖定或解鎖當前選定的內容或節目。 VK_LOCK
“MediaApps” 顯示媒體應用程式列表,例如照片檢視器、音訊和影片播放器以及遊戲。[1] VK_APPS
“MediaAudioTrack” 音軌鍵。 GDK_KEY_AudioCycleTrack (0x1008FF9B)
Qt::Key_AudioCycleTrack (0x01000106)
KEYCODE_MEDIA_AUDIO_TRACK (222)
"MediaLast" 跳回上次觀看的內容、節目或其他媒體。 VK_LAST Qt::Key_MediaLast (0x0100FFFF) KEYCODE_LAST_CHANNEL (229)
“MediaSkipBackward” 向後跳到上一個內容或節目。 KEYCODE_MEDIA_SKIP_BACKWARD
“MediaSkipForward” 向前跳到下一個內容或節目。 VK_SKIP KEYCODE_MEDIA_SKIP_FORWARD
“MediaStepBackward” 向後步進到上一個內容或節目。 KEYCODE_MEDIA_STEP_BACKWARD
“MediaStepForward” 向前步進到下一個內容或節目。 KEYCODE_MEDIA_SKIP_FORWARD
"MediaTopMenu" 頂部選單按鈕。開啟媒體的主選單(例如 DVD 或藍光光碟的選單)。 Qt::Key_TopMenu (0x0100010A) KEYCODE_MEDIA_TOP_MENU
“NavigateIn” 導航進入子選單或選項。 KEYCODE_NAVIGATE_IN
“NavigateNext” 導航到下一個專案。 KEYCODE_NAVIGATE_NEXT
“NavigateOut” 導航退出當前螢幕或選單。 KEYCODE_NAVIGATE_OUT
“NavigatePrevious” 導航到上一個專案。 KEYCODE_NAVIGATE_PREVIOUS
"NextFavoriteChannel" 迴圈切換到收藏列表中的下一個頻道。 VK_NEXT_FAVORITE_CHANNEL
"NextUserProfile" 如果支援此功能且存在多個使用者配置檔案,則迴圈切換到下一個已儲存的使用者配置檔案。 VK_USER
"OnDemand" 開啟用於選擇要觀看的點播內容或節目的使用者介面。 VK_ON_DEMAND
“Pairing” 開始將遙控器與待控制裝置配對的過程。 KEYCODE_PAIRING (225)
"PinPDown" 一個用於向下移動畫中畫檢視的按鈕。 VK_PINP_DOWN
"PinPMove" 一個用於控制移動畫中畫檢視的按鈕。 VK_PINP_MOVE
"PinPToggle" 切換畫中畫檢視的顯示與關閉。 VK_PINP_TOGGLE
"PinPUp" 一個用於向上移動畫中畫檢視的按鈕。 VK_PINP_UP
"PlaySpeedDown" 降低媒體播放速率。 VK_PLAY_SPEED_DOWN
"PlaySpeedReset" 將媒體播放速率恢復正常。 VK_PLAY_SPEED_RESET
"PlaySpeedUp" 提高媒體播放速率。 VK_PLAY_SPEED_UP
"RandomToggle" 切換隨機媒體(也稱為“隨機播放模式”)的開啟與關閉。 VK_RANDOM_TOGGLE GDK_KEY_AudioRandomPlay (0x1008FF99)
"RcLowBattery" 當遙控器電池電量低時傳送的程式碼。這實際上根本不對應任何物理按鍵。 VK_RC_LOW_BATTERY
"RecordSpeedNext" 在可用的媒體錄製速度之間迴圈切換。 VK_RECORD_SPEED_NEXT
"RfBypass" 切換射頻(RF)輸入旁路模式的開啟與關閉。RF 旁路模式將 RF 輸入直接傳遞到 RF 輸出,不進行任何處理或過濾。 VK_RF_BYPASS
"ScanChannelsToggle" 切換頻道掃描模式的開啟與關閉。此模式會自動切換頻道,直到使用者停止掃描。 VK_SCAN_CHANNELS_TOGGLE
"ScreenModeNext" 在可用的螢幕顯示模式之間迴圈切換。 VK_SCREEN_MODE_NEXT
“Settings” 切換裝置設定螢幕的顯示與關閉。 VK_SETTINGS Qt::Key_Settings (0x0100011C) KEYCODE_SETTINGS
"SplitScreenToggle" 切換分屏顯示模式的開啟與關閉。 VK_SPLIT_SCREEN_TOGGLE GDK_KEY_SplitScreen (0x1008FF7D)
Qt::Key_SplitScreen (0x010000ED)
"STBInput" [3] 在外部機頂盒(STB)的輸入模式之間迴圈切換。 KEYCODE_STB_INPUT (180)
"STBPower" [3] 切換外部機頂盒的電源開關。 KEYCODE_STB_POWER (179)
"Subtitle" 如果字幕可用,則切換字幕的顯示與關閉。 VK_SUBTITLE GDK_KEY_Subtitle (0x1008FF9A) KEYCODE_CAPTIONS (175)
"Teletext" 如果可用,切換圖文電視的顯示。 VK_TELETEXT KEYCODE_TV_TELETEXT (233)
"VideoModeNext" [3] 在可用的影片模式之間迴圈切換。 VK_VIDEO_MODE_NEXT GDK_KEY_Next_VMode (0x1008FE22)
"Wink" 使裝置以某種方式標識自己,例如閃爍燈光、短暫改變指示燈亮度或發出提示音。 VK_WINK
"ZoomToggle" [2] 在全屏和縮放內容顯示之間切換,或以其他方式更改放大級別。 VK_ZOOM (0xFB) Qt::Key_Zoom (0x01020006) KEYCODE_TV_ZOOM_MODE (255)

[1] 不要將媒體控制器 VK_APPS 鍵與 Windows VK_APPS 鍵混淆,後者也被稱為 VK_CONTEXT_MENU。該鍵被編碼為 "ContextMenu"

[2] Firefox 36 及更早版本將縮放切換按鈕標識為 "Zoom"。Firefox 37 將其更正為 "ZoomToggle"

[3] 在 Firefox 37 之前,這些鍵為 "Unidentified"

語音識別鍵

這些特殊的多媒體鍵用於控制語音識別功能。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"SpeechCorrectionList" [1] 為被錯誤識別的單詞顯示可能的更正列表。 APPCOMMAND_CORRECTION_LIST
"SpeechInputToggle" [2] 在聽寫模式和命令/控制模式之間切換。這讓語音引擎知道是將口語詞彙解釋為輸入文字還是命令。 APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE

[1] Windows 上的 APPCOMMAND_CORRECTION_LIST 命令在 Firefox 中會生成 "Unidentified"

[2] Windows 上的 APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE 命令在 Firefox 中會生成 "Unidentified"

文件鍵

這些鍵用於控制文件。在規範中,它們被包含在其他鍵組中(如媒體鍵),但將它們視為獨立的類別更為合理。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
“Close” [1] 關閉當前文件或訊息。不得退出應用程式。 APPCOMMAND_CLOSE GDK_KEY_Close (0x1008FF56)
Qt::Key_Close (0x010000CE)
KEYCODE_MEDIA_CLOSE (128)
“New” [1] 建立新文件或訊息。 APPCOMMAND_NEW GDK_KEY_New (0x1008FF68)
Qt::Key_New (0x01000120)
“Open” [1] 開啟現有文件或訊息。 APPCOMMAND_OPEN GDK_KEY_Open (0x1008FF6B)
Qt::Key_Open (0x01000121)
"Print" 列印當前文件或訊息。 APPCOMMAND_PRINT GDK_KEY_Print (0xFF61)
Qt::Print (0x01000009)
“Save” [1] 儲存當前文件或訊息。 APPCOMMAND_SAVE GDK_KEY_Save (0x1008FF77)
Qt::Key_Save (0x010000EA)
"SpellCheck" [1] 開始對當前文件進行拼寫檢查。 APPCOMMAND_SPELL_CHECK GDK_KEY_Spell (0x1008FF7C)
Qt::Key_Spell (0x010000EC)
"MailForward" [1] 開啟用於轉發訊息的使用者介面。 APPCOMMAND_FORWARD_MAIL GDK_KEY_MailForward (0x1008FF90)
Qt::Key_MailForward (0x010000FB)
"MailReply" [1] 開啟用於回覆訊息的使用者介面。 APPCOMMAND_REPLY_TO_MAIL GDK_KEY_Reply (0x1008FF72)
Qt::Key_Reply (0x010000E5)
"MailSend" [1] 傳送當前訊息。 APPCOMMAND_SEND_MAIL GDK_KEY_Send (0x1008FF7B)
Qt::Key_Send (0x010000EB)

[1] 在 Firefox 37 之前,此鍵生成的鍵值為 "Unidentified"

應用程式選擇器鍵

某些鍵盤提供用於啟動或切換到某些常用應用程式的專用鍵。這些鍵的鍵值在此列出。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"LaunchCalculator" [5] 計算器鍵,通常標有圖示。這通常用作通用應用程式啟動鍵(APPCOMMAND_LAUNCH_APP2)。 APPCOMMAND_LAUNCH_APP2 GDK_KEY_Calculator (0x1008FF1D)
Qt::Key_Calculator (0x010000CB)
KEYCODE_CALCULATOR (210)
"LaunchCalendar" [5] 日曆鍵。通常標有圖示。 GDK_KEY_Calendar (0x1008FF20)
Qt::Key_Calendar (0x010000E4)
KEYCODE_CALENDAR (208)
"LaunchContacts" 聯絡人鍵。 KEYCODE_CONTACTS (207)
"LaunchMail" 郵件鍵。通常標有圖示。 VK_LAUNCH_MAIL (0xB4)
APPCOMMAND_LAUNCH_MAIL
GDK_KEY_Mail (0x1008FF19)
Qt::Key_LaunchMail (0x010000A0)
KEYCODE_ENVELOPE (65)
"LaunchMediaPlayer" [1] 媒體播放器鍵。 VK_LAUNCH_MEDIA_SELECT (0xB5)
APPCOMMAND_LAUNCH_MEDIA_SELECT
GDK_KEY_CD (0x1008FF53)
GDK_KEY_Video (0x1008FF87)
GDK_KEY_AudioMedia (0x1008FF32)
Qt::Key_LaunchMedia (0x010000A1)
"LaunchMusicPlayer" [5] 音樂播放器鍵。通常標有圖示。 GDK_KEY_Music (0x1008FF92)
Qt::Key_Music (0x010000FD)
KEYCODE_MUSIC (209)
"LaunchMyComputer" [5] Windows 鍵盤上的我的電腦鍵。這通常用作通用應用程式啟動鍵(APPCOMMAND_LAUNCH_APP1)。 APPCOMMAND_LAUNCH_APP1 GDK_KEY_MyComputer (0x1008FF33)
GDK_KEY_Explorer (0x1008FF5D)
"LaunchPhone" 電話鍵。開啟電話撥號器應用程式(如果存在)。 GDK_KEY_Phone (0x1008FF6E)
Qt::Key_Phone (0x010000E3)
"LaunchScreenSaver" [5] 螢幕保護程式鍵。 GDK_KEY_ScreenSaver (0x1008FF2D)
Qt::Key_ScreenSaver (0x010000BA)
"LaunchSpreadsheet" [4] 電子表格鍵。此鍵可能標有圖示。 GDK_KEY_Excel (0x1008FF5C)
Qt::Key_Excel (0x010000D4)
"LaunchWebBrowser" [4] 網路瀏覽器鍵。此鍵通常標有圖示。 GDK_KEY_WWW (0x1008FF2E)
Qt::Key_WWW (0x010000BB)
KEYCODE_EXPLORER (64)
"LaunchWebCam" [5] 網路攝像頭鍵。開啟網路攝像頭應用程式。 GDK_KEY_WebCam (0x1008FF8F)
Qt::Key_WebCam (0x010000FA)
"LaunchWordProcessor" [5] 文字處理器鍵。這可能是一個特定文字處理器應用程式的圖示,或一個通用的文件圖示。 GDK_KEY_Word (0x1008FF89)
Qt::Key_Word (0x010000F4)
"LaunchApplication1" [2] 第一個通用應用程式啟動按鈕。 VK_LAUNCH_APP1 (0xB6)
APPCOMMAND_LAUNCH_APP1
GDK_KEY_Launch0 (0x1008FF40)
Qt::Key_Launch0 (0x010000A2)
"LaunchApplication2" [3] 第二個通用應用程式啟動按鈕。 VK_LAUNCH_APP2 (0xB7)
APPCOMMAND_LAUNCH_APP2
GDK_KEY_Launch1 (0x1008FF41)
Qt::Key_Launch1 (0x010000A3)
"LaunchApplication3" 第三個通用應用程式啟動按鈕。 GDK_KEY_Launch2 (0x1008FF42)
Qt::Key_Launch2 (0x010000A4)
"LaunchApplication4" 第四個通用應用程式啟動按鈕。 GDK_KEY_Launch3 (0x1008FF43)
Qt::Key_Launch3 (0x010000A5)
"LaunchApplication5" 第五個通用應用程式啟動按鈕。 GDK_KEY_Launch4 (0x1008FF44)
Qt::Key_Launch4 (0x010000A6)
"LaunchApplication6" 第六個通用應用程式啟動按鈕。 GDK_KEY_Launch5 (0x1008FF45)
Qt::Key_Launch5 (0x010000A7)
"LaunchApplication7" 第七個通用應用程式啟動按鈕。 GDK_KEY_Launch6 (0x1008FF46)
Qt::Key_Launch6 (0x010000A8)
"LaunchApplication8" 第八個通用應用程式啟動按鈕。 GDK_KEY_Launch7 (0x1008FF47)
Qt::Key_Launch7 (0x010000A9)
"LaunchApplication9" 第九個通用應用程式啟動按鈕。 GDK_KEY_Launch8 (0x1008FF48)
Qt::Key_Launch8 (0x010000AA)
"LaunchApplication10" 第 10 個通用應用程式啟動按鈕。 GDK_KEY_Launch9 (0x1008FF49)
Qt::Key_Launch9 (0x010000AB)
"LaunchApplication11" 第 11 個通用應用程式啟動按鈕。 GDK_KEY_LaunchA (0x1008FF4A)
Qt::Key_LaunchA (0x010000AC)
"LaunchApplication12" 第 12 個通用應用程式啟動按鈕。 GDK_KEY_LaunchB (0x1008FF4B)
Qt::Key_LaunchB (0x010000AD)
"LaunchApplication13" 第 13 個通用應用程式啟動按鈕。 GDK_KEY_LaunchC (0x1008FF4C)
Qt::Key_LaunchC (0x010000AE)
"LaunchApplication14" 第 14 個通用應用程式啟動按鈕。 GDK_KEY_LaunchD (0x1008FF4D)
Qt::Key_LaunchD (0x010000AF)
"LaunchApplication15" 第 15 個通用應用程式啟動按鈕。 GDK_KEY_LaunchE (0x1008FF4E)
Qt::Key_LaunchE (0x010000B0)
"LaunchApplication16" 第 16 個通用應用程式啟動按鈕。 GDK_KEY_LaunchF (0x1008FF4F)
Qt::Key_LaunchF (0x010000B1)

[1] 舊版 Edge 和 Firefox(36 及更早版本)使用 "SelectMedia" 而不是 "LaunchMediaPlayer"。Firefox 37 到 Firefox 48 使用 "MediaSelect"。Firefox 49 已更新以匹配最新規範,並返回 "LaunchMediaPlayer"

[2] Google Chrome 57 及更早版本返回 "LaunchMyComputer" 而不是 "LaunchApplication1"。更多資訊請參見 Chrome Bug 612743

[3] Google Chrome 57 及更早版本返回 "LaunchCalculator" 而不是 "LaunchApplication2"。更多資訊請參見 Chrome Bug 612743

[4] 在 Firefox 37 之前,Firefox 對網路瀏覽器鍵返回鍵碼 "LaunchApplication1" 而不是 "LaunchWebBrowser"

[5] Firefox 在 Firefox 37 中引入了對此鍵的支援。在此之前,此鍵被報告為 "Unidentified"

瀏覽器控制鍵

一些鍵盤包含用於控制網路瀏覽器的專用鍵。這些鍵如下。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"BrowserBack" 導航到當前 Web 檢視歷史記錄中的上一個內容或頁面。 VK_BROWSER_BACK (0xA6)
APPCOMMAND_BROWSER_BACKWARD
GDK_KEY_Back (0x1008FF26)
Qt::Key_Back (0x01000061)
KEYCODE_BACK (4)
"BrowserFavorites" [1] 開啟使用者的書籤/收藏夾列表。 VK_BROWSER_FAVORITES (0xAB)
APPCOMMAND_BROWSER_FAVORITES
GDK_KEY_Favorites (0x1008FF30)
GDK_KEY_MySites (0x1008FF67)
Qt::Favorites (0x01000091)
KEYCODE_BOOKMARK (174)
"BrowserForward" 導航到當前 Web 檢視歷史記錄中的下一個內容或頁面。 VK_BROWSER_FORWARD (0xA7)
APPCOMMAND_BROWSER_FORWARD
GDK_KEY_Forward (0x1008FF27)
Qt::Key_Forward (0x01000062)
KEYCODE_FORWARD (125)
"BrowserHome" 導航到使用者的首選主頁。 VK_BROWSER_HOME (0xAC)
APPCOMMAND_BROWSER_HOME
GDK_KEY_HomePage (0x1008FF18)
Qt::Key_HomePage (0x01000090)
KEYCODE_HOME (3)
"BrowserRefresh" 重新整理當前頁面或內容。 VK_BROWSER_REFRESH (0xA8)
APPCOMMAND_BROWSER_REFRESH
GDK_KEY_Refresh (0x1008FF29)
GDK_KEY_Reload (0x1008FF73)
"BrowserSearch" 啟用使用者的首選搜尋引擎或其瀏覽器內的搜尋介面。 VK_BROWSER_SEARCH (0xAA)
APPCOMMAND_BROWSER_SEARCH
GDK_KEY_Search (0x1008FF1B)
Qt::Key_Search (0x01000092)
KEYCODE_SEARCH (84)
"BrowserStop" 停止載入當前顯示的 Web 檢視或內容。 VK_BROWSER_STOP (0xA9)
APPCOMMAND_BROWSER_STOP
GDK_KEY_Stop (0x1008FF28)
Qt::Key_Search (0x01000063)

[1] 在 Firefox 37 之前,此鍵的值被報告為 "Unidentified"

數字鍵盤鍵

這些鍵位於鍵盤的數字小鍵盤上。但是,並非所有鍵盤上都有這些鍵。儘管典型的數字小鍵盤有從 09 的數字鍵(編碼為 "0""9"),但一些多媒體鍵盤包含用於更大數字的附加數字鍵。

注意:如果存在 10 鍵,它會生成 key 值為 "0" 的事件。

KeyboardEvent.key 描述 虛擬鍵碼
Windows Mac Linux Android
"Decimal" [1] 已廢棄

小數點鍵(通常是 .,,取決於地區)。

在較新的瀏覽器中,此值為小數點鍵生成的字元(這兩個字元之一)。[1]

VK_DECIMAL (0x6E) kVK_ANSI_KeypadDecimal (0x41) GDK_KEY_KP_Decimal (0xFFAE)
KEYCODE_NUMPAD_DOT (158)
"Key11" 在某些媒體數字小鍵盤上找到的 11 鍵。
"Key12" 在某些媒體數字小鍵盤上找到的 12 鍵。
"Multiply" [1] 已廢棄 數字小鍵盤的乘法鍵,* VK_MULTIPLY (0x6A) kVK_ANSI_KeypadMultiply (0x43) GDK_KEY_KP_Multiply (0xFFAA)
Qt::Key_Multiply (0x0D7)
KEYCODE_NUMPAD_MULTIPLY (155)
"Add" [1] 已廢棄 數字小鍵盤的加法鍵,+ VK_ADD (0x6B) kVK_ANSI_KeypadPlus (0x45) GDK_KEY_KP_Add (0xFFAB) KEYCODE_NUMPAD_ADD (157)
"Clear" 數字小鍵盤的 Clear 鍵。 kVK_ANSI_KeypadClear (0x47) GDK_KEY_Clear (0xFF0B)
Qt::Key_Clear (0x0100000B)
KEYCODE_CLEAR (28)
"Divide" [1] 已廢棄 數字小鍵盤的除法鍵,/ VK_DIVIDE (0x6F) kVK_ANSI_KeypadDivide (0x4B) GDK_KEY_KP_Divide (0xFFAF)
Qt::Key_Slash (0x2F)
KEYCODE_NUMPAD_DIVIDE (154)
"Subtract" [1] 已廢棄 數字小鍵盤的減法鍵,- VK_SUBTRACT (0x6D) kVK_ANSI_KeypadMinus (0x4E) GDK_KEY_KP_Subtract (0xFFAD) KEYCODE_NUMPAD_SUBTRACT (156)
"Separator" [1]

數字小鍵盤的位數分隔符。

(在美國,這是一個逗號,但在其他地方通常是一個句號。)

VK_SEPARATOR (0x6C) kVK_JIS_KeypadComma (0x5F) GDK_KEY_KP_Separator (0xFFAC)
KEYCODE_NUMPAD_COMMA (159)
"0""9" 數字小鍵盤上的實際數字鍵。 VK_NUMPAD0 (0x60) - VK_NUMPAD9 (0x69) kVK_Keypad0 (0x52) - kVK_Keypad9 (0x5C) GDK_KEY_KP_0 (0xFFB0) - GDK_KEY_KP_9 (0xFFB9) KEYCODE_NUMPAD_0 (144) - KEYCODE_NUMPAD_9 (153)

[1] 雖然舊版瀏覽器使用諸如 "Add""Decimal""Multiply" 等詞語,但現代瀏覽器使用實際字元("+"".""*" 等)來標識這些鍵。