Einführungsthemen definieren

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.

Definition

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.

Themen aktivieren

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.