Interface IKeyConfiguration
- All Superinterfaces:
Comparable
An instance of IKeyConfiguration is a handle representing a key
configuration as defined by the extension point
org.eclipse.ui.commands. The identifier of the handle is
identifier of the key configuration being represented.
An instance of IKeyConfiguration can be obtained from an
instance of ICommandManager for any identifier, whether or not a
key configuration 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 key configuration is defined, that
means that its corresponding plug-in is active. If the plug-in is then
deactivated, the configuration will still exist but it will be undefined. An
attempt to use an undefined key configuration will result in a
NotDefinedException being thrown.
This interface is not intended to be extended or implemented by clients.
- Since:
- 3.0
- See Also:
- Restriction:
- This interface is not intended to be implemented by clients.
- Restriction:
- This interface is not intended to be extended by clients.
- Restriction:
- This interface is scheduled for deletion.
-
Method Summary
Modifier and TypeMethodDescriptionvoidaddKeyConfigurationListener(IKeyConfigurationListener keyConfigurationListener) Deprecated.Deprecated.getId()Deprecated.getName()Deprecated.Deprecated.booleanisActive()Deprecated.booleanDeprecated.voidremoveKeyConfigurationListener(IKeyConfigurationListener keyConfigurationListener) Deprecated.Methods inherited from interface java.lang.Comparable
compareTo
-
Method Details
-
addKeyConfigurationListener
Deprecated.Registers an instance ofIKeyConfigurationListenerto listen for changes to attributes of this instance.- Parameters:
keyConfigurationListener- the instance ofIKeyConfigurationListenerto register. Must not benull. If an attempt is made to register an instance ofIKeyConfigurationListenerwhich is already registered with this instance, no operation is performed.
-
getDescription
Deprecated.Returns the description of the key configuration represented by this handle, suitable for display to the user.
Notification is sent to all registered listeners if this attribute changes.
- Returns:
- the description of the key configuration represented by this handle.
Guaranteed not to be
null. - Throws:
NotDefinedException- if the key configuration represented by this handle is not defined.
-
getId
Deprecated.Returns the identifier of this handle.- Returns:
- the identifier of this handle. Guaranteed not to be
null.
-
getName
Deprecated.Returns the name of the key configuration represented by this handle, suitable for display to the user.
Notification is sent to all registered listeners if this attribute changes.
- Returns:
- the name of the key configuration represented by this handle.
Guaranteed not to be
null. - Throws:
NotDefinedException- if the key configuration represented by this handle is not defined.
-
getParentId
Deprecated.Returns the identifier of the parent of the key configuration represented by this handle.
Notification is sent to all registered listeners if this attribute changes.
- Returns:
- the identifier of the parent of the key configuration represented by
this handle. May be
null. - Throws:
NotDefinedException- if the key configuration represented by this handle is not defined.
-
isActive
Deprecated.Returns whether or not this command is active. Instances of
ICommandare activated and deactivated by the instance ofICommandManagerfrom whence they were brokered.Notification is sent to all registered listeners if this attribute changes.
- Returns:
true, iff this command is active.
-
isDefined
Deprecated.Returns whether or not the key configuration represented by this handle is defined.
Notification is sent to all registered listeners if this attribute changes.
- Returns:
true, iff the key configuration represented by this handle is defined.
-
removeKeyConfigurationListener
Deprecated.Unregisters an instance ofIKeyConfigurationListenerlistening for changes to attributes of this instance.- Parameters:
keyConfigurationListener- the instance ofIKeyConfigurationListenerto unregister. Must not benull. If an attempt is made to unregister an instance ofIKeyConfigurationListenerwhich is not already registered with this instance, no operation is performed.
-