java.awt

Класс AWTKeyStroke

java.lang. Объект

java.awt. AWTKeyStroke

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

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

Прямые Известные Подклассы:

KeyStroke

public class AWTKeyStroke
extends Object
implements Serializable

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

AWTKeyStrokes являются неизменными, и предназначаются, чтобы быть уникальными. Клиентский код никогда не должен создавать AWTKeyStroke самостоятельно, но должен вместо этого использовать разновидность getAWTKeyStroke. Клиентское использование этих методов фабрики позволяет AWTKeyStroke реализация, чтобы кэшироваться и совместно использовать экземпляры эффективно.

С тех пор:

1.4

См. Также:

getAWTKeyStroke(char), Сериализированная Форма

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	AWTKeyStroke() Конструкции AWTKeyStroke со значениями по умолчанию.
protected	AWTKeyStroke(char keyChar, int keyCode, int modifiers, boolean onKeyRelease) Конструкции AWTKeyStroke с указанными значениями.

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

Методы

Модификатор и Тип	Метод и Описание
boolean	equals(Object anObject) Возвращает true, если этот объект идентичен указанному объекту.
static AWTKeyStroke	getAWTKeyStroke(char keyChar) Возвращает совместно используемый экземпляр AWTKeyStroke это представляет a KEY_TYPED событие для указанного символа.
static AWTKeyStroke	getAWTKeyStroke(Character keyChar, int modifiers) Возвращает совместно используемый экземпляр AWTKeyStroke это представляет a KEY_TYPED событие для указанного Символьного объекта и ряда модификаторов.
static AWTKeyStroke	getAWTKeyStroke(int keyCode, int modifiers) Возвращает совместно используемый экземпляр AWTKeyStroke, учитывая числовой код ключа и ряд модификаторов.
static AWTKeyStroke	getAWTKeyStroke(int keyCode, int modifiers, boolean onKeyRelease) Возвращает совместно используемый экземпляр AWTKeyStroke, учитывая числовой код ключа и ряд модификаторов, определяя, активируется ли ключ, когда это нажимается или выпускается.
static AWTKeyStroke	getAWTKeyStroke(String s) Анализирует строку и возвращается AWTKeyStroke.
static AWTKeyStroke	getAWTKeyStrokeForEvent(KeyEvent anEvent) Возвраты AWTKeyStroke который представляет штрих, который генерировал данный KeyEvent.
char	getKeyChar() Возвращает символ для этого AWTKeyStroke.
int	getKeyCode() Возвращает числовой код ключа для этого AWTKeyStroke.
int	getKeyEventType() Возвращает тип KeyEvent который соответствует этому AWTKeyStroke.
int	getModifiers() Возвращает модифицирующие клавиши для этого AWTKeyStroke.
int	hashCode() Возвращает числовое значение для этого объекта, который, вероятно, будет уникален, делая его хороший выбор как индексное значение в хэш-таблице.
boolean	isOnKeyRelease() Возвраты, ли это AWTKeyStroke представляет ключевой выпуск.
protected Object	readResolve() Возвращает кэшируемый экземпляр AWTKeyStroke (или подкласс AWTKeyStroke) который равен этому экземпляру.
protected static void	registerSubclass(Class<?> subclass) Регистрирует новый класс который методы фабрики в AWTKeyStroke будет использовать, генерируя новые экземпляры AWTKeyStrokes.
Строка	toString() Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта.

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

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

Деталь конструктора

AWTKeyStroke

protected AWTKeyStroke()

Конструкции AWTKeyStroke со значениями по умолчанию. Используемые значения по умолчанию:

Свойство	Значение по умолчанию
Ключевая Случайная работа	KeyEvent.CHAR_UNDEFINED
Код ключа	KeyEvent.VK_UNDEFINED
Модификаторы	ни один
На ключевом выпуске?	false

AWTKeyStrokes не должен быть создан клиентским кодом. Используйте разновидность getAWTKeyStroke вместо этого.

См. Также:

getAWTKeyStroke(char)

AWTKeyStroke

protected AWTKeyStroke(char keyChar,
            int keyCode,
            int modifiers,
            boolean onKeyRelease)

Конструкции AWTKeyStroke с указанными значениями. AWTKeyStrokes не должен быть создан клиентским кодом. Используйте разновидность getAWTKeyStroke вместо этого.

Параметры:

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

keyCode - код ключа для этого AWTKeyStroke

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

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

См. Также:

getAWTKeyStroke(char)

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

registerSubclass

protected static void registerSubclass(Class<?> subclass)

Регистрирует новый класс который методы фабрики в AWTKeyStroke будет использовать, генерируя новые экземпляры AWTKeyStrokes. После вызова этого метода методы фабрики возвратят экземпляры указанного Класса. Указанный Класс должен быть также AWTKeyStroke или полученный из AWTKeyStroke, и у этого должен быть конструктор без аргументов. Конструктор может иметь любую доступность, включая private. Эта работа сбрасывает ток AWTKeyStroke кэш.

Параметры:

subclass - новый Класс которого методы фабрики должны создать экземпляры

Броски:

IllegalArgumentException - если подкласс null, или если у подкласса нет конструктора без аргументов

ClassCastException - если подкласс не AWTKeyStroke, или класс, полученный из AWTKeyStroke

getAWTKeyStroke

public static AWTKeyStroke getAWTKeyStroke(char keyChar)

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

Параметры:

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

Возвраты:

AWTKeyStroke объект для того ключа

getAWTKeyStroke

public static AWTKeyStroke getAWTKeyStroke(Character keyChar,
                           int modifiers)

Возвращает совместно используемый экземпляр AWTKeyStroke это представляет a KEY_TYPED событие для указанного Символьного объекта и ряда модификаторов. Отметьте, что первый параметр имеет Характер типа, а не случайную работу. Это должно избежать непреднамеренных столкновений со звонками getAWTKeyStroke(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 комбинация любых модификаторов

Возвраты:

AWTKeyStroke объект для того ключа

Броски:

IllegalArgumentException - если keyChar null

См. Также:

InputEvent

getAWTKeyStroke

public static AWTKeyStroke getAWTKeyStroke(int keyCode,
                           int modifiers,
                           boolean onKeyRelease)

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

Константы "виртуальной клавиши", определенные в 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 если AWTKeyStroke должен представить ключевой выпуск; false иначе

Возвраты:

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

См. Также:

KeyEvent, InputEvent

getAWTKeyStroke

public static AWTKeyStroke getAWTKeyStroke(int keyCode,
                           int modifiers)

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

Константы "виртуальной клавиши", определенные в 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.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 комбинация любых модификаторов

Возвраты:

AWTKeyStroke объект для того ключа

См. Также:

KeyEvent, InputEvent

getAWTKeyStrokeForEvent

public static AWTKeyStroke getAWTKeyStrokeForEvent(KeyEvent anEvent)

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

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

Параметры:

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

Возвраты:

AWTKeyStroke это ускорило событие

Броски:

NullPointerException - если anEvent нуль

getAWTKeyStroke

public static AWTKeyStroke getAWTKeyStroke(String s)

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

    <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" => getAWTKeyStroke(KeyEvent.VK_INSERT, 0);
     "control DELETE" => getAWTKeyStroke(KeyEvent.VK_DELETE, InputEvent.CTRL_MASK);
     "alt shift X" => getAWTKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK);
     "alt shift released X" => getAWTKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK, true);
     "typed a" => getAWTKeyStroke('a');
 

Параметры:

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

Возвраты:

AWTKeyStroke объект для той Строки

Броски:

IllegalArgumentException - если s null, или форматируется неправильно

getKeyChar

public final char getKeyChar()

Возвращает символ для этого AWTKeyStroke.

Возвраты:

значение случайной работы

См. Также:

getAWTKeyStroke(char), KeyEvent.getKeyChar()

getKeyCode

public final int getKeyCode()

Возвращает числовой код ключа для этого AWTKeyStroke.

Возвраты:

интервал, содержащий значение кода ключа

См. Также:

getAWTKeyStroke(int,int), KeyEvent.getKeyCode()

getModifiers

public final int getModifiers()

Возвращает модифицирующие клавиши для этого AWTKeyStroke.

Возвраты:

интервал, содержащий модификаторы

См. Также:

getAWTKeyStroke(int,int)

isOnKeyRelease

public final boolean isOnKeyRelease()

Возвраты, ли это AWTKeyStroke представляет ключевой выпуск.

Возвраты:

true если это AWTKeyStroke представляет ключевой выпуск; false иначе

См. Также:

getAWTKeyStroke(int,int,boolean)

getKeyEventType

public final int getKeyEventType()

Возвращает тип KeyEvent который соответствует этому AWTKeyStroke.

Возвраты:

KeyEvent.KEY_PRESSED, KeyEvent.KEY_TYPED, или KeyEvent.KEY_RELEASED

См. Также:

KeyEvent

хэш-код

public int hashCode()

Возвращает числовое значение для этого объекта, который, вероятно, будет уникален, делая его хороший выбор как индексное значение в хэш-таблице.

Переопределения:

hashCode в классе Object

Возвраты:

интервал, который представляет этот объект

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

равняется

public final boolean equals(Object anObject)

Возвращает true, если этот объект идентичен указанному объекту.

Переопределения:

equals в классе Object

Параметры:

anObject - Объект сравнить этот объект с

Возвраты:

истина, если объекты идентичны

См. Также:

Object.hashCode(), HashMap

toString

public String toString()

Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта. String к возвращенный этим методом можно передать в качестве параметра getAWTKeyStroke(String) произвести нажатие клавиши, равное этому нажатию клавиши.

Переопределения:

toString в классе Object

Возвраты:

Строковое представление этого объекта

См. Также:

getAWTKeyStroke(String)

readResolve

protected Object readResolve()
                      throws ObjectStreamException

Возвращает кэшируемый экземпляр AWTKeyStroke (или подкласс AWTKeyStroke) который равен этому экземпляру.

Возвраты:

кэшируемый экземпляр, который равен этому экземпляру

Броски:

ObjectStreamException