|
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.EventObjectKeyEvent объект.public KeyEvent copyFor(java.lang.Object newSource, EventTarget newTarget)
Eventnull, это заменяется NULL_SOURCE_TARGET значение.public KeyEvent copyFor(java.lang.Object source, EventTarget target, EventType<KeyEvent> type)
source - новый источник скопированного событияtarget - новая цель скопированного событияtype - новый тип события.public EventType<KeyEvent> getEventType()
EventEvent У class могут быть различные типы события. Эти событие вводит, далее определяют, какое событие имело место.getEventType в class InputEventCopyright (c) 2008, 2013, Oracle и/или его филиалы. Все права защищены. Использование подвергается .