Um tema define a aparência global da introdução. Consiste simplesmente numa forma de agrupar todos os ficheiros de apresentação (estilos e imagens) numa localização que pode ser indicada ou comutada.
Para definir um tema, expanda a configuração da introdução através da
utilização de org.eclipse.ui.intro.configExtension
e utiliza o
elemento theme
, como é apresentado no exemplo seguinte:
<extension point="org.eclipse.ui.intro.configExtension"> <theme default="true" id="org.eclipse.ui.intro.universal.circles" name="%theme.name.circles" path="$nl$/themes/circles" previewImage="themes/circles/preview.png"> <property name="launchbarBackground" value="#a1c2cb"/> <property name="launchbarOverviewIcon" value="$theme$graphics/launchbar/overview16.png"/> <property name="launchbarFirststepsIcon" value="$theme$graphics/launchbar/firststeps16.png"/> <property name="launchbarTutorialsIcon" value="$theme$graphics/launchbar/tutorials16.png"/> <property name="launchbarSamplesIcon" value="$theme$graphics/launchbar/samples16.png"/> <property name="launchbarWhatsnewIcon" value="$theme$graphics/launchbar/whatsnew16.png"/> <property name="launchbarMigrateIcon" value="$theme$graphics/launchbar/migrate16.png"/> <property name="launchbarWebresourcesIcon" value="$theme$graphics/launchbar/webresources16.png"/> </theme> </extension>
para mais detalhes sobre os atributos disponíveis relacionados ao tema, consulte a documentação sobre o esquema.
Cada elemento contém um identificador único, um nome traduzível, uma imagem de
pré-visualização e um caminho para a pasta do tema raiz. O plug-in de
introdução não faculta qualquer UI para a manipulação do tema. A única forma de
seleccionar um tema é através da preferência
org.eclipse.ui.intro/INTRO_THEME
in plugin_customization.ini.
O suporte de tema não efectua implementações de introdução de tema activado por si só.
As implementações de introdução concretas podem seleccionar a opção de expor
temas de forma mais substancial (e, na verdade, a implementação Universal
Welcome efectua exactamente esse procedimento através da página de
preferências
Geral > bem-vindo.
A implementação de introdução de tema activado tem de efectuar todas as
referências ao estilo e à apresentação de recursos através da utilização da
variável de substituição $theme$
. Os caminhos absolutos para
imagens, páginas, estilos, etc. serão calculados ao processar a variável de
substituição através da utilização do caminho do tema actualmente activo.