Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class KeyEvent extends InputEvent
Node
. Это событие сгенерировано, когда клавиша нажимается, выпускается, или вводится. В зависимости от типа события к этому передают onKeyPressed
, onKeyTyped
или onKeyReleased
функция.
События "Key typed" являются высокоуровневыми и обычно не зависят от платформы или раскладки клавиатуры. Они сгенерированы, когда символ Unicode вводится, и является привилегированным способом узнать о вводе символов. В самом простом случае ключ введенное событие производится одно нажатием клавиши (например,). Часто, однако, символы производятся рядом нажатий клавиш (например, SHIFT +), и отображение от ключа нажатые события к ключу, введенные события могут быть "многими к один" или "многими многим". Ключевые выпуски не обычно необходимы, чтобы генерировать ключ введенное событие, но есть некоторые случаи, где ключ, введенное событие не сгенерировано, пока клавиша не отпускается (например, вводя последовательности ASCII через метод Alt-Numpad в Windows). Введенные события никакого ключа сгенерированы для ключей, которые не генерируют символы Unicode (например, ключи действия, модифицирующие клавиши, и т.д.).
character
переменная всегда содержит допустимый символ (ы) Unicode или CHAR_UNDEFINED. О вводе символов сообщает ключ введенные события; ключ нажал и ключ, выпущенные события не обязательно связываются с вводом символов. Поэтому, character
переменная, как гарантируют, будет значима только для ключа введенные события.
Для нажатой клавиши и ключа выпущенные события, code
переменная содержит код клавиши события. Для ключа введенные события, code
переменная всегда содержит KeyCode.UNDEFINED
.
"Ключ нажатая" и "клавиша выпущенные" события низшего уровня и зависят от платформы и раскладки клавиатуры. Они сгенерированы всякий раз, когда клавиша нажимается или выпускается, и является единственным способом узнать о ключах, которые не генерируют ввод символов (например, ключи действия, модифицирующие клавиши, и т.д.). Клавиша, нажимаемая или отпущенная, обозначается переменной кода, которая содержит код виртуальной клавиши.
Для того, чтобы инициировать контекстные меню см. ContextMenuEvent
.
Модификатор и Тип | Поле и Описание |
---|---|
static EventType<KeyEvent> |
ЛЮБОЙ
Общий супертип для всех типов ключевого события.
|
static java.lang.String |
CHAR_UNDEFINED
События KEY_PRESSED И KEY_RELEASED, которые не отображаются на допустимый символ Unicode, используют это для значения keyChar.
|
static EventType<KeyEvent> |
KEY_PRESSED
Это событие имеет место, когда клавиша была нажата.
|
static EventType<KeyEvent> |
KEY_RELEASED
Это событие имеет место, когда клавиша была отпущена.
|
static EventType<KeyEvent> |
KEY_TYPED
Это событие имеет место, когда ключ был введен (нажатый и выпущенный).
|
consumed, eventType, NULL_SOURCE_TARGET, target
Конструктор и Описание |
---|
KeyEvent(EventType<KeyEvent> eventType, java.lang.String character, java.lang.String text, KeyCode code, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown)
Создает новое событие KeyEvent с нулевым источником и целью и объектом KeyCode, непосредственно определенным.
|
KeyEvent(java.lang.Object source, EventTarget target, EventType<KeyEvent> eventType, java.lang.String character, java.lang.String text, KeyCode code, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown)
Создает новое событие KeyEvent с нулевым источником и целью и объектом KeyCode, непосредственно определенным.
|
Модификатор и Тип | Метод и Описание |
---|---|
KeyEvent |
copyFor(java.lang.Object newSource, EventTarget newTarget)
Создает и возвращает копию этого события с указанным источником события и целью.
|
KeyEvent |
copyFor(java.lang.Object source, EventTarget target, EventType<KeyEvent> type)
Создает копию данного события с данными полями, которыми заменяют.
|
java.lang.String |
getCharacter()
Символ Unicode или последовательность символов связали с ключом введенное событие.
|
KeyCode |
getCode()
Код клавиши, связанный с ключом в этом ключе, нажал или ключ выпущенное событие.
|
EventType<KeyEvent> |
getEventType()
Получает тип события этого события.
|
java.lang.String |
getText()
Строка, описывающая код клавиши, такой как "ДОМОЙ", "F1" или "A", для ключа, нажала и ключ выпущенные события.
|
boolean |
isAltDown()
Возвраты, снижается ли модификатор Высокого звука на этом событии.
|
boolean |
isControlDown()
Возвраты, снижается ли модификатор Управления на этом событии.
|
boolean |
isMetaDown()
Возвраты, снижается ли модификатор Меты на этом событии.
|
boolean |
isShiftDown()
Возвраты, снижается ли модификатор Сдвига на этом событии.
|
boolean |
isShortcutDown()
Возвраты, снижается ли платформа узла общий модификатор ярлыка на этом событии.
|
java.lang.String |
toString()
Возвращает строковое представление этого
KeyEvent объект. |
public static final EventType<KeyEvent> ЛЮБОЙ
public static final EventType<KeyEvent> KEY_PRESSED
public static final EventType<KeyEvent> KEY_RELEASED
public static final EventType<KeyEvent> KEY_TYPED
character
поле, содержащее введенную строку, code
и text
поля не используются.public static final java.lang.String CHAR_UNDEFINED
public KeyEvent(java.lang.Object source, EventTarget target, EventType<KeyEvent> eventType, java.lang.String character, java.lang.String text, KeyCode code, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown)
source
- источник события. Может быть нуль.target
- цель события. Может быть нуль.eventType
- Тип события.character
- Символ или последовательность символов связались с событиемtext
- Строка, описывающая код клавишиcode
- Целочисленный код клавишиshiftDown
- истина, если модификатор сдвига был нажат.controlDown
- истина, если модификатор управления был нажат.altDown
- истина, если модификатор alt был нажат.metaDown
- истина, если meta модификатор был нажат.public KeyEvent(EventType<KeyEvent> eventType, java.lang.String character, java.lang.String text, KeyCode code, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown)
eventType
- Тип события.character
- Символ или последовательность символов связались с событиемtext
- Строка, описывающая код клавишиcode
- Целочисленный код клавишиshiftDown
- истина, если модификатор сдвига был нажат.controlDown
- истина, если модификатор управления был нажат.altDown
- истина, если модификатор alt был нажат.metaDown
- истина, если meta модификатор был нажат.public final java.lang.String getCharacter()
character
будет иметь значение "A" для ключа введенное событие сгенерированный, нажимая SHIFT +. Для нажатой клавиши и ключа выпущенные события, character
всегда CHAR_UNDEFINED
.public final java.lang.String getText()
text
всегда пустая строка.public final KeyCode getCode()
code
всегда KeyCode.UNDEFINED
.KeyCode.UNDEFINED
для ключа введенное событиеpublic final boolean isShiftDown()
public final boolean isControlDown()
public final boolean isAltDown()
public final boolean isMetaDown()
public final boolean isShortcutDown()
control
на Windows и meta
(командная клавиша) на Mac.true
если модификатор ярлыка снижается, false
иначеpublic java.lang.String toString()
KeyEvent
объект.toString
в class java.util.EventObject
KeyEvent
объект.public KeyEvent copyFor(java.lang.Object newSource, EventTarget newTarget)
Event
null
, это заменяется NULL_SOURCE_TARGET
значение.public KeyEvent copyFor(java.lang.Object source, EventTarget target, EventType<KeyEvent> type)
source
- новый источник скопированного событияtarget
- новая цель скопированного событияtype
- новый тип события.public EventType<KeyEvent> getEventType()
Event
Event
У class могут быть различные типы события. Эти событие вводит, далее определяют, какое событие имело место.getEventType
в class InputEvent
Copyright (c) 2008, 2013, Oracle и/или его филиалы. Все права защищены. Использование подвергается