Класс TextAction

java.lang.Object

javax.swing.AbstractAction

javax.swing.text.TextAction

Все реализуемые интерфейсы:: ActionListener, Serializable, Cloneable, EventListener, Action

Прямые известные подклассы:: DefaultEditorKit.BeepAction, DefaultEditorKit.CopyAction, DefaultEditorKit.CutAction, DefaultEditorKit.DefaultKeyTypedAction, DefaultEditorKit.InsertBreakAction, DefaultEditorKit.InsertContentAction, DefaultEditorKit.InsertTabAction, DefaultEditorKit.PasteAction, StyledEditorKit.StyledTextAction

public abstract class TextAction extends AbstractAction

Реализация Action, полезная для привязок клавиш, общих для нескольких текстовых компонентов. Поскольку действие является общим, ему необходим способ получить целевой объект, к которому оно будет применено. Этот класс позволяет найти текстовый компонент, с которым следует работать. Предпочтительный способ получить компонент, к которому нужно применить действие, — использовать полученный ActionEvent. Если Object, возвращаемый getSource, можно привести к текстовому компоненту, будет использован он. Если событие действия равно null или его нельзя привести к нужному типу, используется последний текстовый компонент, находившийся в фокусе. Это обеспечивается при совместном использовании с JTextController, который передает эту информацию объекту TextAction.

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

Краткое описание полей

Поля, объявленные в классе AbstractAction

changeSupport, enabled

Модификатор и тип	Поле	Описание
`protected SwingPropertyChangeSupport`	`changeSupport`	Если зарегистрированы какие-либо `PropertyChangeListeners`, поле `changeSupport` описывает их.
`protected boolean`	`enabled`	Указывает, включено ли действие; значение по умолчанию — true.

Поля, объявленные в интерфейсе Action

ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, DISPLAYED_MNEMONIC_INDEX_KEY, LARGE_ICON_KEY, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SELECTED_KEY, SHORT_DESCRIPTION, SMALL_ICON

Модификатор и тип	Поле	Описание
`static final String`	`ACCELERATOR_KEY`	Ключ для хранения `KeyStroke`, используемого в качестве клавиши быстрого доступа для действия.
`static final String`	`ACTION_COMMAND_KEY`	Ключ, используемый для определения `String` команды для `ActionEvent`, который будет создан, когда `Action` будет оповещен в результате нахождения в `Keymap`, связанном с `JComponent`.
`static final String`	`DEFAULT`	В настоящее время не используется.
`static final String`	`DISPLAYED_MNEMONIC_INDEX_KEY`	Ключ для хранения `Integer`, соответствующего индексу в тексте (определяемому свойством `NAME`), в котором должна отображаться отметка мнемонического символа.
`static final String`	`LARGE_ICON_KEY`	Ключ для хранения `Icon`.
`static final String`	`LONG_DESCRIPTION`	Ключ для хранения более подробного `String` описания действия, которое может использоваться для контекстной справки.
`static final String`	`MNEMONIC_KEY`	Ключ для хранения `Integer`, соответствующего одному из кодов клавиш `KeyEvent`.
`static final String`	`NAME`	Ключ для хранения `String` имени действия, используемого для меню или кнопки.
`static final String`	`SELECTED_KEY`	Ключ для хранения `Boolean`, соответствующего выбранному состоянию.
`static final String`	`SHORT_DESCRIPTION`	Ключ для хранения краткого `String` описания действия, используемого в качестве текста всплывающей подсказки.
`static final String`	`SMALL_ICON`	Ключ для хранения небольшого `Icon`, например `ImageIcon`.

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

Конструктор	Описание
`TextAction(String name)`	Создает новый объект JTextAction.

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

Модификатор и тип	Метод	Описание
`static final Action[]`	`augmentList(Action[] list1, Action[] list2)`	Объединяет один список команд с другим, дополняя первый список командами из второго.
`protected final JTextComponent`	`getFocusedComponent()`	Возвращает текстовый компонент, который в данный момент находится в фокусе.
`protected final JTextComponent`	`getTextComponent(ActionEvent e)`	Определяет компонент, используемый для действия.

Методы, объявленные в классе AbstractAction

addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled

Модификатор и тип	Метод	Описание
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет `PropertyChangeListener` в список слушателей.
`protected Object`	`clone()`	Клонирует абстрактное действие.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддерживает отправку уведомлений об изменениях связанных свойств.
`Object[]`	`getKeys()`	Возвращает массив `Object`, являющихся ключами, для которых заданы значения в этом `AbstractAction`, или `null`, если значения не заданы ни для одного ключа.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех `PropertyChangeListener`, добавленных в этот AbstractAction с помощью addPropertyChangeListener().
`Object`	`getValue(String key)`	Возвращает `Object`, связанное с указанным ключом.
`boolean`	`isEnabled()`	Возвращает true, если действие включено.
`void`	`putValue(String key, Object newValue)`	Устанавливает `Value`, связанное с указанным ключом.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка слушателей.
`void`	`setEnabled(boolean newValue)`	Устанавливает, включено ли `Action`.

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

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Показывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Метод завершения устарел и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать до пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

Методы, объявленные в интерфейсе Action

accept

Модификатор и тип	Метод	Описание
`default boolean`	`accept(Object sender)`	Определяет, следует ли выполнить действие с указанным объектом-отправителем.

Методы, объявленные в интерфейсе ActionListener

actionPerformed

Модификатор и тип	Метод	Описание
`void`	`actionPerformed(ActionEvent e)`	Вызывается при возникновении действия.

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

TextAction

public TextAction(String name)

Создает новый объект JTextAction.

Параметры:: name — имя действия

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

getTextComponent

protected final JTextComponent getTextComponent(ActionEvent e)

Определяет компонент, используемый для действия. Он извлекается из источника ActionEvent, если тот не равен null и его можно привести к нужному типу. В противном случае используется компонент, который последним находился в фокусе.

Параметры:: e — ActionEvent
Возвращает:: компонент

augmentList

public static final Action[] augmentList(Action[] list1, Action[] list2)

Объединяет один список команд с другим, дополняя первый список командами из второго. Второй список имеет приоритет над первым: если в обоих списках есть команда с одинаковым именем, используется команда из второго списка.

Параметры:: list1 — первый список; может быть пустым, но не null; list2 — второй список; может быть пустым, но не null
Возвращает:: дополненный список

getFocusedComponent

protected final JTextComponent getFocusedComponent()

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

Возвращает:: компонент

© 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.