Package SpecificationContribution managers coordinate contributions to shared UI resources such as menus, menu bars, tool bars, and status lines.
ContributionManagermaintains the contributions as a dynamic list of contribution items (
IContributionItems). Separators (
Separator) can be included in contribution lists to break up the list's visual representation. Internally, contribution lists can be organized into named groups via special group markers (
GroupMarker) to facilitate programatic insertion at specific positions within the list.
Three specific contribution managers are provided: a status line manager
StatusLineManager), a tool bar manager (
and a hierarchical menu manager (
IAction) are commands which can be triggered from
the UI, like the ones found in menus, toolbars, and buttons. Menus and
tools bars are typically populated with contribution items that delegate
to actions (
Note: None of the classes in this package maintain global state.
Interface Summary Interface Description ExternalActionManager.IActiveCheckerDefines a callback mechanism for developer who wish to further control the visibility of legacy action-based contribution items. ExternalActionManager.IBindingManagerCallbackA callback which communicates with the applications binding manager. ExternalActionManager.ICallbackA callback mechanism for some external tool to communicate extra information to actions and action contribution items. ExternalActionManager.IExecuteApplicableAn overridable mechanism to filter certain IActions from the execution bridge. ExternalActionManager.IExecuteCallbackA callback for executing execution events. IActionAn action represents the non-UI side of a command which can be triggered by the end user. IContributionItemA contribution item represents a contribution to a shared UI resource such as a menu or tool bar. IContributionManagerA contribution manager organizes contributions to such UI components as menus, toolbars and status lines. IContributionManagerOverridesThis interface is used by instances of
IContributionItemto determine if the values for certain properties have been overriden by their manager.
ICoolBarManagerinterface provides protocol for managing contributions to a cool bar.
IMenuCreatorInterface for something that creates and disposes of SWT menus. IMenuListenerA menu listener that gets informed when a menu is about to show. IMenuListener2A menu listener that gets informed when a menu is about to hide. IMenuManagerThe
IMenuManagerinterface provides protocol for managing contributions to a menu bar and its sub menus.
IStatusLineManagerinterface provides protocol for displaying messages on a status line, for monitoring progress, and for managing contributions to the status line.
IToolBarManagerinterface provides protocol for managing contributions to a tool bar.
Class Summary Class Description AbstractActionSome common functionality to share between implementations of
AbstractGroupMarkerAbstract superclass for group marker classes. ActionThe standard abstract implementation of an action. ActionContributionItemA contribution item which delegates to an action. ContributionItemAn abstract base implementation for contribution items. ContributionManagerAbstract base class for all contribution managers, and standard implementation of
ControlContributionAn abstract contribution item implementation for adding an arbitrary SWT control to a tool bar. CoolBarManagerA cool bar manager is a contribution manager which realizes itself and its items in a cool bar control. ExternalActionManagerA manager for a callback facility which is capable of querying external interfaces for additional information about actions and action contribution items. ExternalActionManager.CommandCallbackA simple implementation of the
ICallbackmechanism that simply takes a
GroupMarkerA group marker is a special kind of contribution item denoting the beginning of a group. LegacyActionToolsSome static utility methods for handling labels on actions. MenuManagerA menu manager is a contribution manager which realizes itself and its items in a menu control; either as a menu bar, a sub-menu, or a context menu. SeparatorA separator is a special kind of contribution item which acts as a visual separator and, optionally, acts as a group marker. StatusLineContributionItemA contribution item to be used with status line managers. StatusLineLayoutDataRepresents the layout data object for
Controlwithin the status line.
StatusLineManagerA status line manager is a contribution manager which realizes itself and its items in a status line control. SubContributionItemA
SubContributionItemis a wrapper for an
SubContributionManageris used to define a set of contribution items within a parent manager.
SubCoolBarManagermonitors the additional and removal of items from a parent manager so that visibility of the entire set can be changed as a unit.
SubMenuManageris used to define a set of contribution items within a parent manager.
SubStatusLineManageris used to define a set of contribution items within a parent manager.
SubToolBarManagermonitors the additional and removal of items from a parent manager so that visibility of the entire set can be changed as a unit.
ToolBarContributionItemclass provides a wrapper for tool bar managers when used in cool bar managers.
ToolBarManagerA tool bar manager is a contribution manager which realizes itself and its items in a tool bar control.