Java tutorial
/******************************************************************************* * Copyright (c) 2006, 2012 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ package org.eclipse.ui.menus; import java.util.Map; import org.eclipse.core.commands.Command; import org.eclipse.core.commands.CommandEvent; import org.eclipse.core.commands.ExecutionException; import org.eclipse.core.commands.ICommandListener; import org.eclipse.core.commands.IHandler; import org.eclipse.core.commands.NotEnabledException; import org.eclipse.core.commands.NotHandledException; import org.eclipse.core.commands.ParameterizedCommand; import org.eclipse.core.commands.common.NotDefinedException; import org.eclipse.core.runtime.IStatus; import org.eclipse.core.runtime.Status; import org.eclipse.jface.action.ContributionItem; import org.eclipse.jface.action.IContributionManager; import org.eclipse.jface.action.IMenuListener2; import org.eclipse.jface.action.IMenuManager; import org.eclipse.jface.action.MenuManager; import org.eclipse.jface.bindings.BindingManagerEvent; import org.eclipse.jface.bindings.IBindingManagerListener; import org.eclipse.jface.bindings.TriggerSequence; import org.eclipse.jface.resource.DeviceResourceException; import org.eclipse.jface.resource.ImageDescriptor; import org.eclipse.jface.resource.JFaceResources; import org.eclipse.jface.resource.LocalResourceManager; import org.eclipse.osgi.util.NLS; import org.eclipse.swt.SWT; import org.eclipse.swt.graphics.Point; import org.eclipse.swt.widgets.Button; import org.eclipse.swt.widgets.Composite; import org.eclipse.swt.widgets.Display; import org.eclipse.swt.widgets.Event; import org.eclipse.swt.widgets.Listener; import org.eclipse.swt.widgets.Menu; import org.eclipse.swt.widgets.MenuItem; import org.eclipse.swt.widgets.ToolBar; import org.eclipse.swt.widgets.ToolItem; import org.eclipse.swt.widgets.Widget; import org.eclipse.ui.IWorkbench; import org.eclipse.ui.IWorkbenchPartSite; import org.eclipse.ui.IWorkbenchWindow; import org.eclipse.ui.commands.ICommandImageService; import org.eclipse.ui.commands.ICommandService; import org.eclipse.ui.commands.IElementReference; import org.eclipse.ui.commands.IElementUpdater; import org.eclipse.ui.handlers.IHandlerService; import org.eclipse.ui.help.IWorkbenchHelpSystem; import org.eclipse.ui.internal.WorkbenchPlugin; import org.eclipse.ui.internal.handlers.HandlerProxy; import org.eclipse.ui.internal.menus.CommandMessages; import org.eclipse.ui.internal.misc.StatusUtil; import org.eclipse.ui.internal.services.IWorkbenchLocationService; import org.eclipse.ui.keys.IBindingService; import org.eclipse.ui.services.IServiceLocator; import org.eclipse.ui.statushandlers.StatusManager; /** * A contribution item which delegates to a command. It can be used in {@link * AbstractContributionFactory#createContributionItems(IServiceLocator, * IContributionRoot)}. * <p> * It currently supports placement in menus and toolbars. * </p> * <p> * This class may be instantiated; it is not intended to be subclassed. * </p> * * @noextend This class is not intended to be subclassed by clients. * @since 3.3 */ public class CommandContributionItem extends ContributionItem { /** * A push button tool item or menu item. */ public static final int STYLE_PUSH = SWT.PUSH; /** * A checked tool item or menu item. */ public static final int STYLE_CHECK = SWT.CHECK; /** * A radio-button style menu item. */ public static final int STYLE_RADIO = SWT.RADIO; /** * A ToolBar pulldown item. */ public static final int STYLE_PULLDOWN = SWT.DROP_DOWN; /** * 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 */ public static int MODE_FORCE_TEXT = 1; private LocalResourceManager localResourceManager; private Listener menuItemListener; private Widget widget; private IMenuService menuService; private ICommandService commandService; private IHandlerService handlerService; private IBindingService bindingService; private ParameterizedCommand command; private ImageDescriptor icon; private String label; private String tooltip; private ImageDescriptor disabledIcon; private ImageDescriptor hoverIcon; private String mnemonic; private IElementReference elementRef; private boolean checkedState; private int style; private ICommandListener commandListener; private String dropDownMenuOverride; private IWorkbenchHelpSystem workbenchHelpSystem; private String helpContextId; private int mode = 0; /** * This is <code>true</code> when the menu contribution's visibleWhen * checkEnabled attribute is <code>true</code>. */ private boolean visibleEnabled; private Display display; // items contributed private String contributedLabel; private ImageDescriptor contributedIcon; private ImageDescriptor contributedDisabledIcon; private ImageDescriptor contributedHoverIcon; private IServiceLocator serviceLocator; /** * Create a CommandContributionItem to place in a ContributionManager. * * @param contributionParameters * parameters necessary to render this contribution item. * @since 3.4 */ public CommandContributionItem(CommandContributionItemParameter contributionParameters) { super(contributionParameters.id); contributedLabel = contributionParameters.label; contributedIcon = contributionParameters.icon; contributedDisabledIcon = contributionParameters.disabledIcon; contributedHoverIcon = contributionParameters.hoverIcon; this.serviceLocator = contributionParameters.serviceLocator; this.icon = contributionParameters.icon; this.disabledIcon = contributionParameters.disabledIcon; this.hoverIcon = contributionParameters.hoverIcon; this.label = contributionParameters.label; this.mnemonic = contributionParameters.mnemonic; this.tooltip = contributionParameters.tooltip; this.style = contributionParameters.style; this.helpContextId = contributionParameters.helpContextId; this.visibleEnabled = contributionParameters.visibleEnabled; this.mode = contributionParameters.mode; menuService = (IMenuService) contributionParameters.serviceLocator.getService(IMenuService.class); commandService = (ICommandService) contributionParameters.serviceLocator.getService(ICommandService.class); handlerService = (IHandlerService) contributionParameters.serviceLocator.getService(IHandlerService.class); bindingService = (IBindingService) contributionParameters.serviceLocator.getService(IBindingService.class); IWorkbenchLocationService workbenchLocationService = (IWorkbenchLocationService) contributionParameters.serviceLocator .getService(IWorkbenchLocationService.class); display = workbenchLocationService.getWorkbench().getDisplay(); createCommand(contributionParameters.commandId, contributionParameters.parameters); if (command != null) { setImages(contributionParameters.serviceLocator, contributionParameters.iconStyle); if (contributionParameters.helpContextId == null) { try { this.helpContextId = commandService.getHelpContextId(contributionParameters.commandId); } catch (NotDefinedException e) { // it's OK to not have a helpContextId } } IWorkbenchLocationService wls = (IWorkbenchLocationService) contributionParameters.serviceLocator .getService(IWorkbenchLocationService.class); final IWorkbench workbench = wls.getWorkbench(); if (workbench != null && helpContextId != null) { this.workbenchHelpSystem = workbench.getHelpSystem(); } } } /** * Create a CommandContributionItem to place in a ContributionManager. * * @param serviceLocator * a service locator that is most appropriate for this contribution. * Typically the local {@link IWorkbenchWindow} or {@link * IWorkbenchPartSite} will be sufficient. * @param id * The id for this item. May be <code>null</code>. Items without an id * cannot be referenced later. * @param commandId * A command id for a defined command. Must not be <code>null</code>. * @param parameters * A map of strings to strings which represent parameter names to * values. The parameter names must match those in the command * definition. * @param icon * An icon for this item. May be <code>null</code>. * @param disabledIcon * A disabled icon for this item. May be <code>null</code>. * @param hoverIcon * A hover icon for this item. May be <code>null</code>. * @param label * A label for this item. May be <code>null</code>. * @param mnemonic * A mnemonic for this item to be applied to the label. May be * <code>null</code>. * @param tooltip * A tooltip for this item. May be <code>null</code>. Tooltips are * currently only valid for toolbar contributions. * @param style * The style of this menu contribution. See the STYLE_* contants. * @deprecated create the {@link CommandContributionItemParameter} */ public CommandContributionItem(IServiceLocator serviceLocator, String id, String commandId, Map parameters, ImageDescriptor icon, ImageDescriptor disabledIcon, ImageDescriptor hoverIcon, String label, String mnemonic, String tooltip, int style) { this(new CommandContributionItemParameter(serviceLocator, id, commandId, parameters, icon, disabledIcon, hoverIcon, label, mnemonic, tooltip, style, null, false)); } private void setImages(IServiceLocator locator, String iconStyle) { if (icon == null) { ICommandImageService service = (ICommandImageService) locator.getService(ICommandImageService.class); icon = service.getImageDescriptor(command.getId(), ICommandImageService.TYPE_DEFAULT, iconStyle); disabledIcon = service.getImageDescriptor(command.getId(), ICommandImageService.TYPE_DISABLED, iconStyle); hoverIcon = service.getImageDescriptor(command.getId(), ICommandImageService.TYPE_HOVER, iconStyle); if (contributedIcon == null) contributedIcon = icon; if (contributedDisabledIcon == null) contributedDisabledIcon = disabledIcon; if (contributedHoverIcon == null) contributedHoverIcon = hoverIcon; } } private ICommandListener getCommandListener() { if (commandListener == null) { commandListener = new ICommandListener() { public void commandChanged(CommandEvent commandEvent) { if (commandEvent.isHandledChanged() || commandEvent.isEnabledChanged() || commandEvent.isDefinedChanged()) { updateCommandProperties(commandEvent); } } }; } return commandListener; } private void updateCommandProperties(final CommandEvent commandEvent) { if (commandEvent.isHandledChanged()) { dropDownMenuOverride = null; } Runnable update = new Runnable() { public void run() { if (commandEvent.isEnabledChanged() || commandEvent.isHandledChanged()) { if (visibleEnabled) { IContributionManager parent = getParent(); if (parent != null) { parent.update(true); } } IHandler handler = commandEvent.getCommand().getHandler(); if (shouldRestoreAppearance(handler)) { label = contributedLabel; icon = contributedIcon; disabledIcon = contributedDisabledIcon; hoverIcon = contributedHoverIcon; } } if (commandEvent.getCommand().isDefined()) { update(null); } } }; if (display.getThread() == Thread.currentThread()) { update.run(); } else { display.asyncExec(update); } } private boolean shouldRestoreAppearance(IHandler handler) { // if no handler or handler doesn't implement IElementUpdater, // restore the contributed elements if (handler == null) return true; if (!(handler instanceof IElementUpdater)) return true; // special case, if its HandlerProxy, then check the actual handler if (handler instanceof HandlerProxy) { HandlerProxy handlerProxy = (HandlerProxy) handler; IHandler actualHandler = handlerProxy.getHandler(); return shouldRestoreAppearance(actualHandler); } return false; } /** * Returns the ParameterizedCommand for this contribution. * <p> * <strong>NOTE:</strong> The returned object should be treated as * 'read-only', do <b>not</b> execute this instance or attempt to modify its * state. * </p> * * @return The parameterized command for this contribution. * * @since 3.5 */ public ParameterizedCommand getCommand() { return command; } void createCommand(String commandId, Map parameters) { if (commandId == null) { StatusManager.getManager() .handle(StatusUtil.newStatus(IStatus.ERROR, "Unable to create menu item \"" + getId() //$NON-NLS-1$ + "\", no command id", null)); //$NON-NLS-1$ return; } Command cmd = commandService.getCommand(commandId); if (!cmd.isDefined()) { StatusManager.getManager() .handle(StatusUtil.newStatus(IStatus.ERROR, "Unable to create menu item \"" + getId() //$NON-NLS-1$ + "\", command \"" + commandId + "\" not defined", null)); //$NON-NLS-1$ //$NON-NLS-2$ return; } command = ParameterizedCommand.generateCommand(cmd, parameters); } /* * (non-Javadoc) * * @see * org.eclipse.jface.action.ContributionItem#fill(org.eclipse.swt.widgets * .Menu, int) */ public void fill(Menu parent, int index) { if (command == null) { return; } if (widget != null || parent == null) { return; } // Menus don't support the pulldown style int tmpStyle = style; if (tmpStyle == STYLE_PULLDOWN) tmpStyle = STYLE_PUSH; MenuItem item = null; if (index >= 0) { item = new MenuItem(parent, tmpStyle, index); } else { item = new MenuItem(parent, tmpStyle); } item.setData(this); if (workbenchHelpSystem != null) { workbenchHelpSystem.setHelp(item, helpContextId); } item.addListener(SWT.Dispose, getItemListener()); item.addListener(SWT.Selection, getItemListener()); widget = item; update(null); updateIcons(); establishReferences(); } /* (non-Javadoc) * @see org.eclipse.jface.action.ContributionItem#fill(org.eclipse.swt.widgets.Composite) */ public void fill(Composite parent) { if (command == null) { return; } if (widget != null || parent == null) { return; } // Buttons don't support the pulldown style int tmpStyle = style; if (tmpStyle == STYLE_PULLDOWN) tmpStyle = STYLE_PUSH; Button item = new Button(parent, tmpStyle); item.setData(this); if (workbenchHelpSystem != null) { workbenchHelpSystem.setHelp(item, helpContextId); } item.addListener(SWT.Dispose, getItemListener()); item.addListener(SWT.Selection, getItemListener()); widget = item; update(null); updateIcons(); establishReferences(); } /* * (non-Javadoc) * * @see * org.eclipse.jface.action.ContributionItem#fill(org.eclipse.swt.widgets * .ToolBar, int) */ public void fill(ToolBar parent, int index) { if (command == null) { return; } if (widget != null || parent == null) { return; } ToolItem item = null; if (index >= 0) { item = new ToolItem(parent, style, index); } else { item = new ToolItem(parent, style); } item.setData(this); item.addListener(SWT.Selection, getItemListener()); item.addListener(SWT.Dispose, getItemListener()); widget = item; update(null); updateIcons(); establishReferences(); } /* * (non-Javadoc) * * @see org.eclipse.jface.action.ContributionItem#update() */ public void update() { update(null); } /* * (non-Javadoc) * * @see org.eclipse.jface.action.ContributionItem#update(java.lang.String) */ public void update(String id) { if (widget != null) { if (widget instanceof MenuItem) { updateMenuItem(); } else if (widget instanceof ToolItem) { updateToolItem(); } else if (widget instanceof Button) { updateButton(); } } } private void updateMenuItem() { MenuItem item = (MenuItem) widget; String text = label; if (text == null) { if (command != null) { try { text = command.getCommand().getName(); } catch (NotDefinedException e) { StatusManager.getManager().handle(StatusUtil.newStatus(IStatus.ERROR, "Update item failed " //$NON-NLS-1$ + getId(), e)); } } } text = updateMnemonic(text); String keyBindingText = null; if (command != null) { TriggerSequence binding = bindingService.getBestActiveBindingFor(command); if (binding != null) { keyBindingText = binding.format(); } } if (text != null) { if (keyBindingText == null) { item.setText(text); } else { item.setText(text + '\t' + keyBindingText); } } if (item.getSelection() != checkedState) { item.setSelection(checkedState); } // allow the handler update its enablement boolean shouldBeEnabled = isEnabled(); // disabled command + visibility follows enablement == disposed if (!item.isDisposed() && item.getEnabled() != shouldBeEnabled) { item.setEnabled(shouldBeEnabled); } } private void updateToolItem() { ToolItem item = (ToolItem) widget; String text = label; if (text == null) { if (command != null) { try { text = command.getCommand().getName(); } catch (NotDefinedException e) { StatusManager.getManager().handle(StatusUtil.newStatus(IStatus.ERROR, "Update item failed " //$NON-NLS-1$ + getId(), e)); } } } if ((icon == null || (mode & MODE_FORCE_TEXT) == MODE_FORCE_TEXT) && text != null) { item.setText(text); } String toolTipText = getToolTipText(text); item.setToolTipText(toolTipText); if (item.getSelection() != checkedState) { item.setSelection(checkedState); } // allow the handler update its enablement boolean shouldBeEnabled = isEnabled(); // disabled command + visibility follows enablement == disposed if (!item.isDisposed() && item.getEnabled() != shouldBeEnabled) { item.setEnabled(shouldBeEnabled); } } private void updateButton() { Button item = (Button) widget; String text = label; if (text == null) { if (command != null) { try { text = command.getCommand().getName(); } catch (NotDefinedException e) { StatusManager.getManager().handle(StatusUtil.newStatus(IStatus.ERROR, "Update item failed " //$NON-NLS-1$ + getId(), e)); } } } if (text != null) { item.setText(text); } String toolTipText = getToolTipText(text); item.setToolTipText(toolTipText); if (item.getSelection() != checkedState) { item.setSelection(checkedState); } // allow the handler update its enablement boolean shouldBeEnabled = isEnabled(); // disabled command + visibility follows enablement == disposed if (!item.isDisposed() && item.getEnabled() != shouldBeEnabled) { item.setEnabled(shouldBeEnabled); } } private String getToolTipText(String text) { String tooltipText = tooltip; if (tooltip == null) if (text != null) tooltipText = text; else tooltipText = ""; //$NON-NLS-1$ TriggerSequence activeBinding = bindingService.getBestActiveBindingFor(command); if (activeBinding != null && !activeBinding.isEmpty()) { String acceleratorText = activeBinding.format(); if (acceleratorText != null && acceleratorText.length() != 0) { tooltipText = NLS.bind(CommandMessages.Tooltip_Accelerator, tooltipText, acceleratorText); } } return tooltipText; } private String updateMnemonic(String s) { if (mnemonic == null || s == null) { return s; } int idx = s.indexOf(mnemonic); if (idx == -1) { return s; } return s.substring(0, idx) + '&' + s.substring(idx); } private void handleWidgetDispose(Event event) { if (event.widget == widget) { disconnectReferences(); widget.removeListener(SWT.Selection, getItemListener()); widget.removeListener(SWT.Dispose, getItemListener()); widget = null; disposeOldImages(); } } public void setParent(IContributionManager parent) { super.setParent(parent); if (parent == null) disconnectReferences(); } private void establishReferences() { if (command != null) { UIElement callback = new UIElement(serviceLocator) { public void setChecked(boolean checked) { CommandContributionItem.this.setChecked(checked); } public void setDisabledIcon(ImageDescriptor desc) { CommandContributionItem.this.setDisabledIcon(desc); } public void setHoverIcon(ImageDescriptor desc) { CommandContributionItem.this.setHoverIcon(desc); } public void setIcon(ImageDescriptor desc) { CommandContributionItem.this.setIcon(desc); } public void setText(String text) { CommandContributionItem.this.setText(text); } public void setTooltip(String text) { CommandContributionItem.this.setTooltip(text); } public void setDropDownId(String id) { dropDownMenuOverride = id; } }; try { elementRef = commandService.registerElementForCommand(command, callback); } catch (NotDefinedException e) { StatusManager.getManager() .handle(StatusUtil.newStatus(IStatus.ERROR, "Unable to register menu item \"" + getId() //$NON-NLS-1$ + "\", command \"" + command.getId() + "\" not defined", //$NON-NLS-1$ //$NON-NLS-2$ null)); } command.getCommand().addCommandListener(getCommandListener()); } bindingService.addBindingManagerListener(bindingManagerListener); } private void disconnectReferences() { if (elementRef != null) { commandService.unregisterElement(elementRef); elementRef = null; } if (commandListener != null) { command.getCommand().removeCommandListener(commandListener); commandListener = null; } if (bindingService != null) { bindingService.removeBindingManagerListener(bindingManagerListener); } } /* * (non-Javadoc) * * @see org.eclipse.jface.action.ContributionItem#dispose() */ public void dispose() { if (widget != null) { widget.dispose(); widget = null; } disconnectReferences(); command = null; commandService = null; bindingService = null; menuService = null; handlerService = null; disposeOldImages(); super.dispose(); } private void disposeOldImages() { if (localResourceManager != null) { localResourceManager.dispose(); localResourceManager = null; } } private Listener getItemListener() { if (menuItemListener == null) { menuItemListener = new Listener() { public void handleEvent(Event event) { switch (event.type) { case SWT.Dispose: handleWidgetDispose(event); break; case SWT.Selection: if (event.widget != null) { handleWidgetSelection(event); } break; } } }; } return menuItemListener; } private void handleWidgetSelection(Event event) { // Special check for ToolBar dropdowns... if (openDropDownMenu(event)) return; if ((style & (SWT.TOGGLE | SWT.CHECK)) != 0) { if (event.widget instanceof ToolItem) { checkedState = ((ToolItem) event.widget).getSelection(); } else if (event.widget instanceof MenuItem) { checkedState = ((MenuItem) event.widget).getSelection(); } } try { handlerService.executeCommand(command, event); } catch (ExecutionException e) { StatusManager.getManager().handle(StatusUtil.newStatus(IStatus.ERROR, "Failed to execute item " //$NON-NLS-1$ + getId(), e)); } catch (NotDefinedException e) { StatusManager.getManager().handle(StatusUtil.newStatus(IStatus.ERROR, "Failed to execute item " //$NON-NLS-1$ + getId(), e)); } catch (NotEnabledException e) { StatusManager.getManager().handle(StatusUtil.newStatus(IStatus.ERROR, "Failed to execute item " //$NON-NLS-1$ + getId(), e)); } catch (NotHandledException e) { StatusManager.getManager().handle(StatusUtil.newStatus(IStatus.ERROR, "Failed to execute item " //$NON-NLS-1$ + getId(), e)); } } /** * Determines if the selection was on the dropdown affordance and, if so, * opens the drop down menu (populated using the same id as this item... * * @param event * The <code>SWT.Selection</code> event to be tested * * @return <code>true</code> iff a drop down menu was opened */ private boolean openDropDownMenu(Event event) { Widget item = event.widget; if (item != null) { int style = item.getStyle(); if ((style & SWT.DROP_DOWN) != 0) { if (event.detail == 4) { // on drop-down button ToolItem ti = (ToolItem) item; final MenuManager menuManager = new MenuManager(); Menu menu = menuManager.createContextMenu(ti.getParent()); if (workbenchHelpSystem != null) { workbenchHelpSystem.setHelp(menu, helpContextId); } menuManager.addMenuListener(new IMenuListener2() { public void menuAboutToShow(IMenuManager manager) { String id = getId(); if (dropDownMenuOverride != null) { id = dropDownMenuOverride; } menuService.populateContributionManager(menuManager, "menu:" + id); //$NON-NLS-1$ } public void menuAboutToHide(IMenuManager manager) { display.asyncExec(new Runnable() { public void run() { menuService.releaseContributions(menuManager); menuManager.dispose(); } }); } }); // position the menu below the drop down item Point point = ti.getParent().toDisplay(new Point(event.x, event.y)); menu.setLocation(point.x, point.y); // waiting for SWT // 0.42 menu.setVisible(true); return true; // we don't fire the action } } } return false; } private void setIcon(ImageDescriptor desc) { icon = desc; updateIcons(); } private void updateIcons() { if (widget instanceof MenuItem) { MenuItem item = (MenuItem) widget; LocalResourceManager m = new LocalResourceManager(JFaceResources.getResources()); try { item.setImage(icon == null ? null : m.createImage(icon)); } catch (DeviceResourceException e) { icon = ImageDescriptor.getMissingImageDescriptor(); item.setImage(m.createImage(icon)); // as we replaced the failed icon, log the message once. StatusManager.getManager() .handle(new Status(IStatus.ERROR, WorkbenchPlugin.PI_WORKBENCH, "Failed to load image", e)); //$NON-NLS-1$ } disposeOldImages(); localResourceManager = m; } else if (widget instanceof ToolItem) { ToolItem item = (ToolItem) widget; LocalResourceManager m = new LocalResourceManager(JFaceResources.getResources()); item.setDisabledImage(disabledIcon == null ? null : m.createImage(disabledIcon)); item.setHotImage(hoverIcon == null ? null : m.createImage(hoverIcon)); item.setImage(icon == null ? null : m.createImage(icon)); disposeOldImages(); localResourceManager = m; } } private void setText(String text) { label = text; update(null); } private void setChecked(boolean checked) { if (checkedState == checked) { return; } checkedState = checked; if (widget instanceof MenuItem) { ((MenuItem) widget).setSelection(checkedState); } else if (widget instanceof ToolItem) { ((ToolItem) widget).setSelection(checkedState); } } private void setTooltip(String text) { tooltip = text; if (widget instanceof ToolItem) { ((ToolItem) widget).setToolTipText(text); } } private void setDisabledIcon(ImageDescriptor desc) { disabledIcon = desc; updateIcons(); } private void setHoverIcon(ImageDescriptor desc) { hoverIcon = desc; updateIcons(); } /* * (non-Javadoc) * * @see org.eclipse.jface.action.ContributionItem#isEnabled() */ public boolean isEnabled() { if (command != null) { command.getCommand().setEnabled(menuService.getCurrentState()); return command.getCommand().isEnabled(); } return false; } /** * @since 3.4 */ public boolean isVisible() { if (visibleEnabled) { return super.isVisible() && isEnabled(); } return super.isVisible(); } private IBindingManagerListener bindingManagerListener = new IBindingManagerListener() { public void bindingManagerChanged(BindingManagerEvent event) { if (event.isActiveBindingsChanged() && event.isActiveBindingsChangedFor(getCommand())) { update(); } } }; /** * Provide info on the rendering data contained in this item. * * @return a {@link CommandContributionItemParameter}. Valid fields are * serviceLocator, id, style, icon, disabledIcon, hoverIcon, label, * helpContextId, mnemonic, tooltip. The Object will never be * <code>null</code>, although any of the fields may be * <code>null</code>. * @since 3.100 */ public CommandContributionItemParameter getData() { CommandContributionItemParameter data = new CommandContributionItemParameter(serviceLocator, getId(), null, style); data.icon = contributedIcon; data.disabledIcon = contributedDisabledIcon; data.hoverIcon = contributedHoverIcon; data.label = contributedLabel; data.helpContextId = helpContextId; data.mnemonic = mnemonic; data.tooltip = tooltip; return data; } }