Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 

Eclipse Plug-in Developer Guide
Previous Page Home Next Page

Command Images

Identifier:
org.eclipse.ui.commandImages

Since:
3.2

Description:

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.

Configuration Markup:

<!ELEMENT extension ( image*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED

>


<!ELEMENT image EMPTY>

<!ATTLIST image

commandId    IDREF #REQUIRED

icon         CDATA #REQUIRED

disabledIcon CDATA #IMPLIED

hoverIcon    CDATA #IMPLIED

style        CDATA #IMPLIED

>

The images to associate with a particular command.


  • commandId - The identifier of the command with which the images should be associated.
  • icon - The path to the icon which should be used in the default case, or the ISharedImages constant. 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.
  • disabledIcon - The icon to display when the command is disabled.
  • hoverIcon - The icon to display when the user is hovering over the command.
  • style - The particular scenario in which this block of icons apply. For example, it may be desirable to have different icons when the command is displayed as a toolbar drop-down item. Currently the org.eclipse.ui.menus extension will use the default style (no style) for menu icons and the toolbar style for toolbar contributions. If no toolbar entry is available for that command, it uses the default style.

Examples:

<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>


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 https://www.eclipse.org/legal/epl-v10.html


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire