Package org.eclipse.jface.action
Interface IContributionItem
- All Known Subinterfaces:
IMenuManager
- All Known Implementing Classes:
AbstractContributionItem
,AbstractGroupMarker
,ActionContributionItem
,ActionSetContributionItem
,ActionSetMenuManager
,ActionSetSeparator
,BaseNewWizardMenu
,BreakpointTypesContribution
,ChangeToPerspectiveMenu
,CommandContributionItem
,CompoundContributionItem
,ContributionItem
,ControlContribution
,CoolItemGroupMarker
,DirectContributionItem
,EditorMenuManager
,GroupMarker
,HandledContributionItem
,org.eclipse.ui.internal.menus.InternalControlContribution
,LabelContributionItem
,MenuManager
,NewWizardMenu
,OpenNewPageMenu
,OpenNewWindowMenu
,OpenPerspectiveMenu
,OpenWithMenu
,PerspectiveMenu
,PluginActionContributionItem
,PluginActionCoolBarContributionItem
,ReopenEditorMenu
,Separator
,ShowInMenu
,ShowViewMenu
,StatusLineContributionItem
,StatusLineContributionItem
,SubContributionItem
,SubMenuManager
,SwitchToWindowMenu
,ToolBarContributionItem
,ToolControlContribution
,WorkbenchWindowControlContribution
,WorkingSetMenuContributionItem
@NoImplement
public interface IContributionItem
A contribution item represents a contribution to a shared UI resource such as
a menu or tool bar. More generally, contribution items are managed by a
contribution manager. For instance, in a tool bar a contribution item is a
tool bar button or a separator. In a menu bar a contribution item is a menu,
and in a menu a contribution item is a menu item or separator.
A contribution item can realize itself in different SWT widgets, using the
different fill
methods. The same type of contribution item can
be used with a MenuBarManager
, ToolBarManager
,
CoolBarManager
, or a StatusLineManager
.
This interface is internal to the framework; it should not be implemented outside the framework.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionvoid
dispose()
Disposes of this contribution item.void
Fills the given composite control with controls representing this contribution item.void
Fills the given cool bar with controls representing this contribution item.void
Fills the given menu with controls representing this contribution item.void
Fills the given tool bar with controls representing this contribution item.getId()
Returns the identifier of this contribution item.boolean
isDirty()
Returns whether this contribution item is dirty.boolean
Returns whether this contribution item is dynamic.boolean
Returns whether this contribution item is enabled.boolean
Returns whether this contribution item is a group marker.boolean
Returns whether this contribution item is a separator.boolean
Returns whether this contribution item is visibile within its manager.void
Saves any state information of the control(s) owned by this contribution item.void
setParent
(IContributionManager parent) Sets the parent manager of this itemvoid
setVisible
(boolean visible) Sets whether this contribution item is visibile within its manager.void
update()
Updates any SWT controls cached by this contribution item with any changes which have been made to this contribution item since the last update.void
Updates any SWT controls cached by this contribution item with changes for the the given property.
-
Method Details
-
dispose
void dispose()Disposes of this contribution item. Called by the parent contribution manager when the manager is being disposed. Clients should not call this method directly, unless they have removed this contribution item from the containing IContributionManager before the contribution lifecycle has ended.- Since:
- 2.1
-
fill
Fills the given composite control with controls representing this contribution item. Used byStatusLineManager
.- Parameters:
parent
- the parent control
-
fill
Fills the given menu with controls representing this contribution item. Used byMenuManager
.- Parameters:
parent
- the parent menuindex
- the index where the controls are inserted, or-1
to insert at the end
-
fill
Fills the given tool bar with controls representing this contribution item. Used byToolBarManager
.- Parameters:
parent
- the parent tool barindex
- the index where the controls are inserted, or-1
to insert at the end
-
fill
Fills the given cool bar with controls representing this contribution item. Used byCoolBarManager
.- Parameters:
parent
- the parent cool barindex
- the index where the controls are inserted, or-1
to insert at the end- Since:
- 3.0
-
getId
String getId()Returns the identifier of this contribution item. The id is used for retrieving an item from its manager.- Returns:
- the contribution item identifier, or
null
if none
-
isEnabled
boolean isEnabled()Returns whether this contribution item is enabled.- Returns:
true
if this item is enabled
-
isDirty
boolean isDirty()Returns whether this contribution item is dirty. A dirty item will be recreated when the action bar is updated.- Returns:
true
if this item is dirty
-
isDynamic
boolean isDynamic()Returns whether this contribution item is dynamic. A dynamic contribution item contributes items conditionally, dependent on some internal state.- Returns:
true
if this item is dynamic, andfalse
for normal items
-
isGroupMarker
boolean isGroupMarker()Returns whether this contribution item is a group marker. This information is used when adding items to a group.- Returns:
true
if this item is a group marker, andfalse
for normal items- See Also:
-
isSeparator
boolean isSeparator()Returns whether this contribution item is a separator. This information is used to enable hiding of unnecessary separators.- Returns:
true
if this item is a separator, andfalse
for normal items- See Also:
-
isVisible
boolean isVisible()Returns whether this contribution item is visibile within its manager.- Returns:
true
if this item is visible, andfalse
otherwise
-
saveWidgetState
void saveWidgetState()Saves any state information of the control(s) owned by this contribution item. The contribution manager calls this method before disposing of the controls.- Since:
- 3.0
-
setParent
Sets the parent manager of this item- Parameters:
parent
- the parent contribution manager- Since:
- 2.0
-
setVisible
void setVisible(boolean visible) Sets whether this contribution item is visibile within its manager.- Parameters:
visible
-true
if this item should be visible, andfalse
otherwise
-
update
void update()Updates any SWT controls cached by this contribution item with any changes which have been made to this contribution item since the last update. Called by contribution manager update methods. -
update
Updates any SWT controls cached by this contribution item with changes for the the given property.- Parameters:
id
- the id of the changed property- Since:
- 2.0
-