When you open your workbench on a set of projects, it looks something like this.
-
The workbench is just a frame that can present various visual parts. These parts fall into two major categories: views and editors.
@@ -56,9 +53,7 @@
-
-
+
+
Additional editors, such as Java code editors or HTML editors, can be supplied by plug-ins
- - diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_activities.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_activities.htm index 4327f22243c..457b927acd6 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_activities.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_activities.htm @@ -1,20 +1,33 @@ - + - - - -org.eclipse.jdt.*) is associated
with the Java development activity regardless of its local identifier
-(.*).
+(.*).
<activityPatternBinding activityId="org.eclipse.javaDevelopment" pattern="org\.eclipse\.jdt\..*/.*"> </activityPatternBinding>The next binding is more specific. It states that the contribution named -javanature defined in the JDT core (org.eclipse.jdt.core) is +
javanature defined in the JDT core (org.eclipse.jdt.core) is
associated with the Java development activity.
<activityPatternBinding activityId="org.eclipse.javaDevelopment" @@ -196,14 +209,14 @@Binding Activities to UI Contributions
Activities can be associated It is also possible to refer to a single UI contribution using its id without having to use regular expression syntax if the attribute -isEqualityPattern is set to true.
+isEqualityPatternis set totrue.
The following XML shows the previous example with the - isEqualityPattern set to true.
+isEqualityPatternset totrue.
-
+As you can see, activity pattern bindings can be used to associate +
<activityPatternBinding
activityId="org.eclipse.javaDevelopment"
pattern="org.eclipse.jdt.core/javanature"
isEqualityPattern="true">
</activityPatternBinding>
-
As you can see, activity pattern bindings can be used to associate large groups of contributions with a particular activity, or to associate very specific contributions with an activity. The following contributions are affected by activities: @@ -314,19 +327,19 @@Using Expression-based Activities
To filter a UI element using an expression-based activity, create an activity like the following:
- <activity
id="forbiddenViewActivityId" name="Forbidden View Activity">
<enabledWhen>
<with variable="rightsVariable">
+<activity
id="forbiddenViewActivityId" name="Forbidden View Activity">
<enabledWhen>
<with variable="rightsVariable">
<iterate ifEmpty="false" operator="or">
<equals value="grantShowForbidden" />
</iterate>
</with>
</enabledWhen>
</activity> -
+
Then, bind this activity to a UI element, for example a view:
- <activityPatternBinding
activityId="forbiddenViewActivityId"
<!-- Switches the interpretation of the pattern - as regular expression off -->
isEqualityPattern="true"
pattern="DemoRCP/demorcp.views.ForbiddenView">
+<activityPatternBinding+
activityId="forbiddenViewActivityId"
<!-- Switches the interpretation of the pattern + as regular expression off -->
isEqualityPattern="true"
pattern="DemoRCP/demorcp.views.ForbiddenView">
</activityPatternBinding> -The following code snippets show how to control the variable "rightsVariable" that appears in the activity's "enabledWhen" expression. New variables can be added @@ -334,50 +347,49 @@
Using Expression-based Activities
AbstractSourceProvider. -- +
+ fireSourceChanged(0, getCurrentState());
-import java.util.HashMap;-
...
-import org.eclipse.ui.AbstractSourceProvider;
+import java.util.HashMap;
...
+import org.eclipse.ui.AbstractSourceProvider;
-import org.eclipse.ui.PlatformUI;
-import org.eclipse.ui.handlers.IHandlerService;
-import org.eclipse.ui.services.IEvaluationService;
+import org.eclipse.ui.PlatformUI;
+import org.eclipse.ui.handlers.IHandlerService;
+import org.eclipse.ui.services.IEvaluationService;
-public class RightsSourceProvider extends AbstractSourceProvider {
+public class RightsSourceProvider extends AbstractSourceProvider {
- public final static String RIGHT_FORBIDDEN = "grantShowForbidden";
+ public final static String RIGHT_FORBIDDEN = "grantShowForbidden";
- public final static String RIGHTS_VARIABLE = "rightsVariable";
+ public final static String RIGHTS_VARIABLE = "rightsVariable";
- private final static String[] PROVIDED_SOURCE_NAMES = new String[] { RIGHTS_VARIABLE };
+ private final static String[] PROVIDED_SOURCE_NAMES = new String[] { RIGHTS_VARIABLE };
- private final static Map<String, List<String>> stateMap = new HashMap<String, List<String>>();
+ private final static Map<String, List<String>> stateMap = new HashMap<String, List<String>>();
- public Map getCurrentState() {
/* "YourRightsHandler" is here just an example for a + public Map getCurrentState() {
/* "YourRightsHandler" is here just an example for a static class
* which returns the list of -rights as a list of strings. */
+rights as a list of strings. */
- stateMap.put(RIGHTS_VARIABLE, YourRightsHandler.getUserRights());
- return stateMap;
- }
- public String[] getProvidedSourceNames() {
+ stateMap.put(RIGHTS_VARIABLE, YourRightsHandler.getUserRights());
+ return stateMap;
+ }
+ public String<[] getProvidedSourceNames() {
- return PROVIDED_SOURCE_NAMES;
- }
/* This triggers an update of the rights variable state, and + return PROVIDED_SOURCE_NAMES;
+ }
/* This triggers an update of the rights variable state, and will update also all
* listeners to the evaluation service. So that every menu point, which is also
* expression -controlled, gets updated too. */
- public void updateRights() {
+controlled, gets updated too. */
+ public void updateRights() {
- fireSourceChanged(0, getCurrentState());
- }
// ...
-}
+ }
// ...
+} + diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_contexts.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_contexts.htm index a033db05756..33d75f02350 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_contexts.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_contexts.htm @@ -1,12 +1,9 @@ - + - - - - +Contexts diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_decorators.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_decorators.htm index dc7163add00..81b11cdf533 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_decorators.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_decorators.htm @@ -1,12 +1,9 @@ - + - - - - +Decorators @@ -26,7 +23,7 @@binary and source projects. -
+
The com.example.helloworld project is the only source project @@ -136,7 +133,7 @@
is on. This technique is used by the CVS client. -
+
diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_elementFactories.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_elementFactories.htm index 15f5613978b..ea46380790b 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_elementFactories.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_elementFactories.htm @@ -1,12 +1,9 @@ - + - - - - +
Element factories @@ -22,7 +19,7 @@Element factories
that is used throughout the platform to add plug-in specific behavior to common platform model objects.- + IAdaptables and workbench adapters
When browsing the various workbench classes, you will notice that many of the workbench interfaces extend the diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_perspectiveExtension.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_perspectiveExtension.htm index 20f8672827c..0c42a7c9491 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_perspectiveExtension.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_perspectiveExtension.htm @@ -1,13 +1,10 @@ - +
- - - - - + +org.eclipse.ui.perspectiveExtensions diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_perspectives.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_perspectives.htm index 156fa700dce..298f0bcb86f 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_perspectives.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_perspectives.htm @@ -1,12 +1,9 @@ - + - - - - +org.eclipse.ui.perspectives diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_resourceFilters.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_resourceFilters.htm index 369fe3102fa..5ce1602d519 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_resourceFilters.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_advext_resourceFilters.htm @@ -1,20 +1,15 @@ - + - - - - +Contributing resource filters - -Contributing resource filters
@@ -39,7 +34,7 @@
pull-down menu. -
+
In addition to declaring the filter pattern, @@ -49,10 +44,7 @@
control which filter patterns are active. -
- - - +
diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_basicext_editors.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_basicext_editors.htm index 7c80fdcf033..2b78ac52a0a 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_basicext_editors.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_basicext_editors.htm @@ -1,12 +1,9 @@ - + - - - - +
org.eclipse.ui.editors @@ -81,7 +78,7 @@Editor menus and editor toolbars are placed in the main menu and main toolbar. See org.eclipse.ui.menus for how to use the locationURI to place the commands correctly. -
+
These menu and tool bar items can be shown only when the editor is active using core expressions. To define a re-usable core expression for your editor, use diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_basicext_views.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_basicext_views.htm index ce0d210cfb8..f994798e5a1 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_basicext_views.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_basicext_views.htm @@ -1,13 +1,10 @@ - +
- - - - - + +org.eclipse.ui.views @@ -104,8 +101,6 @@It obtains the service from its IViewSite, which contains information about the view's context, such as its workbench window, its containing page, its local services, and its plug-in. -
-
We've covered a lot of common workbench concepts by studying this extension. Now we'll move on to some other workbench extensions and examine how your plug-in can further contribute to the workbench UI.
diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd.htm index b5b6555dbb6..e61809bffda 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd.htm @@ -1,12 +1,9 @@ - + - - - - +Basic workbench extension points diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_bindings.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_bindings.htm index 3ef26f4f27e..18ecc998a9e 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_bindings.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_bindings.htm @@ -1,17 +1,15 @@ - + - - - - +Key bindings +Key Bindings
diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_commands.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_commands.htm index 91a3507dc4b..91fc6bb61b2 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_commands.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_commands.htm @@ -1,17 +1,15 @@ - + - - - - +Commands +Commands
diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_expressions.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_expressions.htm index 7b54acc6eb3..3ce250bca66 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_expressions.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_cmd_expressions.htm @@ -1,16 +1,23 @@ - + - - - - - + +Workbench Core Expressions +Workbench Core Expressions
@@ -56,7 +63,7 @@Declarative Expression Examples
Most of the tree or table like viewers return an @@ -138,7 +145,7 @@
The Package Explorer is a mixture of @@ -186,7 +193,7 @@
If your handler should be enabled when your view or editor activates a context, you can use the @@ -206,7 +213,7 @@
For handlers that are to be contributed to a specific view or editor, you can use activeEditorId
@@ -234,7 +241,7 @@
As of 3.3 all org.eclipse.ui.actionSets (Deprecated)
generate a context with a parent of org.eclipse.ui.contexts.actionSet. Contexts with
@@ -285,12 +292,11 @@
| Name | Type | Description | -Since | ||
|---|---|---|---|---|---|
| Namespace | Type | @@ -602,7 +608,7 @@||||
|---|---|---|---|---|---|
| + | |||||
| + | |||||
| + | |||||
| + | |||||
| + | |||||
| + | |||||
| + |
Extension point name |
-+ |
Location of Actions |
-+ |
Details |
|---|---|---|---|---|---|
| + |
menus |
-+ |
Commands can be placed in the main menu and toolbar. Command can be placed in part context menus, as well as view menus and view toolbars. The placement @@ -47,7 +50,7 @@ the visibleWhen core expression. |
-+ |
The extension point should be used to place commands in menus and toolbars so they can be executed by the user. diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_perspectives.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_perspectives.htm index e79beb362c5..fb2f54d9981 100644 --- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_perspectives.htm +++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_perspectives.htm @@ -1,13 +1,10 @@ - + - - - - - + +
diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_plugin.htm b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_plugin.htm
index 2104821d224..2f40c51f0b8 100644
--- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_plugin.htm
+++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/guide/workbench_plugin.htm
@@ -1,12 +1,9 @@
-
+
-
-
-
-
+
|
+
+