Класс KeyEvent

Это низкоуровневое событие генерируется объектом компонента (таким как текстовое поле) при нажатии, отпускании или вводе клавиши. Событие передаётся каждому объекту-слушателю (либо объекту-обработчику событий), который зарегистрирован для получения таких событий с помощью метода компонента addKeyListener. (Объекты KeyAdapter реализуют интерфейс KeyListener.) Каждый такой объект-слушатель получает это событие KeyEvent при возникновении события.

События "ввода символа" (key typed) более высокого уровня и обычно не зависят от платформы или раскладки клавиатуры. Они генерируются при вводе символа Юникода и являются предпочтительным способом определения ввода символов. В простейшем случае, событие ввода символа генерируется одним нажатием клавиши (например, 'a'). Однако часто символы генерируются последовательностью нажатий клавиш (например, 'shift' + 'a'), и соответствие между событиями нажатия клавиши и событиями ввода символа может быть множественно-однозначным или множественно-множественным. Отпускание клавиш обычно не требуется для генерации события ввода символа, но в некоторых случаях событие ввода символа не генерируется до тех пор, пока клавиша не отпустится (например, ввод ASCII-последовательностей с помощью метода Alt-Numpad в Windows). События ввода символа не генерируются для клавиш, которые не генерируют символы Юникода (например, функциональные клавиши, модификаторные клавиши и т. д.).

Метод getKeyChar всегда возвращает допустимый символ Юникода или CHAR_UNDEFINED. Ввод символов сообщается событиями KEY_TYPED: события KEY_PRESSED и KEY_RELEASED не обязательно связаны с вводом символов. Следовательно, результат метода getKeyChar гарантированно имеет смысл только для событий KEY_TYPED.

Для событий нажатия и отпускания клавиш метод getKeyCode возвращает код клавиши события. Для событий ввода символа метод getKeyCode всегда возвращает VK_UNDEFINED. Метод getExtendedKeyCode также может использоваться с многими международными раскладками клавиатуры.

События "нажатие клавиши" и "отпускание клавиши" являются низкоуровневыми и зависят от платформы и раскладки клавиатуры. Они генерируются всякий раз, когда клавиша нажимается или отпускается, и являются единственным способом узнать о клавишах, которые не генерируют ввод символов (например, функциональные клавиши, модификаторные клавиши и т. д.). Нажимаемая или отпускаемая клавиша указывается методами getKeyCode и getExtendedKeyCode, которые возвращают виртуальный код клавиши.

Виртуальные коды клавиш используются для указания нажатой клавиши клавиатуры, а не символа, сгенерированного комбинацией нажатий клавиш (например, "A", который получен из комбинации shift и "a").

Например, нажатие клавиши Shift вызовет событие KEY_PRESSED с кодом VK_SHIFT, а нажатие клавиши 'a' приведет к коду VK_A. После отпускания клавиши 'a' будет сгенерировано событие KEY_RELEASED с VK_A. Отдельно генерируется событие KEY_TYPED с значением keyChar 'A'.

Нажатие и отпускание клавиши на клавиатуре приводит к генерации следующих событий (в порядке):

    KEY_PRESSED
    KEY_TYPED (is only generated if a valid Unicode character could be generated.)
    KEY_RELEASED
 

Примечания:

• Комбинации клавиш, которые не приводят к символам Юникода, такие как функциональные клавиши, например F1 и клавиша HELP, не генерируют событий KEY_TYPED.
• Не все клавиатуры или системы способны генерировать все виртуальные коды клавиш. Java не пытается искусственно генерировать эти клавиши.
• Виртуальные коды клавиш не идентифицируют физическую клавишу: они зависят от платформы и раскладки клавиатуры. Например, клавиша, генерирующая VK_Q при использовании раскладки клавиатуры США, будет генерировать VK_A при использовании французской раскладки клавиатуры.
• Клавиша, которая генерирует VK_Q при использовании раскладки клавиатуры США, также генерирует уникальный код для русской или ивритской раскладки. Нет константы VK_ для этих и многих других кодов в различных раскладках. Эти коды можно получить с помощью getExtendedKeyCode и используются всякий раз, когда используется константа VK_.
• Не все символы имеют связанный с ними код клавиши. Например, нет кода клавиши для знака вопроса, потому что нет клавиатуры, на которой он отображается на основном слое.
• Для поддержки независимой от платформы обработки функциональных клавиш Java-платформа использует несколько дополнительных виртуальных констант клавиш для функций, которые в противном случае должны были бы распознаваться путем интерпретации виртуальных кодов клавиш и модификаторов. Например, для японских клавиатур Windows вместо VK_CONVERT с модификатором ALT возвращается VK_ALL_CANDIDATES.
• Как указано в Спецификации фокуса, события клавиш по умолчанию отправляются владельцу фокуса.

ПРЕДУПРЕЖДЕНИЕ: Помимо тех клавиш, которые определены языком Java (VK_ENTER, VK_BACK_SPACE и VK_TAB), не полагайтесь на значения констант VK_. Платформа оставляет за собой право изменять эти значения по мере необходимости для поддержки более широкого спектра клавиатур в будущем.

Неопределенное поведение будет вызвано, если параметр id любого экземпляра KeyEvent не находится в диапазоне от KEY_FIRST до KEY_LAST.