Ergänzungen für Workbench-Menüs

Es wurden bereits mehrere unterschiedliche Erweiterungspunkte vorgestellt, an denen die Workbench durch verschiedene Menüs und Symbolleisten ergänzt werden kann. Sie müssen daher ermitteln können, welcher Erweiterungspunkt für einen bestimmten Zweck zu verwenden ist. Die folgende Tabelle fasst die unterschiedlichen Menüergänzungen sowie deren Verwendung zusammen.

Name des Erweiterungspunkts

Position der Aktionen

Details

viewActions

Die Aktionen werden in der lokalen Symbolleiste und dem lokalen Pull-down-Menü einer spezifischen Sicht angezeigt.

Es muss eine Aktionsklasse bereitgestellt werden, die IViewActionDelegate implementiert. Anzugeben sind die ID der Ergänzung und die ID der Zielsicht, in der die Aktion angezeigt werden soll. Bezeichnung und Image geben die Darstellung der Aktion in der Benutzerschnittstelle vor. Der Pfad gibt die Position bezogen auf die übrigen Menü- und Symbolleistenelemente der Sicht an.

editorActions

Die Aktionen werden einem Editor zugeordnet und im Menü und/oder in der Symbolleiste der Sicht angezeigt.

Es muss eine Aktionsklasse bereitgestellt werden, die IEditorActionDelegate implementiert. Anzugeben sind die ID der Ergänzung und die ID des Zieleditors, in dem die Aktion angezeigt werden soll. Bezeichnung und Image geben die Darstellung der Aktion in der Benutzerschnittstelle vor. Separate Menü- und Symbolleistenpfade geben das Vorhandensein und die Position der Ergänzung in Menü und Symbolleiste der Workbench an.

popupMenus

Die Aktionen werden im Kontextmenü eines Editors oder einer Sicht angezeigt. Aktionen, die einem Objekttyp zugeordnet sind, werden in allen Kontextmenüs von Sichten und Editoren angezeigt, die diesen Objekttyp enthalten. Aktionen, die einem spezifischen Kontextmenü zugeordnet sind, werden ausschließlich in diesem Kontextmenü angezeigt.

Objektergänzungen geben den Typ des Objekts an, in dessen Kontextmenü die Aktion angezeigt werden soll. Die Aktion wird in den Kontextmenüs aller Sichten und Editoren angezeigt, die diesen Objekttyp enthalten.  Es muss eine Aktionsklasse bereitgestellt werden, die IObjectActionDelegate implementiert. 
Ergänzungen für Anzeigefunktionen geben die ID des Zielkontextmenüs an, in dem die Menüoption angezeigt werden soll.  Es muss eine Aktionsklasse bereitgestellt werden, die IEditorActionDelegate oder IViewActionDelegate implementiert. 

actionSets

Die Aktionen werden in den Hauptmenüs und der Symbolleiste der Workbench angezeigt. Die Aktionen sind in Aktionssets gruppiert. Alle Aktionen eines Aktionssets werden in den Workbench-Menüs und Symbolleisten gemäß den vom Benutzer definierten Einstellungen für Aktionssets und der aktuellen Perspektive in der Workbench angezeigt.  Kann durch actionSetPartAssociations (s.u.) beeinflusst werden.

Es muss eine Aktionsklasse bereitgestellt werden, die IWorkbenchWindowActionDelegate oder IWorkbenchWindowPulldownDelegate implementiert. Anzugeben sind Name und ID des Aktionssets. Es müssen alle Aktionen aufgelistet werden, die für dieses Aktionsset definiert sind. Für jede Aktion geben separate Menü- und Symbolleistenpfade das Vorhandensein und die Position der Ergänzung in Menü und Symbolleiste der Workbench an.

actionSetPartAssociations

Aktionssets werden nur angezeigt, wenn die angegebenen Sichten oder Editoren aktiv sind.  Dieser Wert wird ignoriert, wenn der Benutzer die aktuelle Perspektive angepasst hat.

Geben Sie mit Hilfe des Parameters id ein Aktionsset und anschließend eine oder mehrere Komponenten (ebenfalls durch Angabe von id) an, die in der aktuellen Perspektive aktiv sein müssen, damit das Aktionsset angezeigt wird.