Класс KeyEvent

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

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

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

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

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

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

Например, нажатие клавиши Shift вызовет событие KEY_PRESSED с keyCode VK_SHIFT, а нажатие клавиши 'a' приведет к keyCode 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_ALL_CANDIDATES возвращается вместо VK_CONVERT с модификатором ALT.
• Как указано в Спецификации фокуса, события клавиш по умолчанию рассылаются владельцу фокуса.

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

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