Class NavigatorActionService
- All Implemented Interfaces:
IMementoAware
Provides context menu items and IActionBars contributions for a particular abstract
viewer. The interface matches that of ActionGroup and may be used in the same manner.
Clients must call
prepareMenuForPlatformContributions(MenuManager, ISelectionProvider, boolean)
when using this class to allow object or viewer contributions. The
org.eclipse.ui.navigator.viewer/viewer/popupMenu element may override whether platform
contributions are allowed to the menu with its allowsPlatformContributions attribute.
"Platform Contributions" are menu items that are added through the org.eclipse.ui.popupMenus
extension point.
A CommonActionProvider has opportunities to contribute to the context menu and
IActionBars whenever the selection in the viewer changes. Action Providers
are selected based on the enablement expressions of their associated content extension or their
own enablement expression if it is declared as a top-level <actionProvider /> element (of
the org.eclipse.ui.navigator.navigatorContent extension point). See the schema
documentation of org.eclipse.ui.navigator.navigatorContent for more information on how to
specify an Action Provider.
Clients that reuse this service outside of an instance of CommonNavigator must be sure
that {fillActionBars(IActionBars) is called whenever the selection changes. The
retargetable actions for each selection could change, based on who contributed the items.
- Since:
- 3.2
-
Constructor Summary
ConstructorsConstructorDescriptionNavigatorActionService(ICommonViewerSite aCommonViewerSite, StructuredViewer aStructuredViewer, INavigatorContentService aContentService) -
Method Summary
Modifier and TypeMethodDescriptionvoiddispose()Dispose of any state or resources held by the service.voidfillActionBars(IActionBars theActionBars) Request that the service invoke extensions to fill the given IActionBars with retargetable actions or view menu contributions from Action Providers that are interested in the given selection.voidfillContextMenu(IMenuManager aMenu) Requests that the service invoke extensions to fill the given menu with Action Providers that are interested in elements from the given selection.getActionProviderInstance(org.eclipse.ui.internal.navigator.actions.CommonActionProviderDescriptor aProviderDescriptor) voidprepareMenuForPlatformContributions(MenuManager menu, ISelectionProvider aSelectionProvider, boolean force) Prepares the menu for object contributions, if the option is set in the extension.voidrestoreState(IMemento aMemento) Use the given memento to restore the state of each Action Provider as it is initialized.voidRequest that Action Providers save any state that they find interesting.Methods inherited from class org.eclipse.ui.actions.ActionGroup
getContext, setContext, updateActionBars
-
Constructor Details
-
Method Details
-
prepareMenuForPlatformContributions
public void prepareMenuForPlatformContributions(MenuManager menu, ISelectionProvider aSelectionProvider, boolean force) Prepares the menu for object contributions, if the option is set in the extension. The option is controlled by the<popupMenu />element's 'allowPlatformContributions' attribute. Clients may choose to ignore this setting by supplying a value of true for theforceattribute.- Parameters:
menu- The context menu of the IViewPartaSelectionProvider- The selection provider that will supplement actions with a valid, current selection.force- A value of 'true' forces the menu to be registered for object/view contributions. Otherwise, the option from the extension point will be respected. See org.eclipse.ui.navigator.viewer/viewer for more information.
-
fillContextMenu
Requests that the service invoke extensions to fill the given menu with Action Providers that are interested in elements from the given selection.Object contributions (see org.eclipes.ui.popupMenus) may also respected by this method if
toRespectObjectContributionsis true.- Overrides:
fillContextMenuin classActionGroup- Parameters:
aMenu- The menu being presented to the user.- See Also:
-
fillActionBars
Request that the service invoke extensions to fill the given IActionBars with retargetable actions or view menu contributions from Action Providers that are interested in the given selection.- Overrides:
fillActionBarsin classActionGroup- Parameters:
theActionBars- The action bars in use by the current view site.- See Also:
-
dispose
public void dispose()Dispose of any state or resources held by the service.- Overrides:
disposein classActionGroup- See Also:
-
restoreState
Use the given memento to restore the state of each Action Provider as it is initialized.- Specified by:
restoreStatein interfaceIMementoAware- Parameters:
aMemento- The memento retrieved from the dialog settings
-
saveState
Request that Action Providers save any state that they find interesting.- Specified by:
saveStatein interfaceIMementoAware- Parameters:
aMemento- The memento retrieved from the dialog settings
-