org.jdesktop.swingx.action
Class TargetableAction

java.lang.Object
  javax.swing.AbstractAction
      org.jdesktop.swingx.action.AbstractActionExt
          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.