Imagens de Comandos

org.eclipse.ui.commandImages

3.2

O ponto de extensão de imagens fornece uma maneira de vincular diferentes tipos de imagens e ícones a um determinado comando. Essas imagens poderão ser utilizadas, conforme apropriado, sempre que o comando aparecer na interface com o usuário. Para ajustar alguns casos de limite (por exemplo, itens drop-down da barra de ferramentas), é possível agrupar em "estilos" as imagens de determinados comandos. Esses estilos então poderão ser especificamente solicitados quando um comando for exibido.

<!ELEMENT extension (image*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT image EMPTY>

<!ATTLIST image

commandId    CDATA #REQUIRED

icon         CDATA #REQUIRED

disabledIcon CDATA #IMPLIED

hoverIcon    CDATA #IMPLIED

style        CDATA #IMPLIED>

As imagens a serem associadas a um determinado comando.



<extension point=

"org.eclipse.ui.commandsImages"

>

<image commandId=

"ProfileLast"

hoverIcon=

"icons/full/etool16/profile.gif"

disabledIcon=

"icons/full/dtool16/profile.gif"

icon=

"icons/full/etool16/profile.gif"

/>

<image commandId=

"ProfileLast"

hoverIcon=

"icons/full/etool16/history.gif"

disabledIcon=

"icons/full/dtool16/history.gif"

icon=

"icons/full/etool16/history.gif"

imageStyle=

"toolbar"

/>

</extension>

No workbench, é possível obter imagens para comandos utilizando a interface org.eclipse.ui.handlers.ICommandImageService. Essa interface pode ser recuperada de objetos que suportam o workbench, como o próprio IWorkbench. Para recuperar o serviço, você faria uma chamada como IWorkbench.getAdapter(ICommandImageService.class).