charvax.swing
Class AbstractAction
java.lang.Objectcharvax.swing.AbstractAction
- Action, ActionListener, Cloneable, EventListener, Serializable
public abstract class AbstractAction
extends java.lang.Object
implements Action, Cloneable, Serializable
This class provides default implementations for the JFC
Action
interface. Standard behaviors like the get and set methods for
Action object properties (icon, text, and enabled) are defined
here. The developer need only subclass this abstract class and
define the
actionPerformed method.
Warning:
Serialized objects of this class will not be compatible with
future Swing releases. The current serialization support is
appropriate for short term storage or RMI between applications running
the same version of Swing. As of 1.4, support for long term storage
of all JavaBeans
TM
has been added to the
java.beans package.
Please see
java.beans.XMLEncoder.
AbstractAction()- Defines an
Action object with a default
description string and default icon.
|
AbstractAction(String name)- Defines an
Action object with the specified
description string and a default icon.
|
AbstractAction(String name, Icon icon)- Defines an
Action object with the specified
description string and a the specified icon.
|
void | addPropertyChangeListener(PropertyChangeListener listener)- Adds a
PropertyChangeListener to the listener list.
|
protected Object | clone()- Clones the abstract action.
|
protected void | firePropertyChange(String propertyName, Object oldValue, Object newValue)- Supports reporting bound property changes.
|
Object[] | getKeys()- Returns an array of
Objects which are keys for
which values have been set for this AbstractAction,
or null if no keys have values set.
|
PropertyChangeListener[] | getPropertyChangeListeners()- Returns an array of all the
PropertyChangeListeners added
to this AbstractAction with addPropertyChangeListener().
|
Object | getValue(String key)- Gets the
Object associated with the specified key.
|
boolean | isEnabled()- Returns true if the action is enabled.
|
void | putValue(String key, Object newValue)- Sets the
Value associated with the specified key.
|
void | removePropertyChangeListener(PropertyChangeListener listener)- Removes a
PropertyChangeListener from the listener list.
|
void | setEnabled(boolean newValue)- Enables or disables the action.
|
changeSupport
protected SwingPropertyChangeSupport changeSupport
If any PropertyChangeListeners have been registered, the
changeSupport field describes them.
enabled
protected boolean enabled
Specifies whether action is enabled; the default is true.
AbstractAction
public AbstractAction()
Defines an Action object with a default
description string and default icon.
AbstractAction
public AbstractAction(String name)
Defines an Action object with the specified
description string and a default icon.
AbstractAction
public AbstractAction(String name,
Icon icon) Defines an Action object with the specified
description string and a the specified icon.
addPropertyChangeListener
public void addPropertyChangeListener(PropertyChangeListener listener)
Adds a
PropertyChangeListener to the listener list.
The listener is registered for all properties.
A
PropertyChangeEvent will get fired in response to setting
a bound property, e.g.
setFont,
setBackground,
or
setForeground.
Note that if the current component is inheriting its foreground,
background, or font from its container, then no event will be
fired in response to a change in the inherited property.
- addPropertyChangeListener in interface Action
listener - The PropertyChangeListener to be added
clone
protected Object clone()
throws CloneNotSupportedException Clones the abstract action. This gives the clone
its own copy of the key/value list,
which is not handled for you by Object.clone().
firePropertyChange
protected void firePropertyChange(String propertyName,
Object oldValue,
Object newValue) Supports reporting bound property changes. This method can be called
when a bound property has changed and it will send the appropriate
PropertyChangeEvent to any registered
PropertyChangeListeners.
getKeys
public Object[] getKeys()
Returns an array of Objects which are keys for
which values have been set for this AbstractAction,
or null if no keys have values set.
- an array of key objects, or
null if no
keys have values set
getPropertyChangeListeners
public PropertyChangeListener[] getPropertyChangeListeners()
Returns an array of all the PropertyChangeListeners added
to this AbstractAction with addPropertyChangeListener().
- all of the
PropertyChangeListeners added or an empty
array if no listeners have been added
getValue
public Object getValue(String key)
Gets the Object associated with the specified key.
- getValue in interface Action
key - a string containing the specified key
- the binding
Object stored with this key; if there
are no keys, it will return null
isEnabled
public boolean isEnabled()
Returns true if the action is enabled.
- isEnabled in interface Action
- true if the action is enabled, false otherwise
putValue
public void putValue(String key,
Object newValue) Sets the Value associated with the specified key.
- putValue in interface Action
key - the String that identifies the stored objectnewValue - the Object to store using this key
removePropertyChangeListener
public void removePropertyChangeListener(PropertyChangeListener listener)
Removes a PropertyChangeListener from the listener list.
This removes a PropertyChangeListener that was registered
for all properties.
- removePropertyChangeListener in interface Action
listener - the PropertyChangeListener to be removed
setEnabled
public void setEnabled(boolean newValue)
Enables or disables the action.
- setEnabled in interface Action
newValue - true to enable the action, false to
disable it