Définition de thèmes d'introduction

Un thème définit l'apparence globale de l'introduction. Il permet simplement de regrouper les fichiers de présentation (styles et images) à un seul emplacement, qu'il est possible de pointer ou de sélectionner séparément.

Définition

Pour définir un thème, étendez la configuration d'introduction à l'aide de org.eclipse.ui.intro.configExtension et utilisez l'élément theme, comme dans l'exemple ci-dessous :

   <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>

Consultez la section Documentation du schéma pour plus d'informations sur les attributs disponibles relatifs aux thèmes.

Chaque thème possède un identificateur unique, un nom convertible, une image d'aperçu et un chemin d'accès au dossier du thème racine. Le plug-in intro ne fournit pas d'interface utilisateur pour la gestion des thèmes. La seule manière de sélectionner un thème est par le biais de la préférence org.eclipse.ui.intro/INTRO_THEME dans le fichier plugin_customization.ini.

Activation des thèmes

Le support des thèmes proprement dit ne permet pas d'implémentations d'intro activées par un thème. Les implémentations d'intro concrètes peuvent choisir de présenter les thèmes de manière plus étoffée (et en réalité, l'implémentation Universal Welcome procède exactement de la même manière avec la Général > Bienvenue Page de préférences.

L'implémentation d'intro activée par un thème doit effectuer toutes les références aux ressources de présentation et de style à l'aide de la variable de substitution $theme$. Les chemins absolus des images, pages, styles, etc. seront calculés en convertissant la variable de substitution à l'aide du chemin du thème actif.