Класс 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

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

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

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

Модификатор и тип	Метод	Описание
`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()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного времени.

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

accept

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

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

actionPerformed

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

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

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 в список слушателей. Слушатель регистрируется для всех свойств.

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

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

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.