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