The images extension point provides a way of linking different types of images and icons to a particular command. These images can be used, as appropriate, wherever the command appears in the user interface. To accommodate some boundary cases (e.g., tool bar drop-down items), it is possible to group the images for a particular commands into "styles". These styles can then be specifically requested when a command is to be displayed.
Commands placed in menus using the org.eclipse.ui.menus extension point will use the default image if available, and commands placed in a toolbar will use the
toolbar style images if available, followed by the default images.
<!ELEMENT extension (image*)>
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT image EMPTY>
commandId IDREF #REQUIRED
icon CDATA #REQUIRED
disabledIcon CDATA #IMPLIED
hoverIcon CDATA #IMPLIED
style CDATA #IMPLIED>
The images to associate with a particular command.
ISharedImagesconstant. This will appear when the icon is enabled and mouse is not hovering over it. It will also be used in any situation where such a more specific icon is not available.
toolbarstyle for toolbar contributions. If no
toolbarentry is available for that command, it uses the default style.
<extension point="org.eclipse.ui.commandImages"> <image commandId="org.eclipse.example.ProfileLast" hoverIcon="icons/full/etool16/profile.gif" disabledIcon="icons/full/dtool16/profile.gif" icon="icons/full/etool16/profile.gif" /> <image commandId="org.eclipse.example.ProfileLast" hoverIcon="icons/full/etool16/history.gif" disabledIcon="icons/full/dtool16/history.gif" icon="icons/full/etool16/history.gif" style="toolbar" /> </extension>
Within the workbench, it is possible to get images for commands using the
org.eclipse.ui.commands.ICommandImageService interface. This interface can be retrieved from supporting workbench objects, such as
IWorkbench itself, the
IWorkbenchWindow, or the
IWorkbenchPartSite. To retrieve the service, you would make a call like
Copyright (c) 2005,2007 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