Een product aanpassen

Er zijn verschillende aspecten van producten die kunnen worden aangepast, bijvoorbeeld beginschermen, de tekst van het Info-dialoogvenster, Vensterafbeeldingen, enzovoort. De meeste van deze aanpassingen worden gedefinieerd in de bijdrage aan het extensiepunt org.eclipse.core.runtime.products.

Hoe worden een aantal van de meer algemene elementen die kunnen worden aangepast, gedefinieerd?

Info-dialoogvensters

Het dialoogvenster "Info" van het platform wordt afgebeeld als de gebruiker Help > Info selecteert in het workbenchmenu.  

Info-dialoogvenster

In het bovenste gedeelte van het dialoogvenster wordt informatie afgebeeld op productniveau en in het onderste gedeelte wordt informatie afgebeeld over de geïnstalleerde features (indien aanwezig) en plugins.  De featuregegevens (eventueel merknamen) worden geleverd met behulp van de bestanden about.ini, about.properties en about.html in de plugin die gekoppeld is aan de feature.  Deze informatie wordt weergegeven als de gebruiker om de featuregegevens vraagt en een bepaalde feature selecteert.

De merknaam van het product (bovenste helft van het dialoogvenster) wordt opgegeven in de extensie-eigenschappen die de tekst en de afbeeldingen beschrijven die in dit dialoogvenster worden afgebeeld. Zie bijvoorbeeld het volgende uittreksel uit de productdeclaratie van het Eclipse-platform.

	<property
		name="aboutText"
		value="%aboutText"/>
	<property
		name="aboutImage"
		value="icons/eclipse_lg.png"/>
	</product>

Zie IProductConstants voor meer informatie over deze eigenschappen.

Vensterafbeeldingen

Een 16x16-pixels-kleurenafbeelding kan worden gebruikt om de vensters te markeren die door het product zijn gemaakt.  Deze verschijnt in de linkerbovenhoek van de productvensters.  De afbeelding wordt opgegeven in het windowImage-kenmerk in de extensiedefinitie van de producten. Ook kan het windowImages-kenmerk worden gebruikt om een reeks van afbeeldingen met verschillende afmetingen te beschrijven die in de linkerbovenhoek worden gebruikt.

	<property
		name="windowImages"
		value="icons/eclipse.png,icons/eclipse32.png"/>

Als beide zijn opgegeven heeft de eigenschap windowImages voorrang op de eigenschap windowImage.

Welkomstpagina

De producten die het welkomstpaginamechanisme van Eclipse 2.1 gebruiken, kunnen de naam en locatie van het welkomstpaginabestand opgeven in de eigenschap welcomePage.

	<property
		name="welcomePage"
		value="$nl$/welcome.xml"/>

Het gebruik van deze eigenschap wordt ontmoedigd en u kunt nu in plaats hiervan het extensiepunt org.eclipse.ui.intro gebruiken. Zie Welkom/Intro ondersteuning voor meer informatie over de nieuwe welkomst-/intro-mechanismen.

Standaardinstellingen voorkeuren

De eigenschap preferenceCustomization kan worden gebruikt om een bestand op te geven dat standaardvoorkeurswaarden bevat voor het product.

	<property
		name="preferenceCustomization"
		value="plugin_customization.ini"/>

Dit is een bestand met de indeling java.io.Properties. Dit bestand wordt gebruikt om de waarden in te stellen van de voorkeuren die zijn gepubliceerd als onderdeel van de openbare API van een plugin.  Dit betekent dat u een risico neemt als u naar voorkeuren verwijst die door plugins worden gebruikt en niet formeel zijn gedefinieerd in de API.   

Beginschermen

Het beginscherm van het product wordt opgegeven in config.ini dat zich onder de configuratie-directory van het product bevindt. Door de osgi.splashPath-eigenschap in dit bestand worden de plaatsen beschreven waar kan worden gezocht naar een bestand met de naam splash.bmp. De osgi.splashLocation-eigenschap geeft een volledig pad aan naar het beginschermbestand dat moet worden gebruikt. Het opgeven van een beginschermpad maakt het mogelijk locale-specifieke beginschermen te gebruiken omdat het opgegeven zoekpad verschillende plugins of fragmenten kan aangeven die moeten worden doorzocht en ook paden in de stijl $nl$. Zie het bestand config.ini van de platform-SDK voor een volledige beschrijving van de eigenschappen die in dit bestand kunnen worden geconfigureerd. De afbeelding wordt geleverd in 24-bit-kleuren in BMP-indeling (RGB-indeling) en heeft een grootte van ongeveer 500x330 pixels.

De locatie, grootte en kleur van de voortgangsindicator en het voortgangsbericht worden tijdens het opstarten weergegeven in het beginscherm en kunnen worden geconfigureerd met behulp van de eigenschappen startupProgressRect, startupMessageRect en startupForegroundColor. Zie IProductConstants voor meer informatie over deze eigenschappen. Standaard wordt de voortgang niet gerapporteerd bij het opstarten. Als u de voortgang wilt laten rapporteren bij het opstarten, stelt u de volgende voorkeur in op true (waar), bijvoorbeeld in het aanpassingsbestand voor voorkeuren: IWorkbenchPreferenceConstants.SHOW_PROGRESS_ON_STARTUP