Inleidingsthema's definiëren

Een thema definieert de algehele presentatie van de inleiding. Op deze manier worden alle presentatiebestanden (stijlen en afbeeldingen) op een centrale locatie gegroepeerd in een thema waarnaar kan worden verwezen of die in zijn geheel kan worden ingeschakeld.

Definitie

Om een thema te definiëren, breidt u de configuratie van de inleiding uit met org.eclipse.ui.intro.configExtension en gebruikt u het element theme zoals in het onderstaande voorbeeld is aangegeven:

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

Raadpleeg de schemadocumentatie voor gedetailleerde informatie over alle beschikbare kenmerken die betrekking hebben op thema's.

Elk thema is gekoppeld aan een uniek ID, vertaalbare naam, previewafbeelding en een pad naar de hoofdmap voor thema's. De inleidingsplugin levert geen gebruikersinterface om thema's te bewerken. De enige manier om een thema te selecteren is via de voorkeur org.eclipse.ui.intro/INTRO_THEME in plugin_customization.ini.

Thema's activeren

Themaondersteuning op zichzelf maakt thema's nog niet actief in geïmplementeerde inleidingen. In concrete inleidingsimplementaties kunnen thema's op meer substantiële wijze worden geactiveerd (dit is in feite precies wat er gebeurt als u een universele welkomstpagina implementeert via de voorkeurenpagina Algemeen > Welkom.

In een inleidingsimplementatie met thema's moet naar alle stijl- en presentatieresources worden verwezen met de vervangingsvariabele $theme$. De absolute paden naar afbeeldingen, pagina's, stijlen, enzovoort worden berekend door de variabele te vervangen door het pad van het actieve thema.