Definir temas de la introducción

Un tema define el aspecto global de la introducción. Es simplemente una forma de agrupar todos los archivos de presentación (estilos e imágenes) en una ubicación a la que puede señalarse o a la que puede pasarse en una sola acción.

Definición

Para definir un tema, amplíe la configuración de la introducción mediante org.eclipse.ui.intro.configExtension y utilice el elemento theme como se muestra en el ejemplo siguiente:

   <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 la documentación de esquema para obtener detalles acerca de todos los atributos disponibles relacionados con los temas.

Cada tema tiene un identificador exclusivo, un nombre traducible, una imagen de vista previa y una vía de acceso a la carpeta de tema raíz. El plug-in de introducción no suministra ninguna UI para la manipulación de temas. El único modo de seleccionar un tema es por medio de la preferencia org.eclipse.ui.intro/INTRO_THEME del archivo plugin_customization.ini.

Habilitar temas

El soporte de temas no realiza por sí mismo implementaciones de introducción habilitadas para temas. Determinadas implementaciones de introducción pueden elegir exponer temas de forma más sustancial (de hecho, la implementación de la Bienvenida universal hace exactamente eso con la página de preferencias General > Bienvenida).

La implementación de introducciones habilitadas para temas debe establecer todas las preferencias de recursos de estilo y presentación mediante la variable de sustitución $theme$. Las vías de acceso absolutas de imágenes, páginas, estilos, etc. se calcularán resolviendo la variable de sustitución utilizando la vía de acceso del tema activo actualmente.