Интерфейс Keymap
public interface Keymap
Коллекция привязок последовательностей нажатий клавиш к действиям. Привязки представляют собой пары «имя — значение», которые могут разрешаться по иерархии.
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addActionForKeyStroke |
Добавляет привязку в карту клавиш. |
Action |
getAction |
Возвращает действие, соответствующее заданной символьной последовательности событий. |
Action[] |
getBoundActions() |
Возвращает все действия, определённые в этой карте клавиш. |
KeyStroke[] |
getBoundKeyStrokes() |
Возвращает все последовательности нажатий клавиш в этой карте, связанные с каким-либо действием. |
Action |
getDefaultAction() |
Возвращает действие по умолчанию, выполняемое при нажатии клавиши (то есть при получении KeyEvent типа KEY_TYPED), если для неё нет привязки. |
KeyStroke[] |
getKeyStrokesForAction |
Возвращает последовательности нажатий клавиш, которые вызывают заданное действие. |
String |
getName() |
Возвращает имя набора привязок клавиш. |
Keymap |
getResolveParent() |
Возвращает родительскую карту клавиш, используемую для разрешения привязок клавиш. |
boolean |
isLocallyDefined |
Определяет, задана ли указанная последовательность клавиш локально. |
void |
removeBindings() |
Удаляет все привязки из карты клавиш. |
void |
removeKeyStrokeBinding |
Удаляет привязку из карты клавиш. |
void |
setDefaultAction |
Задаёт действие по умолчанию, выполняемое при нажатии клавиши. |
void |
setResolveParent |
Задаёт родительскую карту клавиш, которая будет использоваться для разрешения привязок клавиш. |
Подробное описание методов
getName
String getName()
Возвращает имя набора привязок клавиш.
- Возвращает:
- имя
getDefaultAction
Action getDefaultAction()
Возвращает действие по умолчанию, выполняемое при нажатии клавиши (то есть при получении KeyEvent типа KEY_TYPED), если для неё нет привязки. Обычно это действие вставляет текст, поэтому для каждой возможной клавиши не требуется отдельное действие в карте клавиш.
- Возвращает:
- действие по умолчанию
setDefaultAction
void setDefaultAction(Action a)
Задаёт действие по умолчанию, выполняемое при нажатии клавиши.
- Параметры:
-
a— действие
getAction
Action getAction(KeyStroke key)
Возвращает действие, соответствующее заданной символьной последовательности событий. Этот метод используется JTextController для определения того, как интерпретировать последовательности клавиш. Если привязка не разрешается локально, предпринимается попытка разрешить её через родительскую карту клавиш, если она задана.
- Параметры:
-
key— последовательность клавиш - Возвращает:
- действие, связанное с последовательностью клавиш, если оно задано; в противном случае —
null
getBoundKeyStrokes
KeyStroke[] getBoundKeyStrokes()
Возвращает все последовательности нажатий клавиш в этой карте, связанные с каким-либо действием.
- Возвращает:
- список последовательностей нажатий клавиш
getBoundActions
Action[] getBoundActions()
Возвращает все действия, определённые в этой карте клавиш.
- Возвращает:
- список действий
getKeyStrokesForAction
KeyStroke[] getKeyStrokesForAction(Action a)
Возвращает последовательности нажатий клавиш, которые вызывают заданное действие.
- Параметры:
-
a— действие - Возвращает:
- список последовательностей нажатий клавиш
isLocallyDefined
boolean isLocallyDefined(KeyStroke key)
Определяет, задана ли указанная последовательность клавиш локально.
- Параметры:
-
key— последовательность клавиш - Возвращает:
- true, если последовательность клавиш задана локально; в противном случае — false
addActionForKeyStroke
void addActionForKeyStroke(KeyStroke key, Action a)
Добавляет привязку в карту клавиш.
- Параметры:
-
key— последовательность клавиш -
a— действие
removeKeyStrokeBinding
void removeKeyStrokeBinding(KeyStroke keys)
Удаляет привязку из карты клавиш.
- Параметры:
-
keys— последовательность клавиш
removeBindings
void removeBindings()
Удаляет все привязки из карты клавиш.
getResolveParent
Keymap getResolveParent()
Возвращает родительскую карту клавиш, используемую для разрешения привязок клавиш.
- Возвращает:
- карта клавиш
setResolveParent
void setResolveParent(Keymap parent)
Задаёт родительскую карту клавиш, которая будет использоваться для разрешения привязок клавиш. Поведение не определено, если
Keymap является одним из собственных родителей для разрешения.- Параметры:
-
parent— родительская карта клавиш
© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/text/Keymap.html