@Deprecated public interface ICommand extends Comparable
An instance of ICommand
is a handle representing a command as
defined by the extension point org.eclipse.ui.commands
. The
identifier of the handle is identifier of the command being represented.
An instance of ICommand
can be obtained from an instance of
ICommandManager
for any identifier, whether or not a command
with that identifier defined in the plugin registry.
The handle-based nature of this API allows it to work well with runtime
plugin activation and deactivation. If a command is defined, that means that
its corresponding plug-in is active. If the plug-in is then deactivated, the
command will still exist but it will be undefined. An attempts to use an
undefined command will result in a NotDefinedException
being
thrown.
This interface is not intended to be extended or implemented by clients.
ICommandListener
,
ICommandManager
,
Command
Modifier and Type | Method and Description |
---|---|
void |
addCommandListener(ICommandListener commandListener)
Deprecated.
|
Object |
execute(Map parameterValuesByName)
Deprecated.
|
Map |
getAttributeValuesByName()
Deprecated.
|
String |
getCategoryId()
Deprecated.
|
String |
getDescription()
Deprecated.
|
String |
getId()
Deprecated.
|
List |
getKeySequenceBindings()
Deprecated.
Returns the list of key sequence bindings for this handle.
|
String |
getName()
Deprecated.
|
boolean |
isDefined()
Deprecated.
|
boolean |
isHandled()
Deprecated.
|
void |
removeCommandListener(ICommandListener commandListener)
Deprecated.
|
compareTo
@Deprecated void addCommandListener(ICommandListener commandListener)
ICommandListener
to listen for
changes to attributes of this instance.commandListener
- the instance of ICommandListener
to register.
Must not be null
. If an attempt is made to
register an instance of ICommandListener
which
is already registered with this instance, no operation is
performed.@Deprecated Object execute(Map parameterValuesByName) throws ExecutionException, NotHandledException
parameterValuesByName
- the map of parameter values by name. Reserved for future use,
must be null
.null
.ExecutionException
- if an exception occurred during execution.NotHandledException
- if this is not handled.@Deprecated Map getAttributeValuesByName() throws NotHandledException
Notification is sent to all registered listeners if this property changes.
null
. If this map is not
empty, its collection of keys is guaranteed to only contain
instances of String
.NotHandledException
- if this is not handled.@Deprecated String getCategoryId() throws NotDefinedException
Returns the identifier of the category of the command represented by this handle.
Notification is sent to all registered listeners if this attribute changes.
null
.NotDefinedException
- if the command represented by this handle is not defined.@Deprecated String getDescription() throws NotDefinedException
Returns the description of the command represented by this handle, suitable for display to the user.
Notification is sent to all registered listeners if this attribute changes.
null
.NotDefinedException
- if the command represented by this handle is not defined.@Deprecated String getId()
null
.List getKeySequenceBindings()
Returns the list of key sequence bindings for this handle. This method will return all key sequence bindings for this handle's identifier, whether or not the command represented by this handle is defined.
Notification is sent to all registered listeners if this attribute changes.
null
. If this list is not
empty, it is guaranteed to only contain instances of
IKeySequenceBinding
.@Deprecated String getName() throws NotDefinedException
Returns the name of the command represented by this handle, suitable for display to the user.
Notification is sent to all registered listeners if this attribute changes.
null
.NotDefinedException
- if the command represented by this handle is not defined.@Deprecated boolean isDefined()
Returns whether or not the command represented by this handle is defined.
Notification is sent to all registered listeners if this attribute changes.
true
, iff the command represented by this handle
is defined.@Deprecated boolean isHandled()
Returns whether or not this command is handled. A command is handled if
it currently has an IHandler
instance associated with it.
A command needs a handler to carry out the execute(Map)
method.
Notification is sent to all registered listeners if this attribute changes.
true
, iff this command is enabled.@Deprecated void removeCommandListener(ICommandListener commandListener)
ICommandListener
listening for
changes to attributes of this instance.commandListener
- the instance of ICommandListener
to unregister.
Must not be null
. If an attempt is made to
unregister an instance of ICommandListener
which is not already registered with this instance, no
operation is performed.
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.