Um tema define a aparência geral da introdução. É simplesmente uma maneira de agrupar todos os arquivos de apresentação (estilos e imagens) em um só local que pode ser apontado ou mudado, conjuntamente.
Para definir um tema, estenda a configuração de introdução utilizando o
org.eclipse.ui.intro.configExtension
e use o elemento theme
,
conforme mostrado no exemplo a seguir:
<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>
Consulte a documentação de esquema para obter detalhes sobre todos os atributos disponíveis relacionados a temas.
Cada tema tem um identificador exclusivo, um nome traduzível, uma imagem de
visualização e um caminho para a pasta do tema raiz. O plug-in de introdução não fornece
nenhuma UI para manipulação de tema. A única maneira de selecionar um tema é por meio
da preferência org.eclipse.ui.intro/INTRO_THEME
em plugin_customization.ini.
O suporte de tema sozinho não faz implementações de introdução ativadas por tema. Implementações
de introdução concretas podem optar por expor os temas de maneira mais substancial, e de
fato a implementação de Boas-vindas Universais faz exatamente isso com a página de
preferências
Geral > Bem-vindo.
A implementação de introdução ativada por tema deve fazer todas as referências a recursos
de estilo e apresentação, utilizando a variável de substituição $theme$
. Caminhos
absolutos para imagens, páginas, estilos etc. serão calculados pela resolução da variável
de substituição utilizando o caminho do tema ativo atualmente.