Package org.eclipse.ui.menus
Class CommandContributionItem
- java.lang.Object
-
- org.eclipse.jface.action.ContributionItem
-
- org.eclipse.ui.menus.CommandContributionItem
-
- All Implemented Interfaces:
IContributionItem
public class CommandContributionItem extends ContributionItem
A contribution item which delegates to a command. It can be used inAbstractContributionFactory.createContributionItems(IServiceLocator, IContributionRoot).It currently supports placement in menus and toolbars.
This class may be instantiated; it is not intended to be subclassed.
- Since:
- 3.3
- Restriction:
- This class is not intended to be subclassed by clients.
-
-
Field Summary
Fields Modifier and Type Field Description static intMODE_FORCE_TEXTMode bit: Show text on tool items or buttons, even if an image is present.static intSTYLE_CHECKA checked tool item or menu item.static intSTYLE_PULLDOWNA ToolBar pulldown item.static intSTYLE_PUSHA push button tool item or menu item.static intSTYLE_RADIOA radio-button style menu item.
-
Constructor Summary
Constructors Constructor Description CommandContributionItem(CommandContributionItemParameter contributionParameters)Create a CommandContributionItem to place in a ContributionManager.CommandContributionItem(IServiceLocator serviceLocator, String id, String commandId, Map parameters, ImageDescriptor icon, ImageDescriptor disabledIcon, ImageDescriptor hoverIcon, String label, String mnemonic, String tooltip, int style)Deprecated.create theCommandContributionItemParameter
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voiddispose()The default implementation of thisIContributionItemmethod does nothing.voidfill(Composite parent)The default implementation of thisIContributionItemmethod does nothing.voidfill(Menu parent, int index)The default implementation of thisIContributionItemmethod does nothing.voidfill(ToolBar parent, int index)The default implementation of thisIContributionItemmethod does nothing.ParameterizedCommandgetCommand()Returns the ParameterizedCommand for this contribution.CommandContributionItemParametergetData()Provide info on the rendering data contained in this item.booleanisEnabled()The default implementation of thisIContributionItemmethod returnstrue.booleanisVisible()The default implementation of thisIContributionItemmethod returns the value recorded in an internal state variable, which istrueby default.voidsetParent(IContributionManager parent)Sets the parent manager of this itemvoidupdate()The default implementation of thisIContributionItemmethod does nothing.voidupdate(String id)TheContributionItemimplementation of this method declared onIContributionItemdoes nothing.-
Methods inherited from class org.eclipse.jface.action.ContributionItem
fill, getId, getParent, isDirty, isDynamic, isGroupMarker, isSeparator, saveWidgetState, setId, setVisible, toString
-
-
-
-
Field Detail
-
STYLE_PUSH
public static final int STYLE_PUSH
A push button tool item or menu item.- See Also:
- Constant Field Values
-
STYLE_CHECK
public static final int STYLE_CHECK
A checked tool item or menu item.- See Also:
- Constant Field Values
-
STYLE_RADIO
public static final int STYLE_RADIO
A radio-button style menu item.- See Also:
- Constant Field Values
-
STYLE_PULLDOWN
public static final int STYLE_PULLDOWN
A ToolBar pulldown item.- See Also:
- Constant Field Values
-
MODE_FORCE_TEXT
public static int MODE_FORCE_TEXT
Mode bit: Show text on tool items or buttons, even if an image is present. If this mode bit is not set, text is only shown on tool items if there is no image present.- Since:
- 3.4
-
-
Constructor Detail
-
CommandContributionItem
public CommandContributionItem(CommandContributionItemParameter contributionParameters)
Create a CommandContributionItem to place in a ContributionManager.- Parameters:
contributionParameters- parameters necessary to render this contribution item.- Since:
- 3.4
-
CommandContributionItem
@Deprecated public CommandContributionItem(IServiceLocator serviceLocator, String id, String commandId, Map parameters, ImageDescriptor icon, ImageDescriptor disabledIcon, ImageDescriptor hoverIcon, String label, String mnemonic, String tooltip, int style)
Deprecated.create theCommandContributionItemParameterCreate a CommandContributionItem to place in a ContributionManager.- Parameters:
serviceLocator- a service locator that is most appropriate for this contribution. Typically the localIWorkbenchWindoworIWorkbenchPartSitewill be sufficient.id- The id for this item. May benull. Items without an id cannot be referenced later.commandId- A command id for a defined command. Must not benull.parameters- A map of strings to strings which represent parameter names to values. The parameter names must match those in the command definition.icon- An icon for this item. May benull.disabledIcon- A disabled icon for this item. May benull.hoverIcon- A hover icon for this item. May benull.label- A label for this item. May benull.mnemonic- A mnemonic for this item to be applied to the label. May benull.tooltip- A tooltip for this item. May benull. Tooltips are currently only valid for toolbar contributions.style- The style of this menu contribution. See the STYLE_* contants.
-
-
Method Detail
-
getCommand
public ParameterizedCommand getCommand()
Returns the ParameterizedCommand for this contribution.NOTE: The returned object should be treated as 'read-only', do not execute this instance or attempt to modify its state.
- Returns:
- The parameterized command for this contribution.
- Since:
- 3.5
-
fill
public void fill(Menu parent, int index)
Description copied from class:ContributionItemThe default implementation of thisIContributionItemmethod does nothing. Subclasses may override.- Specified by:
fillin interfaceIContributionItem- Overrides:
fillin classContributionItem- Parameters:
parent- the parent menuindex- the index where the controls are inserted, or-1to insert at the end
-
fill
public void fill(Composite parent)
Description copied from class:ContributionItemThe default implementation of thisIContributionItemmethod does nothing. Subclasses may override.- Specified by:
fillin interfaceIContributionItem- Overrides:
fillin classContributionItem- Parameters:
parent- the parent control
-
fill
public void fill(ToolBar parent, int index)
Description copied from class:ContributionItemThe default implementation of thisIContributionItemmethod does nothing. Subclasses may override.- Specified by:
fillin interfaceIContributionItem- Overrides:
fillin classContributionItem- Parameters:
parent- the parent tool barindex- the index where the controls are inserted, or-1to insert at the end
-
update
public void update()
Description copied from class:ContributionItemThe default implementation of thisIContributionItemmethod does nothing. Subclasses may override.- Specified by:
updatein interfaceIContributionItem- Overrides:
updatein classContributionItem
-
update
public void update(String id)
Description copied from class:ContributionItemTheContributionItemimplementation of this method declared onIContributionItemdoes nothing. Subclasses should override to update their state.- Specified by:
updatein interfaceIContributionItem- Overrides:
updatein classContributionItem- Parameters:
id- the id of the changed property
-
setParent
public void setParent(IContributionManager parent)
Description copied from interface:IContributionItemSets the parent manager of this item- Specified by:
setParentin interfaceIContributionItem- Overrides:
setParentin classContributionItem- Parameters:
parent- the parent contribution manager
-
dispose
public void dispose()
Description copied from class:ContributionItemThe default implementation of thisIContributionItemmethod does nothing. Subclasses may override.- Specified by:
disposein interfaceIContributionItem- Overrides:
disposein classContributionItem
-
isEnabled
public boolean isEnabled()
Description copied from class:ContributionItemThe default implementation of thisIContributionItemmethod returnstrue. Subclasses may override.- Specified by:
isEnabledin interfaceIContributionItem- Overrides:
isEnabledin classContributionItem- Returns:
trueif this item is enabled
-
isVisible
public boolean isVisible()
Description copied from class:ContributionItemThe default implementation of thisIContributionItemmethod returns the value recorded in an internal state variable, which istrueby default.setVisibleshould be used to change this setting.- Specified by:
isVisiblein interfaceIContributionItem- Overrides:
isVisiblein classContributionItem- Returns:
trueif this item is visible, andfalseotherwise- Since:
- 3.4
-
getData
public CommandContributionItemParameter getData()
Provide info on the rendering data contained in this item.- Returns:
- a
CommandContributionItemParameter. Valid fields are serviceLocator, id, style, icon, disabledIcon, hoverIcon, label, helpContextId, mnemonic, tooltip. The Object will never benull, although any of the fields may benull. - Since:
- 3.100
-
-