Package docking.actions

Class ToolActions

java.lang.Object

docking.actions.ToolActions

All Implemented Interfaces:

DockingToolActions, java.beans.PropertyChangeListener, java.util.EventListener

public class ToolActions
extends java.lang.Object
implements DockingToolActions, java.beans.PropertyChangeListener

An class to manage actions registered with the tool

Constructor Summary

Constructors

Constructor	Description
ToolActions(Tool tool, ActionToGuiHelper actionToGuiHelper)	Construct an ActionManager

Method Summary

Modifier and Type	Method	Description
void	addGlobalAction(DockingActionIf action)	Adds the given action that is enabled, regardless of the active provider
void	addLocalAction(ComponentProvider provider, DockingActionIf action)	Add an action that works specifically with a component provider.
void	dispose()
javax.swing.Action	getAction(javax.swing.KeyStroke ks)
java.util.Set<DockingActionIf>	getActions(java.lang.String owner)	Returns all actions with the given owner
java.util.Set<DockingActionIf>	getAllActions()	Returns all actions known to the tool
DockingActionIf	getLocalAction(ComponentProvider provider, java.lang.String actionName)	Gets the provider action by the given name
void	propertyChange(java.beans.PropertyChangeEvent evt)
void	registerSharedActionPlaceholder(SharedDockingActionPlaceholder placeholder)	Allows clients to register an action by using a placeholder.
void	removeActions(ComponentProvider provider)	Removes all local actions for the given provider
void	removeActions(java.lang.String owner)	Removes all global actions for the given owner
void	removeGlobalAction(DockingActionIf action)	Removes the given global action
void	removeLocalAction(ComponentProvider provider, DockingActionIf action)	Remove an action that works specifically with a component provider.
void	restoreKeyBindings()	Get the keybindings for each action so that they are still registered as being used; otherwise the options will be removed because they are noted as not being used.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ToolActions

public ToolActions(Tool tool,
                   ActionToGuiHelper actionToGuiHelper)

Construct an ActionManager

Parameters:

tool - tool using this ActionManager

actionToGuiHelper - the class that takes actions and maps them to GUI widgets

Method Detail

dispose

public void dispose()

addLocalAction

public void addLocalAction(ComponentProvider provider,
                           DockingActionIf action)

Add an action that works specifically with a component provider.

Specified by:

addLocalAction in interface DockingToolActions

Parameters:

provider - provider associated with the action

action - local action to the provider

addGlobalAction

public void addGlobalAction(DockingActionIf action)

Description copied from interface: DockingToolActions

Adds the given action that is enabled, regardless of the active provider

Specified by:

addGlobalAction in interface DockingToolActions

Parameters:

action - the action

removeGlobalAction

public void removeGlobalAction(DockingActionIf action)

Description copied from interface: DockingToolActions

Removes the given global action

Specified by:

removeGlobalAction in interface DockingToolActions

Parameters:

action - the action

removeActions

public void removeActions(java.lang.String owner)

Description copied from interface: DockingToolActions

Removes all global actions for the given owner

Specified by:

removeActions in interface DockingToolActions

Parameters:

owner - the owner

getActions

public java.util.Set<DockingActionIf> getActions(java.lang.String owner)

Description copied from interface: DockingToolActions

Returns all actions with the given owner

Specified by:

getActions in interface DockingToolActions

Parameters:

owner - the owner

Returns:

the actions

getAllActions

public java.util.Set<DockingActionIf> getAllActions()

Description copied from interface: DockingToolActions

Returns all actions known to the tool

Specified by:

getAllActions in interface DockingToolActions

Returns:

the actions

restoreKeyBindings

public void restoreKeyBindings()

Get the keybindings for each action so that they are still registered as being used; otherwise the options will be removed because they are noted as not being used.

removeLocalAction

public void removeLocalAction(ComponentProvider provider,
                              DockingActionIf action)

Remove an action that works specifically with a component provider.

Specified by:

removeLocalAction in interface DockingToolActions

Parameters:

provider - provider associated with the action

action - local action to the provider

removeActions

public void removeActions(ComponentProvider provider)

Description copied from interface: DockingToolActions

Removes all local actions for the given provider

Specified by:

removeActions in interface DockingToolActions

Parameters:

provider - the provider

propertyChange

public void propertyChange(java.beans.PropertyChangeEvent evt)

Specified by:

propertyChange in interface java.beans.PropertyChangeListener

getLocalAction

public DockingActionIf getLocalAction(ComponentProvider provider,
                                      java.lang.String actionName)

Description copied from interface: DockingToolActions

Gets the provider action by the given name

Specified by:

getLocalAction in interface DockingToolActions

Parameters:

provider - the provider

actionName - the action name

Returns:

the action

getAction

public javax.swing.Action getAction(javax.swing.KeyStroke ks)

registerSharedActionPlaceholder

public void registerSharedActionPlaceholder(SharedDockingActionPlaceholder placeholder)

Allows clients to register an action by using a placeholder. This is useful when an API wishes to have a central object (like a plugin) register actions for transient providers, that may not be loaded until needed.

This method may be called multiple times with the same conceptual placeholder--the placeholder will only be added once.

Specified by:

registerSharedActionPlaceholder in interface DockingToolActions

Parameters:

placeholder - the placeholder containing information related to the action it represents