Package org.eclipse.jface.action

Class ExternalActionManager

java.lang.Object

org.eclipse.jface.action.ExternalActionManager

public final class ExternalActionManager
extends Object

A manager for a callback facility which is capable of querying external interfaces for additional information about actions and action contribution items. This information typically includes things like accelerators and textual representations.

It is only necessary to use this mechanism if you will be using a mix of actions and commands, and wish the interactions to work properly.

For example, in the Eclipse workbench, this mechanism is used to allow the command architecture to override certain values in action contribution items.

This class is not intended to be called or extended by any external clients.

Since:

3.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ExternalActionManager.CommandCallback	A simple implementation of the ICallback mechanism that simply takes a BindingManager and a CommandManager.
static interface	ExternalActionManager.IActiveChecker	Defines a callback mechanism for developer who wish to further control the visibility of legacy action-based contribution items.
static interface	ExternalActionManager.IBindingManagerCallback	A callback which communicates with the applications binding manager.
static interface	ExternalActionManager.ICallback	A callback mechanism for some external tool to communicate extra information to actions and action contribution items.
static interface	ExternalActionManager.IExecuteApplicable	An overridable mechanism to filter certain IActions from the execution bridge.
static interface	ExternalActionManager.IExecuteCallback	A callback for executing execution events.

Method Summary

Modifier and Type	Method	Description
ExternalActionManager.ICallback	getCallback()	An accessor for the current call back.
static ExternalActionManager	getInstance()	Retrieves the current singleton instance of this class.
void	setCallback(ExternalActionManager.ICallback callbackToUse)	A mutator for the current call back

Methods inherited from class java.lang.Object

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

Method Details

getInstance

public static ExternalActionManager getInstance()

Retrieves the current singleton instance of this class.

Returns:

The singleton instance; this value is never null.

getCallback

public ExternalActionManager.ICallback getCallback()

An accessor for the current call back.

Returns:

The current callback mechanism being used. This is the callback that should be queried for extra information about actions and action contribution items. This value may be null if there is no extra information.

setCallback

public void setCallback(ExternalActionManager.ICallback callbackToUse)

A mutator for the current call back

Parameters:

callbackToUse - The new callback mechanism to use; this value may be null if the default is acceptable (i.e., no extra information will provided to actions).