Ключевые значения для событий клавиатуры
В таблицах ниже перечислены стандартные значения свойства KeyboardEvent.key, с пояснением, для чего обычно используется каждый ключ. Соответствующие кодам виртуальных клавиш для распространённых платформ приведены, где это возможно.
Специальные значения
Значения key , имеющие специальное значение помимо идентификации конкретной клавиши или символа.
KeyboardEvent.key Значение | Описание | Код виртуальной клавиши | |||
|---|---|---|---|---|---|
| Windows | Mac | Linux | Android | ||
"Unidentified" | Пользовательскому агенту не удалось сопоставить код виртуальной клавиши события со значением конкретной клавиши. Это может произойти из-за аппаратных или программных ограничений, или из-за ограничений платформы, на которой работает пользовательский агент. | переменное | переменное | переменное | переменное |
Клавиши модификаторов
Модификаторы — это специальные клавиши, которые используются для генерации специальных символов или вызова специальных действий при совместном использовании с другими клавишами. Примеры включают клавиши Shift и Control, и клавиши блокировки, такие как Caps Lock и NumLock.
KeyboardEvent.key Значение | Описание | Код виртуальной клавиши | |||
|---|---|---|---|---|---|
| Windows | Mac | Linux | Android | ||
"Alt" [4] | Клавиша Alt (Альтернатива). | 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] | Клавиша AltGr или AltGraph (альтернативная графика). Включает модификатор сдвига ISO уровня 3 (где 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 (0x01001103Qt::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" | Клавиша Control, Ctrl или Ctl. Позволяет вводить управляющие символы. | 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 (модификатор функции). Используется для генерации символов функциональных клавиш (F1–F15, например) на клавиатурах без выделенной области функциональных клавиш. Часто обрабатывается аппаратно, поэтому события для этой клавиши не генерируются. |
kVK_Function (0x3F) |
KEYCODE_FUNCTION (119) | ||
"FnLock" | Клавиша FnLock или F-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, или клавиша Command или ⌘ на клавиатурах Mac. |
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 (блокировка цифр). Переключает числовую клавиатуру между вводом чисел и другим режимом (часто стрелками). |
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 по ошибке Firefox 1232918. До тех пор эти клавиши возвращаются как "OS" Firefox: VK_LWIN (0x5B) и VK_RWIN (0x5C) в Windows и GDK_KEY_Super_L (0xFFEB), GDK_KEY_Super_R (0xFFEC), GDK_KEY_Hyper_L (0xFFED) и GDK_KEY_Hyper_R (0xFFEE) в Linux.
[2] Firefox добавил поддержку клавиши Symbol только в Firefox 37.
[3] Firefox генерирует значение клавиши "OS" для клавиш Super и Hyper вместо "Super" и "Hyper".
[4] Chrome 67 и Firefox 63 теперь правильно интерпретируют правую клавишу Alt для раскладок клавиатуры, которые сопоставляют эту клавишу с AltGr. Подробнее см. ошибку Firefox Firefox bug 900750 и Chrome 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) | |
KEYCODE_SPACE (62) |
[1] Более старые браузеры могут возвращать "Spacebar" вместо " " для клавиши Space Bar. 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" | Клавиша Конец. Перемещает курсор в конец содержимого. |
VK_END (0x23) |
kVK_End (0x77) | GDK_KEY_End (0xFF57)GDK_KEY_KP_End (0xFF9C)Qt::Key_End (0x01000011) |
KEYCODE_MOVE_END (123) |
"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" | Клавиша Вниз страницы (или Следующая страница). Прокручивает вниз или отображает следующую страницу содержимого. |
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" | Клавиша Вверх страницы (или Предыдущая страница). Прокручивает вверх или отображает предыдущую страницу содержимого. |
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. На макбуках эта клавиша имеет надпись Delete. |
VK_BACK (0x08) |
kVK_Delete (0x33) | GDK_KEY_BackSpace (0xFF08)Qt::Key_Backspace (0x01000003) |
KEYCODE_DEL (67) |
"Clear" | Клавиша Очистить. Удаляет выбранный ввод. | VK_CLEAR (0x0C)VK_OEM_CLEAR (0xFE) |
kVK_ANSI_KeypadClear (0x47) | GDK_KEY_Clear (0xFF0B)Qt::Key_Clear (0x0100000B) |
KEYCODE_CLEAR (28) |
"Copy" | Клавиша Копировать (на некоторых расширенных клавиатурах). | APPCOMMAND_COPY | GDK_KEY_Copy (0x1008FF57)Qt::Key_Copy (0x010000CF) | ||
"CrSel" [3] | Клавиша выбора курсора, CrSel. |
VK_CRSEL (0xF7) |
GDK_KEY_3270_CursorSelect (0xFD1C) | ||
"Cut" | Клавиша Вырезать (на некоторых расширенных клавиатурах). | APPCOMMAND_CUT | GDK_KEY_Cut (0x1008FF58)Qt::Key_Cut (0x010000D0) | ||
"Delete" [2] | Клавиша Удалить, 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 (расширить выбор). |
VK_EXSEL (0xF8) |
GDK_KEY_3270_ExSelect (0xFD1B) | ||
"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, Mac генерирует значение "Delete" при одновременном нажатии Fn и Удалить (которое на других платформах - Backspace).
[2] Firefox 36 и ранее использует "Del" вместо "Delete" для клавиши Del.
[3] Firefox 36 и ранее генерирует значение "Crsel" вместо "CrSel" при нажатии клавиши CrSel.
[4] Firefox 36 и ранее генерирует значение "Exsel" вместо "ExSel" при нажатии клавиши ExSel.
Клавиши интерфейса
KeyboardEvent.key Значение | Описание | Виртуальный код клавиши | |||
|---|---|---|---|---|---|
| Windows | Mac | Linux | Android | ||
"Accept" | Клавиша или кнопка Принять, Подтвердить или ОК. Принимает выбранный в данный момент параметр или последовательность ввода для перевода. |
VK_ACCEPT (0x1E) |
KEYCODE_DPAD_CENTER (23) | ||
"Again" | Клавиша Повторить. Повторяет предыдущее действие. |
GDK_KEY_Redo (0xFF66) | |||
"Attn" [4] | Клавиша Вним. (Внимание). |
VK_OEM_ATTN (0xF0) |
GDK_KEY_3270_Attn (0xFD0E) | ||
"Cancel" [1] | Клавиша Отмена. |
GDK_KEY_Cancel (0xFF69) | |||
"ContextMenu" [3] | Отображает контекстное меню. Обычно расположена между клавишей Windows (или OS) и клавишей Ctrl справа на клавиатуре. |
VK_APPS (0x5D) |
kVK_PC_ContextMenu (0x6E) | GDK_KEY_Menu (0xFF67)Qt::Key_Menu (0x01000055) |
KEYCODE_MENU (82) |
"Escape" [2] | Клавиша Esc (Escape). Обычно используется как кнопка выхода, отмены или «прерывания операции». Исторически символ Escape использовался для обозначения начала специальной управляющей последовательности символов, называемой «последовательностью escape». |
VK_ESCAPE (0x1B) |
kVK_Escape (0x35) | GDK_KEY_Escape (0xFF1B)Qt::Key_Escape (0x01000000) |
KEYCODE_ESCAPE (111) |
"Execute" | Клавиша Выполнить. |
VK_EXECUTE (0x2B) |
Qt::Key_Execute (0x01020003) | ||
"Find" | Клавиша Найти. Открывает интерфейс (обычно диалоговое окно) для выполнения операции поиска. | APPCOMMAND_FIND |
GDK_KEY_Find (0xFF68) | ||
"Finish" [5] | Клавиша Закончить. |
VK_OEM_FINISH (0xF1) | |||
"Help" | Клавиша Справка. Открывает или переключает отображение справочной информации. |
VK_HELP (0x2F)APPCOMMAND_HELP
|
kVK_Help (0x72) | GDK_KEY_Help (0xFF6A)Qt::Key_Help (0x01000058) |
KEYCODE_HELP (259) |
"Pause" | Клавиша Пауза. Приостанавливает текущее приложение или состояние, если применимо. Примечание: Не следует путать с значением клавиши |
VK_PAUSE (0x13) | GDK_KEY_Pause (0xFF13)GDK_KEY_Break (0xFF6B)Qt::Key_Pause (0x01000008) |
KEYCODE_BREAK (121) | |
"Play" | Клавиша Воспроизвести. Возобновляет ранее приостановленное приложение, если применимо. Примечание: Не следует путать с значением клавиши |
VK_PLAY (0xFA) | GDK_KEY_3270_Play (0xFD16)Qt::Key_Play (0x01020005) | ||
"Props" | Клавиша Свойства. | ||||
"Select" | Клавиша Выбрать. |
VK_SELECT (0x29) |
GDK_KEY_Select (0xFF60) |
KEYCODE_BUTTON_SELECT (109) | |
"ZoomIn" [6] | Клавиша Увеличить масштаб. | GDK_KEY_ZoomIn (0x1008FF8B)Qt::Key_ZoomIn (0x010000F6) |
KEYCODE_ZOOM_IN (168) | ||
"ZoomOut" [6] | Клавиша Уменьшить масштаб. | GDK_KEY_ZoomOut (0x1008FF8C)Qt::Key_ZoomOut (0x010000F7) |
KEYCODE_ZOOM_OUT (169) | ||
[1] В Google Chrome 52 клавиша Отмена неверно возвращает код клавиши "Pause". Это исправлено в Chrome 53. (См. ошибку Chrome 612749 для получения подробностей.)
[2] В Firefox 36 и ранее клавиша Esc возвращает "Esc" вместо "Escape".
[3] Firefox 36 и ранее сообщает "Apps" вместо "ContextMenu" для клавиши контекстного меню.
[4] Клавиша Вним. генерирует код клавиши "Unidentified" в Firefox и Google Chrome, если не используется японская раскладка клавиатуры, в противном случае генерируется "KanaMode".
[5] Клавиша Закончить генерирует код клавиши "Unidentified" в Firefox, если не используется японская раскладка клавиатуры, в противном случае генерируется "Katakana".
[6] Firefox не поддерживал клавиши "ZoomIn" и "ZoomOut" до Firefox 37.
Клавиши устройств
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" | Клавиша Выбросить. Выбрасывает съемные носители (или открывает и закрывает лоток оптического накопителя). | GDK_KEY_Eject (0x1008FF2C)Qt::Key_Eject (0x010000B9) |
KEYCODE_MEDIA_EJECT (129) | ||
"LogOff" [2] | Клавиша Выход. | GDK_KEY_LogOff (0x1008FF61)Qt::Key_LogOff (0x010000D9) | |||
"Power" | Кнопка или клавиша Питание для включения и выключения питания. Примечание: Не все системы передают эту клавишу в пользовательский агент. |
KEYCODE_POWER (26) | |||
"PowerOff" | Клавиша Выключение или Завершение работы. Выключает систему. | GDK_KEY_PowerDown (0x1008FF21)GDK_KEY_PowerOff (0x1008FF2A)Qt::Key_PowerDown (0x0100010B)Qt::Key_PowerOff (0x010000B7) | |||
"PrintScreen" | Клавиша PrintScreen или PrtScr. Иногда 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] | Клавиша Гибернация. Сохраняет состояние компьютера на диск, а затем выключает его; компьютер можно вернуть в предыдущее состояние, восстановив сохраненную информацию о состоянии. | GDK_KEY_Hibernate (0x1008FFA8)Qt::Key_Hibernate (0x01000108) | |||
"Standby" [1] | Клавиша Ждущий режим. (Также известен как Приостановление или Сон). Выключает дисплей и переводит компьютер в режим низкого энергопотребления, не полностью выключая его. |
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] | Клавиша Разбудить. Используется для вывода компьютера из режимов гибернации или ожидания. | GDK_KEY_WakeUp (0x1008FF2B)Qt::Key_WakeUp (0x010000B8) |
KEYCODE_WAKEUP (224) | ||
[1] Клавиша Ждущий режим не поддерживается Firefox 36 и ранее, поэтому она отображается как "Unidentified".
[2] До Firefox 37 эта клавиша генерировала значение "Unidentified".
Клавиши IME и составления
Клавиши, используемые при работе с Input Method Editor (IME) для ввода текста, который нельзя ввести простыми нажатиями клавиш, например, текста на языках, в которых больше графем, чем клавиш ввода символов на клавиатуре. Общие примеры включают китайский, японский, корейский и хинди.
Некоторые клавиши являются общими для нескольких языков, а другие существуют только на клавиатурах, предназначенных для конкретных языков. Кроме того, не все клавиатуры имеют все эти клавиши.
Общие клавиши IME
KeyboardEvent.key Значение | Описание | Виртуальный код клавиши | |||
|---|---|---|---|---|---|
| Windows | Mac | Linux | Android | ||
"AllCandidates" | Ключ Все кандидаты, который запускает многокандидатский режим, в котором отображаются несколько кандидатов для текущего ввода. | GDK_KEY_MultipleCandidate (0xFF3DQt::Key_MultipleCandidate (0x0100113D) | |||
"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" | Ключ Ввод кода, который включает режим ввода кода, позволяющий пользователю вводить символы, набирая их код (число Unicode символа, как правило). | GDK_KEY_Codeinput (0xFF37)Qt::Key_Codeinput (0x01001137) | |||
"Compose" | Ключ Составной. | GDK_KEY_Multi_key (0xFF20) [1]Qt::Key_Multi_key (0x01001120) | |||
"Convert" [4] | Ключ Преобразовать, который инструктирует IME преобразовать текущую последовательность ввода в результирующий символ. |
VK_CONVERT (0x1C) | GDK_KEY_Henkan (0xFF23)Qt::Key_Henkan (0x01001123) |
KEYCODE_HENKAN (214) | |
"Dead" | Мёртвая "комбинирующая" клавиша; то есть, клавиша, используемая в паре с другими клавишами для создания символов с диакритическими знаками и других модифицированных символов. Если нажата сама по себе, она не генерирует символ. Если вы хотите определить, какая именно мёртвая клавиша была нажата (в тех случаях, когда их более одной), вы можете это сделать, изучив связанное с | См. Код мёртвых клавиш для Linux ниже | |||
"FinalMode" | Ключ Конечный (Режим завершения) используется на некоторых азиатских клавиатурах для входа в режим завершения при использовании 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] | Ключ НеПреобразовывать («Не преобразовывать»). Это принимает текущую последовательность метода ввода без запуска преобразования при использовании 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] | Ключ Обработать. Инструктирует IME обработать преобразование. |
VK_PROCESSKEY (0xE5) | |||
"SingleCandidate" [4] | Ключ единственного кандидата. Включает режим единственного кандидата (в отличие от многокандидатского режима); в этом режиме одновременно отображается только один кандидат. | GDK_KEY_SingleCandidate (0xFF3C)Qt::Key_SingleCandidate (0x0100113C) | |||
[1] В X Window System клавиша Compose называется клавишей Много.
[2] Ключ НеПреобразовывать отображается как "Nonconvert" вместо правильного "NonConvert" в версиях Firefox 36 и ранее.
[3] Ключ Обработать в настоящее время возвращает "Unidentified" в Firefox. Google Chrome возвращает значение клавиши так, как если бы IME не использовался.
[4] До Firefox 37 эти клавиши были "Unidentified".
[5] Firefox генерирует значение клавиши "AltGraph" вместо "ModeChange".
Только для корейских клавиатур
Эти клавиши доступны только на корейских клавиатурах. Существуют и другие клавиши, определённые различными платформами для корейских клавиатур, но эти являются наиболее распространёнными и теми, которые определены спецификацией UI Events.
KeyboardEvent.key Значение | Описание | Виртуальный код клавиши | |||
|---|---|---|---|---|---|
| Windows | Mac | Linux | Android | ||
"HangulMode" | Ключ режима Хангуль (корейский набор символов), который переключает режимы ввода Хангуль и Английский. |
VK_HANGUL (0x15) [1] | GDK_KEY_Hangul (0xFF31)Qt::Key_Hangul (0x01001131) | ||
"HanjaMode" | Выбирает режим Ханджа, для преобразования символов Хангуль в более специфичные символы Ханьджа. |
VK_HANJA (0x19) [1] | GDK_KEY_Hangul_Hanja (0xFF34)Qt::Key_Hangul_Hanja (0x01001134) | ||
"JunjaMode" | Выбирает режим Джунджа, в котором корейский язык представлен с помощью однобайтовых латинских символов. |
VK_JUNJA (0x17) | GDK_KEY_Hangul_Jeonja (0xFF38)Qt::Key_Hangul_Jeonja (0x01001138) | ||
[1] VK_HANGUL и VK_KANA имеют одинаковое числовое значение клавиши в Windows, как и VK_HANJA и VK_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) |
| ||
[1] До Firefox 37 клавиша Eisu была ошибочно сопоставлена с "RomanCharacters".
[2] VK_HANGUL и VK_KANA имеют одинаковое числовое значение ключа в Windows, так же как и VK_HANJA и VK_KANJI.
[3] До Firefox 37 клавиша Hankaku (полуширина) генерировала значение ключа "HalfWidth" в Firefox.
[4] Firefox 36 и более ранние версии определяют эту клавишу как "FullWidth" на японских раскладках клавиатуры и как "Unidentified" на всех остальных раскладках клавиатуры. Firefox 37 и более поздние версии, а также все версии Google Chrome, правильно возвращают "Zenkaku".
[5] Firefox 36 и более ранние версии определяют клавишу Romaji как "RomanCharacters" на японских клавиатурах и как "Unidentified" для других клавиатур; это исправлено для возвращения "Romaji" в Firefox 37 и более поздних версиях.
[6] Эта клавиша отображается как "Unidentified" до Firefox 37.
Коды неактивных клавиш для Linux
Linux генерирует символы с диакритическими знаками с помощью специальных неактивных клавиш. Неактивные клавиши — это клавиши, которые нажимаются в сочетании с символами для генерации диакритических форм этих символов. Вы можете определить конкретную неактивную клавишу (если их несколько) путем проверки связанного события KeyboardEvent compositionupdate события с свойством data.
Вы можете найти таблицу неактивных клавиш и символов, с которыми они могут быть использованы для создания символов с диакритическими знаками или других специальных символов в Linux с помощью GTK.
Значение 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) | ˇ | Также называется крючок; используется в чешском языке, среди других языков. |
GDK_KEY_dead_cedilla (0xFE5B)Qt::Key_Dead_Cedilla (0x0100125B) | ¸ | |
GDK_KEY_dead_ogonek (0xFE5C)Qt::Key_Dead_Ogonek (0x0100125C) | ˛ | Также называется носин; используется в польском и древнеирландском языках. |
GDK_KEY_dead_iota (0xFE5D)Qt::Key_Dead_Iota (0x0100125D) | ͅ | Подстрочный йота. |
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) |
Функциональные клавиши
Хотя различные платформы поддерживают разное количество функциональных клавиш общего назначения, таких как F1–F12 (или F1–F10, или F1–F15 и т. д.), первые несколько определены следующим образом.
Если доступно больше функциональных клавиш, их названия продолжают эту последовательность, увеличивая числовую часть названия каждой клавиши, так что, например, "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 (181) | |||
"Call" | Клавиша Вызов. Набирает введённый номер. |
Qt::Key_Call (0x01100004) |
KEYCODE_CALL (5) | ||
"Camera" | Клавиша Фотокамера. Активирует камеру. |
Qt::Key_Camera (0x01100020) |
KEYCODE_CAMERA (27) | ||
"CameraFocus" | Клавиша Фокус. Фокусирует камеру. |
Qt::Key_CameraFocus (0x01100021) |
KEYCODE_FOCUS (80) | ||
"EndCall" | Кнопка Завершить вызов или Повесить трубку. |
Qt::Key_Hangup (0x01100005) |
KEYCODE_ENDCALL (6) | ||
"GoBack" | Кнопка Назад. |
KEYCODE_BACK (4) | |||
"GoHome" [1] | Кнопка Домой. Возвращает пользователя на главный экран телефона (обычно запуск приложений). |
KEYCODE_HOME (3) | |||
"HeadsetHook" | Клавиша Захват гарнитуры. Обычно это фактически кнопка на гарнитуре, используемая для завершения вызовов и воспроизведения/паузы медиа. |
Qt::Key_ToggleCallHangup (0x01100007) |
KEYCODE_HEADSETHOOK (79) | ||
"LastNumberRedial" | Кнопка Повторный набор. Повторно набирает последний набранный номер. |
Qt::Key_LastNumberRedial (0x01100009) | |||
"Notification" | Клавиша Уведомления. |
KEYCODE_NOTIFICATION (83) | |||
"MannerMode" | Кнопка, которая циклически переключается между режимами уведомлений: без звука, вибрация, звонок и так далее. |
KEYCODE_MANNER_MODE (205) | |||
"VoiceDial" | Клавиша Голосовой набор. Инициализирует голосовую навигацию. |
Qt::Key_VoiceDial (0x01100008) |
KEYCODE_VOICE_ASSIST (231) | ||
[1] До Firefox 37 кнопка «Домой» генерировала код клавиши "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) (0x01000102) |
KEYCODE_MEDIA_FAST_FORWARD (90) | |
"MediaPause" | Приостанавливает воспроизведение текущего медиа. Примечание: Некоторые старые приложения используют | 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] Legacy 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] Legacy 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" | Переключает на вход "Компонент 1". |
KEYCODE_TV_INPUT_COMPONENT_1 (249) | |||
"TVInputComponent2" | Переключает на вход "Компонент 2". |
KEYCODE_TV_INPUT_COMPONENT_2 (250) | |||
"TVInputComposite1" | Переключает на вход "Композит 1". |
KEYCODE_TV_INPUT_COMPOSITE_1 (247) | |||
"TVInputComposite2" | Переключает на вход "Композит 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 добавил надлежащую поддержку клавиши "TV" в Firefox 37; до этого эта клавиша генерировала код клавиши "Live".
[2] Эти клавиши были "Unidentified" до Firefox 37.
Клавиши управления медиа
Поскольку современные пульты дистанционного управления для медиа-устройств часто включают кнопки, выходящие за рамки основных элементов управления, охватываемых в другом месте этого документа, для широкого ряда этих дополнительных кнопок определены ключевые значения.
Нижеприведенные значения частично взяты из ряда технических спецификаций потребительской электроники:
- DTV Application Software Environment (часть спецификации ATSC)
- Открытая платформа приложений Open Cable
- ANSI/CEA-2014-B: Протокол и среда для пользовательского интерфейса дистанционного управления на сетях UPnP™ и Интернете
- Значения кодов клавиш Android KeyEvent
Примечание: Пульты дистанционного управления обычно включают клавиши, значения которых уже определены в других местах, например, в разделах Мультимедийные клавиши или Клавиши управления звуком. Значения этих клавиш будут соответствовать документации в этих таблицах.
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 или Blu-Ray диска). |
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] | Переключает включение/выключение внешней приставки STB. |
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] Эти клавиши были "Unidentified" до Firefox 37.
Клавиши распознавания речи
Эти специальные клавиши мультимедиа используются для управления функциями распознавания речи.
KeyboardEvent.key Значение | Описание | Виртуальный код клавиши | |||
|---|---|---|---|---|---|
| Windows | Mac | Linux | Android | ||
"SpeechCorrectionList" [1] | Представляет список возможных исправлений для слова, которое было неправильно распознано. | APPCOMMAND_CORRECTION_LIST | |||
"SpeechInputToggle" [2] | Переключает режимы диктовки и команды/управления. Это позволяет движку распознавания речи понимать, следует ли интерпретировать произнесенные слова как текстовый ввод или как команды. | APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE | |||
[1] Команда APPCOMMAND_CORRECTION_LIST в Windows генерирует "Unidentified" в Firefox.
[2] Команда APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE в Windows генерирует "Unidentified" в Firefox.
Клавиши документов
Эти клавиши управляют документами. В спецификации они включены в другие наборы клавиш (например, клавиши медиа), но их целесообразнее рассматривать как отдельную категорию.
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" | Десятая общая кнопка запуска приложения. | GDK_KEY_Launch9 (0x1008FF49)Qt::Key_Launch9 (0x010000AB) | |||
"LaunchApplication11" | Одиннадцатая общая кнопка запуска приложения. | GDK_KEY_LaunchA (0x1008FF4A)Qt::Key_LaunchA (0x010000AC) | |||
"LaunchApplication12" | Двенадцатая общая кнопка запуска приложения. | GDK_KEY_LaunchB (0x1008FF4B)Qt::Key_LaunchB (0x010000AD) | |||
"LaunchApplication13" | Тринадцатая общая кнопка запуска приложения. | GDK_KEY_LaunchC (0x1008FF4C)Qt::Key_LaunchC (0x010000AE) | |||
"LaunchApplication14" | Четырнадцатая общая кнопка запуска приложения. | GDK_KEY_LaunchD (0x1008FF4D)Qt::Key_LaunchD (0x010000AF) | |||
"LaunchApplication15" | Пятнадцатая общая кнопка запуска приложения. | GDK_KEY_LaunchE (0x1008FF4E)Qt::Key_LaunchE (0x010000B0) | |||
"LaunchApplication16" | Шестнадцатая общая кнопка запуска приложения. | 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 612743 для получения дополнительной информации.
[3] Google Chrome 57 и ранее возвращали "LaunchCalculator" вместо "LaunchApplication2". См. Баг Chrome 612743 для получения дополнительной информации.
[4] До Firefox 37 Firefox возвращал код клавиши "LaunchApplication1" вместо "LaunchWebBrowser" для клавиши Веб-браузера.
[5] Firefox ввёл поддержку этой клавиши в Firefox 37. До этого эта клавиша отображалась как "Unidentified".
Клавиши управления браузером
Некоторые клавиатуры содержат специальные клавиши для управления веб-браузерами. Эти клавиши перечислены ниже.
KeyboardEvent.key Значение | Описание | Виртуальный код клавиши | |||
|---|---|---|---|---|---|
| Windows | Mac | Linux | Android | ||
"BrowserBack" | Переход к предыдущему содержимому или странице в истории текущего веб-представления. | 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" | Переход к следующему содержимому или странице в истории текущего веб-представления. | 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" | Остановка загрузки текущего веб-представления или содержимого. | VK_BROWSER_STOP (0xA9)APPCOMMAND_BROWSER_STOP | GDK_KEY_Stop (0x1008FF28)Qt::Key_Search (0x01000063) | ||
[1] До Firefox 37 значение этой клавиши отображалось как "Unidentified".
Клавиши дополнительной цифровой клавиатуры
Эти клавиши находятся на дополнительной цифровой клавиатуре. Однако не все они присутствуют на каждой клавиатуре. Хотя типичная дополнительная цифровая клавиатура имеет цифровые клавиши от 0 до 9 (кодируемые как "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", и так далее, современные браузеры идентифицируют их, используя фактический символ ("+", ".", "*", и так далее).
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_key_values
