Класс AbstractAction

java.lang.Object

javax.swing.AbstractAction

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

Прямые известные подклассы:: BasicDesktopPaneUI.CloseAction, BasicDesktopPaneUI.MaximizeAction, BasicDesktopPaneUI.MinimizeAction, BasicDesktopPaneUI.NavigateAction, BasicDesktopPaneUI.OpenAction, BasicFileChooserUI.ApproveSelectionAction, BasicFileChooserUI.CancelSelectionAction, BasicFileChooserUI.ChangeToParentDirectoryAction, BasicFileChooserUI.GoHomeAction, BasicFileChooserUI.NewFolderAction, BasicFileChooserUI.UpdateAction, BasicInternalFrameTitlePane.CloseAction, BasicInternalFrameTitlePane.IconifyAction, BasicInternalFrameTitlePane.MaximizeAction, BasicInternalFrameTitlePane.MoveAction, BasicInternalFrameTitlePane.RestoreAction, BasicInternalFrameTitlePane.SizeAction, BasicSliderUI.ActionScroller, BasicTreeUI.TreeCancelEditingAction, BasicTreeUI.TreeHomeAction, BasicTreeUI.TreeIncrementAction, BasicTreeUI.TreePageAction, BasicTreeUI.TreeToggleAction, BasicTreeUI.TreeTraverseAction, MetalFileChooserUI.DirectoryComboBoxAction, TextAction

public abstract class AbstractAction extends Object implements Action, Cloneable, Serializable

Этот класс предоставляет реализации по умолчанию для интерфейса JFC Action. Здесь определены стандартные действия, например методы получения и установки свойств объекта Action (значок, текст и состояние активности). Разработчику достаточно унаследовать этот абстрактный класс и определить метод actionPerformed.

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

Начиная с версии:

1.2

См. также:

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

Модификатор и тип	Поле	Описание
`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

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

Конструктор	Описание
`AbstractAction()`	Создает `Action`.
`AbstractAction(String name)`	Создает `Action` с указанным именем.
`AbstractAction(String name, Icon icon)`	Создает `Action` с указанным именем и небольшим значком.

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

Модификатор и тип	Метод	Описание
`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

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

accept

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

actionPerformed

Подробное описание полей

enabled

protected boolean enabled

Указывает, активировано ли действие; значение по умолчанию — true.

changeSupport

protected SwingPropertyChangeSupport changeSupport

Если зарегистрированы какие-либо PropertyChangeListeners, поле changeSupport содержит сведения о них.

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

AbstractAction

public AbstractAction()

Создает Action.

AbstractAction

public AbstractAction(String name)

Создает Action с указанным именем.

Параметры:: name — имя (Action.NAME) действия; значение null игнорируется

AbstractAction

public AbstractAction(String name, Icon icon)

Создает Action с указанным именем и небольшим значком.

Параметры:: name — имя (Action.NAME) действия; значение null игнорируется; icon — небольшой значок (Action.SMALL_ICON) действия; значение null игнорируется

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

getValue

public Object getValue(String key)

Получает Object, связанное с указанным ключом.

Определено в:

getValue в интерфейсе Action

Параметры:

key — строка, содержащая указанный key

Возвращает:

связывающее Object, сохраненное с этим ключом; если ключей нет, возвращает null

См. также:

putValue

public void putValue(String key, Object newValue)

Устанавливает Value, связанное с указанным ключом.

Определено в:

putValue в интерфейсе Action

Параметры:

key — String, идентифицирующий сохраненный объект

newValue — Object, сохраняемое с помощью этого ключа

См. также:

isEnabled

public boolean isEnabled()

Возвращает true, если действие активировано.

Определено в:

isEnabled в интерфейсе Action

Возвращает:

true, если действие активировано, иначе false

См. также:

setEnabled

public void setEnabled(boolean newValue)

Устанавливает, активировано ли Action. Значение по умолчанию — true.

Определено в:

setEnabled в интерфейсе Action

Параметры:

newValue — true для активации действия, false для его отключения

См. также:

getKeys

public Object[] getKeys()

Возвращает массив Object, являющихся ключами, для которых заданы значения в этом AbstractAction, или null, если значения не заданы ни для одного ключа.

Возвращает:: массив объектов-ключей или null, если значения не заданы ни для одного ключа
Начиная с версии:: 1.3

firePropertyChange

protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)

Поддерживает уведомление об изменениях связанных свойств. Этот метод можно вызвать при изменении связанного свойства; он отправит соответствующее PropertyChangeEvent всем зарегистрированным PropertyChangeListeners.

Параметры:: propertyName — имя изменившегося свойства; oldValue — старое значение свойства; newValue — новое значение свойства

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Добавляет PropertyChangeListener в список прослушивателей. Прослушиватель регистрируется для всех свойств.

При изменении связанного свойства, например setFont, setBackground или setForeground, будет сгенерировано PropertyChangeEvent. Обратите внимание: если текущий компонент наследует цвет переднего плана, цвет фона или шрифт от контейнера, при изменении унаследованного свойства событие генерироваться не будет.

Определено в:

addPropertyChangeListener в интерфейсе Action

Параметры:

listener — добавляемый PropertyChangeListener

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Удаляет PropertyChangeListener из списка прослушивателей. Удаляется PropertyChangeListener, зарегистрированный для всех свойств.

Определено в:

removePropertyChangeListener в интерфейсе Action

Параметры:

listener — удаляемый PropertyChangeListener

См. также:

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

Возвращает массив всех PropertyChangeListener, добавленных в этот AbstractAction с помощью addPropertyChangeListener().

Возвращает:: все добавленные PropertyChangeListener или пустой массив, если прослушиватели не добавлялись
Начиная с версии:: 1.4

clone

protected Object clone() throws CloneNotSupportedException

Клонирует абстрактное действие. Клон получает собственную копию списка ключей и значений; Object.clone() не выполняет это за вас.

Переопределяет:

clone в классе Object

Возвращает:

клон этого экземпляра.

Выбрасывает:

CloneNotSupportedException — если класс объекта не поддерживает интерфейс Cloneable. Подклассы, переопределяющие метод clone, также могут выбросить это исключение, чтобы указать, что экземпляр нельзя клонировать.

См. также:

© 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/AbstractAction.html