Ein Thema definiert die gesamte Darstellung der Einführung. Mit einem Thema können alle Darstellungsdateien (Stile und Images) ohne großen Aufwand in einer gemeinsamen Position platziert werden, auf die verwiesen oder zu der gewechselt werden kann.
Um ein Thema zu definieren, erweitern Sie Ihre Einführungskonfiguration mit
org.eclipse.ui.intro.configExtension
, und verwenden Sie das Element theme
wie im folgenden Beispiel gezeigt:
<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>
Details zu allen verfügbaren Attributen für Themen finden Sie in der Schemadokumentation.
Jedes Thema besitzt eine eindeutige Kennung, einen übersetzbaren Namen, ein Image für die Vorschau und einen Pfad zum Stammordner des Themas. Das Einführungs-Plug-in stellt keine Benutzerschnittstelle für die Themenbearbeitung zur Verfügung. Die einzige Möglichkeit besteht darin, ein Thema über die Benutzervorgabe
org.eclipse.ui.intro/INTRO_THEME
in der Datei "plugin_customization.ini" auszuwählen.
Die Themenunterstützung selbst aktiviert Einführungsimplementierungen nicht für Themen.
Konkrete Einführungsimplementierungen können Themen auf eine nennenswertere Weise zugänglich machen
(was von der Implementierung für "Universal Welcome" auch exakt vorgenommen wird). Dies erfolgt auf der Benutzervorgabenseite
Allgemein > Willkommen.
Themenfähige Einführungsimplementierungen müssen alle Verweise auf Stil- und Darstellungsressourcen
mit der Substitutionsvariablen $theme$
machen. Absolute Pfade für Images, Seiten, Stile usw. werden berechnet, indem die Substitutionsvariable mit dem Pfad des gegenwärtig aktiven Themas aufgelöst wird.