public interface ISources
A source is type of event change that can occur within the workbench. For example, the active workbench window can change, so it is considered a source. Workbench services can track changes to these sources, and thereby try to resolve conflicts between a variety of possible options. This is most commonly used for things like handlers and contexts.
This interface defines the source that are known to the workbench at
compile-time. These sources can be combined in a bit-wise fashion. So, for
example, a ACTIVE_PART | ACTIVE_CONTEXT
source includes change
to both the active context and the active part.
The values assigned to each source indicates its relative priority. The
higher the value, the more priority the source is given in resolving
conflicts. Another way to look at this is that the higher the value, the more
"local" the source is to what the user is currently doing. This is similar
to, but distinct from the concept of components. The nesting support provided
by components represent only one source (ACTIVE_SITE
) that
the workbench understands.
Note that for backward compatibility, we must reserve the lowest three bits
for Priority
instances using the old
HandlerSubmission
mechanism. This mechanism was used in
Eclipse 3.0.
Note in 3.3:
Currently, source variables are not extensible by user plugins, and the number of bits available for resolving conflicts is limited. When the variable sources become user extensible a new conflict resolution mechanism will be implemented.
ISourceProvider
Modifier and Type | Field and Description |
---|---|
static int |
ACTIVE_ACTION_SETS
The priority given when the source includes a particular action set.
|
static String |
ACTIVE_ACTION_SETS_NAME
The variable name for the active action sets.
|
static int |
ACTIVE_CONTEXT
The priority given when the source includes a particular context.
|
static String |
ACTIVE_CONTEXT_NAME
The variable name for the active contexts.
|
static int |
ACTIVE_CURRENT_SELECTION
The priority given when the source includes the current selection.
|
static String |
ACTIVE_CURRENT_SELECTION_NAME
The variable name for the active selection.
|
static int |
ACTIVE_EDITOR
The priority given when the source includes the active editor part.
|
static int |
ACTIVE_EDITOR_ID
The priority given when the source includes the active editor identifier.
|
static String |
ACTIVE_EDITOR_ID_NAME
The variable name for the active editor identifier.
|
static String |
ACTIVE_EDITOR_INPUT_NAME
The editor input of the currently active editor.
|
static String |
ACTIVE_EDITOR_NAME
The variable name for the active editor part.
|
static String |
ACTIVE_FOCUS_CONTROL_ID_NAME
The variable name for the active focus Control id, when provided by the
IFocusService.
|
static String |
ACTIVE_FOCUS_CONTROL_NAME
The variable name for the active focus Control, when provided by the
IFocusService.
|
static int |
ACTIVE_MENU
The priority given when the source includes the current menu.
|
static String |
ACTIVE_MENU_EDITOR_INPUT_NAME
The variable name for the local editor input which is sometimes
available while a context menu is visible.
|
static String |
ACTIVE_MENU_NAME
The variable name for the active menu.
|
static String |
ACTIVE_MENU_SELECTION_NAME
The variable name for the local selection, available while a
context menu is visible.
|
static int |
ACTIVE_PART
The priority given when the source includes the active part.
|
static int |
ACTIVE_PART_ID
The priority given when the source includes the active part id.
|
static String |
ACTIVE_PART_ID_NAME
The variable name for the active part id.
|
static String |
ACTIVE_PART_NAME
The variable name for the active part.
|
static int |
ACTIVE_SHELL
The priority given when the source includes the currently active shell.
|
static String |
ACTIVE_SHELL_NAME
The variable name for the active shell.
|
static int |
ACTIVE_SITE
The priority given when the source includes the active workbench site.
|
static String |
ACTIVE_SITE_NAME
The variable name for the active workbench site.
|
static int |
ACTIVE_WORKBENCH_WINDOW
The priority given when the source includes the currently active
workbench window.
|
static String |
ACTIVE_WORKBENCH_WINDOW_ACTIVE_PERSPECTIVE_NAME
The variable name for the current perspective of the active workbench
window.
|
static String |
ACTIVE_WORKBENCH_WINDOW_IS_COOLBAR_VISIBLE_NAME
The variable name for the coolbar visibility state of the active
workbench window.
|
static String |
ACTIVE_WORKBENCH_WINDOW_IS_PERSPECTIVEBAR_VISIBLE_NAME
The variable name for the perspective bar visibility state of the active
workbench window.
|
static String |
ACTIVE_WORKBENCH_WINDOW_NAME
The variable name for the active workbench window.
|
static int |
ACTIVE_WORKBENCH_WINDOW_SHELL
The priority given when the source includes the currently active
workbench window shell.
|
static String |
ACTIVE_WORKBENCH_WINDOW_SHELL_NAME
The variable name for the active workbench window shell.
|
static int |
ACTIVE_WORKBENCH_WINDOW_SUBORDINATE
The priority given when the source includes subordinate properties of the currently active
workbench window.
|
static int |
LEGACY_LEGACY
The priority given when the activation is defined by a handler submission
with a legacy priority.
|
static int |
LEGACY_LOW
The priority given when the activation is defined by a handler submission
with a low priority.
|
static int |
LEGACY_MEDIUM
The priority given when the activation is defined by a handler submission
with a medium priority.
|
static String |
SHOW_IN_INPUT
The variable for the showIn input.
|
static String |
SHOW_IN_SELECTION
The variable for the showIn selection.
|
static int |
WORKBENCH
The priority given to default handlers and handlers that are active
across the entire workbench.
|
static final int WORKBENCH
static final int LEGACY_LEGACY
static final int LEGACY_LOW
static final int LEGACY_MEDIUM
static final int ACTIVE_CONTEXT
static final String ACTIVE_CONTEXT_NAME
ISourceProvider
and IEvaluationContext
.static final int ACTIVE_ACTION_SETS
static final String ACTIVE_ACTION_SETS_NAME
ISourceProvider
and IEvaluationContext
.static final int ACTIVE_SHELL
static final String ACTIVE_SHELL_NAME
ISourceProvider
and IEvaluationContext
.static final int ACTIVE_WORKBENCH_WINDOW_SHELL
static final String ACTIVE_WORKBENCH_WINDOW_SHELL_NAME
ISourceProvider
and
IEvaluationContext
.static final int ACTIVE_WORKBENCH_WINDOW
static final String ACTIVE_WORKBENCH_WINDOW_NAME
ISourceProvider
and IEvaluationContext
.static final int ACTIVE_WORKBENCH_WINDOW_SUBORDINATE
static final String ACTIVE_WORKBENCH_WINDOW_IS_COOLBAR_VISIBLE_NAME
ISourceProvider
and IEvaluationContext
.static final String ACTIVE_WORKBENCH_WINDOW_IS_PERSPECTIVEBAR_VISIBLE_NAME
ISourceProvider
and IEvaluationContext
.static final String ACTIVE_WORKBENCH_WINDOW_ACTIVE_PERSPECTIVE_NAME
ISourceProvider
and
IEvaluationContext
.static final int ACTIVE_EDITOR
static final String ACTIVE_EDITOR_NAME
ISourceProvider
and IEvaluationContext
.static final String ACTIVE_EDITOR_INPUT_NAME
static final int ACTIVE_EDITOR_ID
static final String ACTIVE_EDITOR_ID_NAME
ISourceProvider
and IEvaluationContext
.static final int ACTIVE_PART
static final String ACTIVE_PART_NAME
ISourceProvider
and IEvaluationContext
.static final int ACTIVE_PART_ID
static final String ACTIVE_PART_ID_NAME
ISourceProvider
and IEvaluationContext
.static final int ACTIVE_SITE
static final String ACTIVE_SITE_NAME
ISourceProvider
and IEvaluationContext
.static final String SHOW_IN_SELECTION
ISourceProvider
and IEvaluationContext
.IShowInSource
,
Constant Field Valuesstatic final String SHOW_IN_INPUT
ISourceProvider
and IEvaluationContext
.IShowInSource
,
Constant Field Valuesstatic final int ACTIVE_CURRENT_SELECTION
static final String ACTIVE_CURRENT_SELECTION_NAME
ISourceProvider
and IEvaluationContext
.static final int ACTIVE_MENU
static final String ACTIVE_MENU_NAME
ISourceProvider
and IEvaluationContext
.static final String ACTIVE_MENU_SELECTION_NAME
static final String ACTIVE_MENU_EDITOR_INPUT_NAME
static final String ACTIVE_FOCUS_CONTROL_NAME
static final String ACTIVE_FOCUS_CONTROL_ID_NAME
Copyright (c) 2000, 2014 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.