Definiowanie kompozycji wprowadzenia

Kompozycja określa ogólny wygląd wprowadzenia. Jest to po prostu sposób grupowania wszystkich plików prezentacji (stylów i obrazów) w jednej lokalizacji, na którą można wskazać lub przełączyć.

Definicja

Aby zdefiniować kompozycję, rozszerz konfigurację wprowadzenia przy użyciu wtyczki org.eclipse.ui.intro.configExtension i użyj elementu theme tak, jak pokazano w poniższym przykładzie:

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

Zajrzyj do dokumentacji schematów, aby uzyskać szczegółowe informacje na temat wszystkich dostępnych atrybutów związanych z kompozycjami.

Każda kompozycja ma unikalny identyfikator, nazwę, którą można przetłumaczyć, obraz podglądu oraz ścieżkę do głównego folderu kompozycji. Wtyczka wprowadzenia nie udostępnia żadnego interfejsu użytkownika do obsługi kompozycji. Jedynym sposobem wyboru kompoozycji jest skorzystanie z preferencji org.eclipse.ui.intro/INTRO_THEME w pliku plugin_customization.ini.

Włączanie kompozycji

Obsługa kompozycji sama w sobie nie powoduje, że implementacje wprowadzenia będą korzystać z kompozycji. Konkretne implementacje wprowadzenia mogą udostępniać kompozycje w bardziej istotny sposób (w rzeczywistości implementacja Uniwersalnego powitania dokładnie w ten sposób obsługuje stronę preferencji Ogólne> Powitanie

Wyposażone w kompozycje implementacje wprowadzenia muszą korzystać ze zmiennej podstawienia $theme$ przy odwoływaniu się do stylu i zasobów prezentacji. Ścieżki bezwzględne do obrazów, stron, stylów itp. będą tworzone przez interpretowanie zmiennej podstawienia przy użyciu ścieżki bieżącej aktywnej kompozycji.