org.jdesktop.swingx.action
Class TargetableAction

java.lang.Object
  extended by javax.swing.AbstractAction
      extended by org.jdesktop.swingx.action.AbstractActionExt
          extended by org.jdesktop.swingx.action.TargetableAction
All Implemented Interfaces:
ActionListener, ItemListener, Serializable, Cloneable, EventListener, Action

public class TargetableAction
extends AbstractActionExt

A class that represents a dynamically targetable action. The invocation of this action will be dispatched to the TargetManager instance.

You would create instances of this class to let the TargetManager handle the action invocations from the ui components constructed with this action. The TargetManager could be configured depending on application state to handle these actions.

See Also:
TargetManager, Serialized Form

Field Summary
 
Fields inherited from class org.jdesktop.swingx.action.AbstractActionExt
GROUP, IS_STATE, LARGE_ICON
 
Fields inherited from class javax.swing.AbstractAction
changeSupport, enabled
 
Fields inherited from interface javax.swing.Action
ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SHORT_DESCRIPTION, SMALL_ICON
 
Constructor Summary
TargetableAction()
           
TargetableAction(String name)
           
TargetableAction(String name, Icon icon)
           
TargetableAction(String name, String command)
           
TargetableAction(String name, String command, Icon icon)
           
 
Method Summary
 void actionPerformed(ActionEvent evt)
          Callback for command actions.
 TargetManager getTargetManager()
          Returns the target manager instance which will be used for action dispatch.
 void itemStateChanged(ItemEvent evt)
          Callback for toggle actions.
 void setTargetManager(TargetManager tm)
          Set target manager which will handle this command.
 String toString()
          Returns a string representation of the object.
 
Methods inherited from class org.jdesktop.swingx.action.AbstractActionExt
dispose, getAccelerator, getActionCommand, getGroup, getLargeIcon, getLongDescription, getMnemonic, getName, getShortDescription, getSmallIcon, isSelected, isStateAction, setAccelerator, setActionCommand, setGroup, setLargeIcon, setLongDescription, setMnemonic, setMnemonic, setName, setSelected, setShortDescription, setSmallIcon, setStateAction, setStateAction
 
Methods inherited from class javax.swing.AbstractAction
addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

TargetableAction

public TargetableAction()

TargetableAction

public TargetableAction(String name)

TargetableAction

public TargetableAction(String name,
                        String command)
Parameters:
name - display name of the action
command - the value of the action command key

TargetableAction

public TargetableAction(String name,
                        String command,
                        Icon icon)
Parameters:
name - display name of the action
command - the value of the action command key
icon - icon to display

TargetableAction

public TargetableAction(String name,
                        Icon icon)
Method Detail

setTargetManager

public void setTargetManager(TargetManager tm)
Set target manager which will handle this command. This action may be reset to use the singleton instance if set to null.

Parameters:
tm - the target manager instance to dispatch the actions

getTargetManager

public TargetManager getTargetManager()
Returns the target manager instance which will be used for action dispatch. If the target manager has not previously been set then the singleton instance will be returned.

Returns:
a non null target manager

actionPerformed

public void actionPerformed(ActionEvent evt)
Callback for command actions. This event will be redispatched to the target manager along with the value of the Action.ACTION_COMMAND_KEY

Parameters:
evt - event which will be forwarded to the TargetManager
See Also:
TargetManager

itemStateChanged

public void itemStateChanged(ItemEvent evt)
Callback for toggle actions. This event will be redispatched to the target manager along with value of the the Action.ACTION_COMMAND_KEY

Specified by:
itemStateChanged in interface ItemListener
Overrides:
itemStateChanged in class AbstractActionExt
Parameters:
evt - event which will be forwarded to the TargetManager
See Also:
TargetManager

toString

public String toString()
Description copied from class: java.lang.Object
Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Overrides:
toString in class AbstractActionExt
Returns:
a string representation of the object.