javax.swing

Класс KeyStroke

java.lang. Объект

java.awt. AWTKeyStroke

javax.swing. KeyStroke

Все Реализованные Интерфейсы:

Сериализуемый

public class KeyStroke
extends AWTKeyStroke

KeyStroke представляет ключевое действие на клавиатуре, или эквивалентное устройство ввода данных. KeyStrokes может соответствовать только нажатию или выпуску определенного ключа, как KEY_PRESSED и KeyEvents KEY_RELEASED делают; поочередно, они могут соответствовать вводу определенного символа Java, так же, как KEY_TYPED, который делают KeyEvents. Во всех случаях KeyStrokes может определить модификаторы (alt, сдвиг, управление, meta, altGraph, или комбинация этого), который должен присутствовать во время действия для точного совпадения.

KeyStrokes используются, чтобы определить высокий уровень (семантические) события действия. Вместо того, чтобы захватить каждое нажатие клавиши и выбросить тех Вы не интересуетесь, те нажатия клавиш, Вы заботитесь об автоматически начатых действиях на Компонентах, в которых они регистрируются.

KeyStrokes являются неизменными, и предназначаются, чтобы быть уникальными. Клиентский код не может создать KeyStroke; разновидность getKeyStroke должен использоваться вместо этого. Эти методы фабрики позволяют реализации KeyStroke кэшировать и совместно использовать экземпляры эффективно.

Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

См. Также:

Keymap, getKeyStroke(char)

Сводка метода

Модификатор и Тип	Метод и Описание
static KeyStroke	getKeyStroke(char keyChar) Возвращает совместно используемый экземпляр a KeyStroke это представляет a KEY_TYPED событие для указанного символа.
static KeyStroke	getKeyStroke(Character keyChar, int modifiers) Возвращает совместно используемый экземпляр a KeyStroke это представляет a KEY_TYPED событие для указанного Символьного объекта и ряда модификаторов.
static KeyStroke	getKeyStroke(char keyChar, boolean onKeyRelease) Осуждаемый. используйте getKeyStroke (случайная работа)
static KeyStroke	getKeyStroke(int keyCode, int modifiers) Возвращает совместно используемый экземпляр KeyStroke, учитывая числовой код клавиши и ряд модификаторов.
static KeyStroke	getKeyStroke(int keyCode, int modifiers, boolean onKeyRelease) Возвращает совместно используемый экземпляр KeyStroke, учитывая числовой код клавиши и ряд модификаторов, определяя, активируется ли ключ, когда это нажимается или выпускается.
static KeyStroke	getKeyStroke(String s) Анализирует строку и возвращает a KeyStroke.
static KeyStroke	getKeyStrokeForEvent(KeyEvent anEvent) Возвращает KeyStroke, который представляет штрих, который генерировал данный KeyEvent.

Методы, наследованные от class java.awt. AWTKeyStroke

equals, getAWTKeyStroke, getAWTKeyStroke, getAWTKeyStroke, getAWTKeyStroke, getAWTKeyStroke, getAWTKeyStrokeForEvent, getKeyChar, getKeyCode, getKeyEventType, getModifiers, hashCode, isOnKeyRelease, readResolve, registerSubclass, toString

Методы, наследованные от class java.lang. Объект

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь метода

getKeyStroke

public static KeyStroke getKeyStroke(char keyChar)

Возвращает совместно используемый экземпляр a KeyStroke это представляет a KEY_TYPED событие для указанного символа.

Параметры:

keyChar - символьное значение для клавиши на клавиатуре

Возвраты:

KeyStroke возражает для того ключа

getKeyStroke

@Deprecated
public static KeyStroke getKeyStroke(char keyChar,
                                                 boolean onKeyRelease)

Осуждаемый. используйте getKeyStroke (случайная работа)

Возвращает экземпляр KeyStroke, определяя, как ли ключ, полагают, активируется, когда это нажимается или выпускается. В отличие от всех других методов фабрики в этом class, экземпляры, возвращенные этим методом, не обязательно кэшируются или совместно используются.

Параметры:

keyChar - символьное значение для клавиши на клавиатуре

onKeyRelease - true если этот KeyStroke соответствует ключевому выпуску; false иначе.

Возвраты:

KeyStroke возражает для того ключа

getKeyStroke

public static KeyStroke getKeyStroke(Character keyChar,
                                     int modifiers)

Возвращает совместно используемый экземпляр a KeyStroke это представляет a KEY_TYPED событие для указанного Символьного объекта и ряда модификаторов. Отметьте, что первый параметр имеет Характер типа, а не случайную работу. Это должно избежать непреднамеренных столкновений со звонками getKeyStroke(int keyCode, int modifiers). Модификаторы состоят из любой комбинации следующего:

• java.awt.event.InputEvent.SHIFT_DOWN_MASK
• java.awt.event. InputEvent. CTRL_DOWN_MASK
• java.awt.event. InputEvent. META_DOWN_MASK
• java.awt.event. InputEvent. ALT_DOWN_MASK
• java.awt.event.InputEvent.ALT_GRAPH_DOWN_MASK

Старые модификаторы, упомянутые ниже также, могут использоваться, но они отображаются на _DOWN_ модификаторы.

• java.awt.event. InputEvent. SHIFT_MASK
• java.awt.event. InputEvent. CTRL_MASK
• java.awt.event. InputEvent. META_MASK
• java.awt.event. InputEvent. ALT_MASK
• java.awt.event. InputEvent. ALT_GRAPH_MASK

также может использоваться, но они отображаются на _DOWN_ модификаторы. Так как эти числа являются всеми различными полномочиями два, любая комбинация их является целым числом, в котором каждый бит представляет различную модифицирующую клавишу. Используйте 0, чтобы не определить модификаторы.

Параметры:

keyChar - Символьный объект для символа клавиатуры

modifiers - поразрядная-ored комбинация любых модификаторов

Возвраты:

KeyStroke возражает для того ключа

Броски:

IllegalArgumentException - если keyChar является нулем

С тех пор:

1.3

См. Также:

InputEvent

getKeyStroke

public static KeyStroke getKeyStroke(int keyCode,
                                     int modifiers,
                                     boolean onKeyRelease)

Возвращает совместно используемый экземпляр KeyStroke, учитывая числовой код клавиши и ряд модификаторов, определяя, активируется ли ключ, когда это нажимается или выпускается.

Константы "виртуальной клавиши" определяются в java.awt.event. KeyEvent может использоваться, чтобы определить код клавиши. Например:

• java.awt.event. KeyEvent. VK_ENTER
• java.awt.event. KeyEvent. VK_TAB
• java.awt.event. KeyEvent. VK_SPACE

Альтернативно, код клавиши может быть получен, вызывая java.awt.event.KeyEvent.getExtendedKeyCodeForChar. Модификаторы состоят из любой комбинации:

• java.awt.event.InputEvent.SHIFT_DOWN_MASK
• java.awt.event. InputEvent. CTRL_DOWN_MASK
• java.awt.event. InputEvent. META_DOWN_MASK
• java.awt.event. InputEvent. ALT_DOWN_MASK
• java.awt.event.InputEvent.ALT_GRAPH_DOWN_MASK

Старые модификаторы

• java.awt.event. InputEvent. SHIFT_MASK
• java.awt.event. InputEvent. CTRL_MASK
• java.awt.event. InputEvent. META_MASK
• java.awt.event. InputEvent. ALT_MASK
• java.awt.event. InputEvent. ALT_GRAPH_MASK

также может использоваться, но они отображаются на _DOWN_ модификаторы. Так как эти числа являются всеми различными полномочиями два, любая комбинация их является целым числом, в котором каждый бит представляет различную модифицирующую клавишу. Используйте 0, чтобы не определить модификаторы.

Параметры:

keyCode - интервал, определяющий числовой код для клавиши на клавиатуре

modifiers - поразрядная-ored комбинация любых модификаторов

onKeyRelease - true если KeyStroke должен представить ключевой выпуск; false иначе.

Возвраты:

KeyStroke возражает для того ключа

См. Также:

KeyEvent, InputEvent

getKeyStroke

public static KeyStroke getKeyStroke(int keyCode,
                                     int modifiers)

Возвращает совместно используемый экземпляр KeyStroke, учитывая числовой код клавиши и ряд модификаторов. Возвращенный KeyStroke будет соответствовать нажатию клавиши.

Константы "виртуальной клавиши" определяются в java.awt.event. KeyEvent может использоваться, чтобы определить код клавиши. Например:

• java.awt.event. KeyEvent. VK_ENTER
• java.awt.event. KeyEvent. VK_TAB
• java.awt.event. KeyEvent. VK_SPACE

Альтернативно, код клавиши может быть получен, вызывая java.awt.event.KeyEvent.getExtendedKeyCodeForChar. Модификаторы состоят из любой комбинации:

• java.awt.event.InputEvent.SHIFT_DOWN_MASK
• java.awt.event. InputEvent. CTRL_DOWN_MASK
• java.awt.event. InputEvent. META_DOWN_MASK
• java.awt.event. InputEvent. ALT_DOWN_MASK
• java.awt.event.InputEvent.ALT_GRAPH_DOWN_MASK

Старые модификаторы

• java.awt.event. InputEvent. SHIFT_MASK
• java.awt.event. InputEvent. CTRL_MASK
• java.awt.event. InputEvent. META_MASK
• java.awt.event. InputEvent. ALT_MASK
• java.awt.event. InputEvent. ALT_GRAPH_MASK

также может использоваться, но они отображаются на _DOWN_ модификаторы. Так как эти числа являются всеми различными полномочиями два, любая комбинация их является целым числом, в котором каждый бит представляет различную модифицирующую клавишу. Используйте 0, чтобы не определить модификаторы.

Параметры:

keyCode - интервал, определяющий числовой код для клавиши на клавиатуре

modifiers - поразрядная-ored комбинация любых модификаторов

Возвраты:

KeyStroke возражает для того ключа

См. Также:

KeyEvent, InputEvent

getKeyStrokeForEvent

public static KeyStroke getKeyStrokeForEvent(KeyEvent anEvent)

Возвращает KeyStroke, который представляет штрих, который генерировал данный KeyEvent.

Этот метод получает keyChar из события KeyTyped, и код клавиши от события KeyPressed или KeyReleased. Модификаторы KeyEvent получаются для всех трех типов KeyEvent.

Параметры:

anEvent - KeyEvent, из которого можно получить KeyStroke

Возвраты:

KeyStroke, который ускорил событие

Броски:

NullPointerException - если anEvent нуль

getKeyStroke

public static KeyStroke getKeyStroke(String s)

Анализирует строку и возвращает a KeyStroke. У строки должен быть следующий синтаксис:

    <modifiers>* (<typedID> | <pressedReleasedID>)

    modifiers := shift | control | ctrl | meta | alt | altGraph
    typedID := typed <typedKey>
    typedKey := string of length 1 giving Unicode character.
    pressedReleasedID := (pressed | released) key
    key := KeyEvent key code name, i.e. the name following "VK_".
 

Если введено, нажатый или выпущенный не определяется, нажатый принимается. Вот некоторые примеры:

     "INSERT" => getKeyStroke(KeyEvent.VK_INSERT, 0);
     "control DELETE" => getKeyStroke(KeyEvent.VK_DELETE, InputEvent.CTRL_MASK);
     "alt shift X" => getKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK);
     "alt shift released X" => getKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK, true);
     "typed a" => getKeyStroke('a');
 

Чтобы поддержать прежнюю совместимость, определяя пустую строку, или Строка, которая форматируется неправильно, возвращает нуль.

Параметры:

s - Строка, отформатированная как описано выше

Возвраты:

KeyStroke возражает для той Строки, или нуля, если указанная Строка является нулем, или форматируется неправильно

См. Также:

KeyEvent