Spec-Zone.ru › OpenJDK 24

Класс AWTKeyStroke

java.lang.Object
java.awt.AWTKeyStroke
Все реализованные интерфейсы:
Serializable
Прямые известные подклассы:
KeyStroke
public class AWTKeyStroke extends Object implements Serializable
Объект AWTKeyStroke представляет действие клавиши на клавиатуре или на эквивалентном устройстве ввода. Объекты AWTKeyStroke могут соответствовать только нажатию или отпусканию определенной клавиши, как и объекты KEY_PRESSED и KEY_RELEASED KeyEvent; альтернативно, они могут соответствовать вводу определенного символа Java, как и объекты KEY_TYPED KeyEvent. Во всех случаях, объекты AWTKeyStroke могут указывать модификаторы (alt, shift, control, meta, altGraph или их комбинации), которые должны быть присутствовать во время действия для точного соответствия.

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

С:
1.4
См. также:
  • getAWTKeyStroke(char)
  • Сериализованная форма

Краткое описание конструкторов

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

Краткое описание методов

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

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

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

Подробное описание конструкторов

AWTKeyStroke

protected AWTKeyStroke()
Создаёт AWTKeyStroke с значениями по умолчанию. Значения по умолчанию:
Значения по умолчанию для AWTKeyStroke
Свойство Значение по умолчанию
Символ ключа KeyEvent.CHAR_UNDEFINED
Код ключа KeyEvent.VK_UNDEFINED
Модификаторы нет
При нажатии или отпускании ключа? false
AWTKeyStroke не должны создаваться кодом клиента. Используйте вариант getAWTKeyStroke вместо этого.
См. также:
  • getAWTKeyStroke(char)

AWTKeyStroke

protected AWTKeyStroke(char keyChar, int keyCode, int modifiers, boolean onKeyRelease)
Создаёт AWTKeyStroke со значениями по умолчанию. AWTKeyStroke не должны создаваться кодом клиента. Используйте вариант getAWTKeyStroke вместо этого.
Параметры:
keyChar - значение символа для клавиши
keyCode - код ключа для этого AWTKeyStroke
modifiers - побитовое ИЛИ-соединение модификаторов
onKeyRelease - true если этот AWTKeyStroke соответствует отпусканию клавиши; false в противном случае
См. также:
  • getAWTKeyStroke(char)

Подробное описание методов

registerSubclass

@Deprecated protected static void registerSubclass(Class<?> subclass)
Устарело.
Метод не имеет эффекта и оставлен для избежания бинарной несовместимости.
Параметры:
subclass - новый класс, чьи экземпляры должны создаваться методами-фабриками

getAWTKeyStroke

public static AWTKeyStroke getAWTKeyStroke(char keyChar)
Возвращает общий экземпляр AWTKeyStroke, представляющий событие KEY_TYPED для указанного символа.
Параметры:
keyChar - значение символа для клавиши
Возвращает:
объект AWTKeyStroke для этой клавиши

getAWTKeyStroke

public static AWTKeyStroke getAWTKeyStroke(Character keyChar, int modifiers)
Возвращает общий экземпляр AWTKeyStroke, представляющий событие KEY_TYPED для указанного объекта Character и набора модификаторов. Обратите внимание, что первый параметр имеет тип Character, а не char. Это сделано для избежания непреднамеренных столкновений с вызовами 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 - объект Character для символа клавиши
modifiers - побитовое ИЛИ-соединение модификаторов
Возвращает:
объект 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 - побитовое ИЛИ-соединение модификаторов
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 - побитовое ИЛИ-соединение модификаторов
Возвращает:
объект AWTKeyStroke для этой клавиши
См. также:
  • KeyEvent
  • InputEvent

getAWTKeyStrokeForEvent

public static AWTKeyStroke getAWTKeyStrokeForEvent(KeyEvent anEvent)
Возвращает AWTKeyStroke, который представляет нажатие, сгенерировавшее заданное событие KeyEvent.

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

Параметры:
anEvent - событие KeyEvent, из которого извлечь AWTKeyStroke
Возвращает:
AWTKeyStroke, вызвавшее событие
Исключения:
NullPointerException - если anEvent равно null

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_".
Если pressed/released/typed не указаны, предполагается pressed. Вот некоторые примеры: 
     "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.
Возвращает:
значение char
См. также:
  • 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

hashCode

public int hashCode()
Возвращает числовое значение для этого объекта, которое, вероятно, будет уникальным, что делает его хорошим выбором в качестве значения индекса в хеш-таблице.
Overrides:
hashCode в классе Object
Возвращает:
целое число, представляющее этот объект
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

equals

public final boolean equals(Object anObject)
Возвращает true, если этот объект идентичен указанному объекту.
Overrides:
equals в классе Object
Параметры:
anObject - объект для сравнения с этим объектом
Возвращает:
true, если объекты идентичны
См. также:
  • Object.hashCode()
  • HashMap

toString

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

readResolve

protected Object readResolve() throws ObjectStreamException
Возвращает кэшированный экземпляр AWTKeyStroke (или подкласса AWTKeyStroke), равный этому экземпляру.
Возвращает:
кэшированный экземпляр, равный этому экземпляру
Исключения:
ObjectStreamException - если возникает проблема с сериализацией

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/AWTKeyStroke.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API