Definir temas da introdução

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.

Definição

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.

Activar temas

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.