javax.swing

Действие интерфейса

Все Суперинтерфейсы:

ActionListener, EventListener

Все Известные Классы с реализацией:

AbstractAction, 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, DefaultEditorKit. BeepAction, DefaultEditorKit. CopyAction, DefaultEditorKit. CutAction, DefaultEditorKit. DefaultKeyTypedAction, DefaultEditorKit. InsertBreakAction, DefaultEditorKit. InsertContentAction, DefaultEditorKit. InsertTabAction, DefaultEditorKit. PasteAction, HTMLEditorKit. HTMLTextAction, HTMLEditorKit. InsertHTMLTextAction, MetalFileChooserUI.DirectoryComboBoxAction, StyledEditorKit. AlignmentAction, StyledEditorKit. BoldAction, StyledEditorKit. FontFamilyAction, StyledEditorKit. FontSizeAction, StyledEditorKit. ForegroundAction, StyledEditorKit. ItalicAction, StyledEditorKit. StyledTextAction, StyledEditorKit. UnderlineAction, TextAction

public interface Action
extends ActionListener

Action интерфейс обеспечивает полезное расширение ActionListener интерфейс в случаях, где к той же самой функциональности могут получить доступ несколько средств управления.

В дополнение к actionPerformed метод, определенный ActionListener интерфейс, этот интерфейс позволяет приложению определять в единственном месте:

• Одна или более текстовых строк, которые описывают функцию. Эти строки могут использоваться, например, чтобы вывести на экран текст эстакады для кнопки или установить текст в пункте меню.
• Один или более значков, которые изображают функцию. Эти значки могут использоваться для изображений в управлении меню, или для составных записей в более сложном пользовательском интерфейсе.
• Включенное/нерабочее состояние из функциональности. Вместо того, чтобы иметь необходимость отдельно отключить пункт меню и кнопку на панели инструментов, приложение может отключить функцию, которая реализует этот интерфейс. Все компоненты, которые регистрируются как слушатели для изменения состояния тогда, знают, чтобы отключить генерацию события для того элемента и изменить дисплей соответственно.

Этот интерфейс может быть добавлен к существующему class или использоваться, чтобы создать адаптер (обычно, разделяя на подклассы AbstractAction). Action объект может тогда быть добавлен к многократному Action- осведомленные контейнеры и соединенный с Action- способные компоненты. Средства управления GUI могут тогда быть активированы или деактивированы внезапно, вызывая Action объект setEnabled метод.

Отметьте это Action реализации имеют тенденцию быть более дорогими с точки зрения хранения чем типичное ActionListener, который не предлагает преимущества централизованного управления функциональности и широковещательной передачи изменений свойства. Поэтому следует заботиться только использованию Actions, где их преимущества требуются, и используют простой ActionListeners в другом месте.

Компонентная Поддержка Swing Action

Многие из компонентов Swing имеют Action свойство. Когда Action устанавливается на компоненте, следующие вещи происходят:

• Action добавляется как ActionListener к компоненту.
• Компонент конфигурирует некоторые из своих свойств, чтобы соответствовать Action.
• Компонент устанавливает a PropertyChangeListener на Action так, чтобы компонент мог изменить свои свойства, чтобы отразить изменения в Action's свойства.

Следующая таблица описывает свойства, используемые Swing компоненты та поддержка Actions. В таблице кнопка обращается к любому AbstractButton подкласс, который включает не только JButton но также и классы такой как JMenuItem. Если иначе не утверждено, a null значение свойства в Action (или a Action это null) результаты в соответствующем свойстве кнопки, устанавливаемом в null.

Компонентное Свойство	Компоненты	Ключ действия	Примечания
enabled	Все	isEnabled метод
toolTipText	Все	SHORT_DESCRIPTION
actionCommand	Все	ACTION_COMMAND_KEY
mnemonic	Все кнопки	MNEMONIC_KEY	A null значение или Action результаты в кнопке mnemonic свойство, устанавливаемое в '\0'.
text	Все кнопки	NAME	Если Вы не хотите, чтобы текст кнопки зеркально отразил тот из Action, установите свойство hideActionText к true. Если hideActionText true, установка Action изменяет текст кнопки к null и любые изменения к NAME игнорируются. hideActionText полезно для кнопок на панели инструментов, которые обычно только показывают Icon. JToolBar.add(Action) устанавливает свойство в true если Action имеет не -null значение для LARGE_ICON_KEY или SMALL_ICON.
displayedMnemonicIndex	Все кнопки	DISPLAYED_MNEMONIC_INDEX_KEY	Если значение DISPLAYED_MNEMONIC_INDEX_KEY вне границ текста, он игнорируется. Когда setAction вызывается, если значение от Action null, выведенная на экран мнемосхема индексирует, не обновляется. В любых последующих изменениях к DISPLAYED_MNEMONIC_INDEX_KEY, null обрабатывается как-1.
icon	Все кнопки кроме JCheckBox, JToggleButton и JRadioButton.	также LARGE_ICON_KEY или SMALL_ICON	JMenuItem подклассы только используют SMALL_ICON. Все другие кнопки будут использовать LARGE_ICON_KEY; если значение null они используют SMALL_ICON.
accelerator	Все JMenuItem подклассы, за исключением JMenu.	ACCELERATOR_KEY
selected	JToggleButton, JCheckBox, JRadioButton, JCheckBoxMenuItem и JRadioButtonMenuItem	SELECTED_KEY	Компоненты, которые соблюдают это свойство только, используют значение, если это non-null. Например, если Вы устанавливаете Action у этого есть a null значение для SELECTED_KEY на a JToggleButton, JToggleButton не будет обновлять это выбрало состояние всегда. Точно так же любое время JToggleButton's выбранные изменения состояния это только задержит значение на Action если Action имеет a non-null значение для SELECTED_KEY. Компоненты, которые соблюдают это свойство, сохраняют свое выбранное состояние в синхронизации с этим свойством. Когда то же самое Action используется с многократными компонентами, все компоненты сохраняют свое выбранное состояние в синхронизации с этим свойством. Взаимоисключающие кнопки, такой как JToggleButtons в a ButtonGroup, вынудите только одну из кнопок быть выбранной. Также, не используйте то же самое Action это определяет значение для SELECTED_KEY свойство с многократными взаимоисключающими кнопками.

JPopupMenu, JToolBar и JMenu все обеспечивают методы удобства для того, чтобы они создали компонент и установили Action на соответствующем компоненте. Обратитесь к каждому из этих классов для получения дополнительной информации.

Action использование PropertyChangeListener сообщать слушателям Action изменился. Бобовая спецификация указывает на это a null имя свойства может использоваться, чтобы указать, что многократные значения изменились. По умолчанию компоненты Swing, которые берут Action не обрабатывайте такое изменение. Указать, что Swing должен обработать null согласно бобовому набору спецификации системное свойство swing.actions.reconfigureOnNull к String значение true.

См. Также:

AbstractAction

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static String	ACCELERATOR_KEY Ключ, используемый для того, чтобы сохранить a KeyStroke использоваться в качестве акселератора для действия.
static String	ACTION_COMMAND_KEY Ключ, используемый, чтобы определить команду String для ActionEvent это будет создаваться когда Action собирается быть уведомленным как результат нахожения в a Keymap связанный с a JComponent.
static String	ЗНАЧЕНИЕ ПО УМОЛЧАНИЮ Не в настоящий момент используемый.
static String	DISPLAYED_MNEMONIC_INDEX_KEY Ключ, используемый для того, чтобы сохранить Integer это соответствует индексированию в тексте (идентифицированный NAME свойство), в котором должно быть представлено художественное оформление для мнемосхемы.
static String	LARGE_ICON_KEY Ключ, используемый для того, чтобы сохранить Icon.
static String	LONG_DESCRIPTION Ключ, используемый для того, чтобы сохранить более длинное String описание для действия, мог использоваться для контекстно-зависимой справки.
static String	MNEMONIC_KEY Ключ, используемый для того, чтобы сохранить Integer это соответствует одному из KeyEvent коды клавиши.
static String	ИМЯ Ключ, используемый для того, чтобы сохранить String имя для действия, используемого для меню или кнопки.
static String	SELECTED_KEY Ключ, используемый для того, чтобы сохранить a Boolean это соответствует выбранному состоянию.
static String	SHORT_DESCRIPTION Ключ, используемый для того, чтобы сохранить короткое String описание для действия, используемого для текста подсказки.
static String	SMALL_ICON Ключ, используемый для того, чтобы сохранить маленькое Icon, такой как ImageIcon.

Сводка метода

Модификатор и Тип	Метод и Описание
void	addPropertyChangeListener(PropertyChangeListener listener) Добавляет a PropertyChange слушатель.
Объект	getValue(String key) Получает одно из свойств этого объекта, используя связанный ключ.
boolean	isEnabled() Возвращает включенное состояние Action.
void	putValue(String key, Object value) Наборы одно из свойств этого объекта, используя связанный ключ.
void	removePropertyChangeListener(PropertyChangeListener listener) Удаляет a PropertyChange слушатель.
void	setEnabled(boolean b) Устанавливает включенное состояние Action.

Методы, наследованные от интерфейса java.awt.event. ActionListener

actionPerformed

Полевая Деталь

ЗНАЧЕНИЕ ПО УМОЛЧАНИЮ

static final String DEFAULT

Не в настоящий момент используемый.

См. Также:

Постоянные Значения полей

ИМЯ

static final String NAME

Ключ, используемый для того, чтобы сохранить String имя для действия, используемого для меню или кнопки.

См. Также:

Постоянные Значения полей

SHORT_DESCRIPTION

static final String SHORT_DESCRIPTION

Ключ, используемый для того, чтобы сохранить короткое String описание для действия, используемого для текста подсказки.

См. Также:

Постоянные Значения полей

LONG_DESCRIPTION

static final String LONG_DESCRIPTION

Ключ, используемый для того, чтобы сохранить более длинное String описание для действия, мог использоваться для контекстно-зависимой справки.

См. Также:

Постоянные Значения полей

SMALL_ICON

static final String SMALL_ICON

Ключ, используемый для того, чтобы сохранить маленькое Icon, такой как ImageIcon. Это обычно используется с меню такой как JMenuItem.

Если то же самое Action используется с меню и кнопками, Вы будете обычно определять обоих a SMALL_ICON и a LARGE_ICON_KEY. Меню будет использовать SMALL_ICON и кнопка будет использовать LARGE_ICON_KEY.

См. Также:

Постоянные Значения полей

ACTION_COMMAND_KEY

static final String ACTION_COMMAND_KEY

Ключ, используемый, чтобы определить команду String для ActionEvent это будет создаваться когда Action собирается быть уведомленным как результат нахожения в a Keymap связанный с a JComponent.

См. Также:

Постоянные Значения полей

ACCELERATOR_KEY

static final String ACCELERATOR_KEY

Ключ, используемый для того, чтобы сохранить a KeyStroke использоваться в качестве акселератора для действия.

С тех пор:

1.3

См. Также:

Постоянные Значения полей

MNEMONIC_KEY

static final String MNEMONIC_KEY

Ключ, используемый для того, чтобы сохранить Integer это соответствует одному из KeyEvent коды клавиши. Значение обычно используется, чтобы определить мнемосхему. Например: myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.VK_A) устанавливает мнемосхему myAction к, в то время как myAction.putValue(Action.MNEMONIC_KEY, KeyEvent.getExtendedKeyCodeForChar('?')) устанавливает мнемосхему myAction к Кириллической букве "Ef".

С тех пор:

1.3

См. Также:

Постоянные Значения полей

SELECTED_KEY

static final String SELECTED_KEY

Ключ, используемый для того, чтобы сохранить a Boolean это соответствует выбранному состоянию. Это обычно используется только для компонентов, у которых есть значимое состояние выбора. Например, JRadioButton и JCheckBox используйте это, но экземпляры JMenu не делать.

Это свойство отличается от других, в которых оно и читается компонентом и набором компонентом. Например, если Action присоединен к a JCheckBox выбранное состояние JCheckBox будет установлен от того из Action. Если пользователь щелкает JCheckBox выбранное состояние JCheckBox и Action будет оба обновлен.

Отметьте: значение этого поля снабжается префиксом 'Swing', чтобы избежать возможных коллизий с существующим Actions.

С тех пор:

1.6

См. Также:

Постоянные Значения полей

DISPLAYED_MNEMONIC_INDEX_KEY

static final String DISPLAYED_MNEMONIC_INDEX_KEY

Ключ, используемый для того, чтобы сохранить Integer это соответствует индексированию в тексте (идентифицированный NAME свойство), в котором должно быть представлено художественное оформление для мнемосхемы. Если значение этого свойства будет больше чем или равным длине текста, то это будет обработанный как-1.

Отметьте: значение этого поля снабжается префиксом 'Swing', чтобы избежать возможных коллизий с существующим Actions.

С тех пор:

1.6

См. Также:

AbstractButton.setDisplayedMnemonicIndex(int), Постоянные Значения полей

LARGE_ICON_KEY

static final String LARGE_ICON_KEY

Ключ, используемый для того, чтобы сохранить Icon. Это обычно используется кнопками, такой как JButton и JToggleButton.

Если то же самое Action используется с меню и кнопками, Вы будете обычно определять обоих a SMALL_ICON и a LARGE_ICON_KEY. Меню будет использовать SMALL_ICON и кнопка LARGE_ICON_KEY.

Отметьте: значение этого поля снабжается префиксом 'Swing', чтобы избежать возможных коллизий с существующим Actions.

С тех пор:

1.6

См. Также:

Постоянные Значения полей

Деталь метода

getValue

Object getValue(String key)

Получает одно из свойств этого объекта, используя связанный ключ.

См. Также:

putValue(java.lang.String, java.lang.Object)

putValue

void putValue(String key,
              Object value)

Наборы одно из свойств этого объекта, используя связанный ключ. Если значение изменилось, a PropertyChangeEvent отправляется слушателям.

Параметры:

key - a String содержа ключ

value - Object значение

setEnabled

void setEnabled(boolean b)

Устанавливает включенное состояние Action. Когда включено, любой компонент, связанный с этим объектом, является активным и в состоянии запустить этот объект actionPerformed метод. Если значение изменилось, a PropertyChangeEvent отправляется слушателям.

Параметры:

b - истина, чтобы включить этому Action, ложь, чтобы отключить это

isEnabled

boolean isEnabled()

Возвращает включенное состояние Action. Когда включено, любой компонент, связанный с этим объектом, является активным и в состоянии запустить этот объект actionPerformed метод.

Возвраты:

истина, если это Action включается

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener listener)

Добавляет a PropertyChange слушатель. Контейнеры и присоединенные компоненты используют эти методы, чтобы зарегистрировать интерес к этому Action объект. Когда его включенное состояние или другие изменения свойства, зарегистрированным слушателям сообщают об изменении.

Параметры:

listener - a PropertyChangeListener объект

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener listener)

Удаляет a PropertyChange слушатель.

Параметры:

listener - a PropertyChangeListener объект

См. Также:

addPropertyChangeListener(java.beans.PropertyChangeListener)