Definindo Temas de Introdução

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.

Definição

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.

Ativando Temas

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.