Tilpas produkt

Der er mange aspekter af et produkt, der kan tilpasses, f.eks. åbningsskærmbilledet, Om-dialogbokstekst, vinduesikoner osv. De fleste af disse tilpasninger er defineret i leveringen til udvidelsespunktet org.eclipse.core.runtime.products.

I det følgende gennemgås, hvordan nogle af de mest almindelige elementer, som kan tilpasses, defineres.

About-dialogbokse

Platformens "Om"-dialogboks vises, hver gang brugeren vælger Hjælp > Om på arbejdsbænkens menu.   

Om-dialogboks

Den øverste del af Om-dialogboksen viser oplysninger om produktniveau, mens den nederste del viser oplysninger om de funktioner (hvis der er nogen) og plugins, der er installeret. Funktionsoplysninger (varemærkeoplysningerne) leveres vha. about.ini-, about.properties- og about.html-filerne i den plugin, der er knyttet til funktionen. Disse oplysninger vises, når brugeren anmoder om funktionsoplysninger og vælger en bestemt funktion.

Produktets varemærkeoplysninger (øverste halvdel af dialogboksen) angives vha. udvidelsesegenskaber, der beskriver teksten og billederne, der vises i denne dialogboks. Nedenstående er et uddrag fra Eclipse-platformens produkterklæring.

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

I IProductConstants finder du flere oplysninger om disse egenskaber.

Vinduesbilleder

Et farvebillede på 16 x 16 pixel kan bruges til at angive varemærkeoplysninger i de vinduer, der er oprettet af produktet. Det vises i øverste venstre hjørne af produktvinduer. Det angives i windowImage-attributten i produktets udvidelsesdefinition. Alternativt kan attributten windowImages bruges til at beskrives et array af billeder i forskellige størrelse, der skal bruges i øverste venstre hjørne.

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

Egenskaben windowImages har forrang over egenskaben windowImage, hvis begge er angivet.

Velkomstside

Produkter, der bruger velkomstsidemekanismen fra Eclipse 2.1, kan angive navnet og placeringen af velkomstsiden i egenskaben welcomePage.

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

Det frarådes at bruge denne egenskab til udvidelsespunktetorg.eclipse.ui.intro. I Velkomst/Introduktionsunderstøttelse finder du flere oplysninger om de nye velkomst/introduktionsmekanismer.

Standardværdier for indstillinger

Egenskaben preferenceCustomization kan bruges til at angive en fil, der indeholder standardindstillingsværdier for produktet.

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

Denne fil har formatet java.io.Properties. Denne fil bruges typisk til at angive værdierne for de indstillinger, der publiceres som en del af en plugins offentlige API. Dvs., at det er risikabelt, hvis du refererer til indstillinger, der bruges af plugins, men som ikke defineres formelt i API'et.  

Åbningsskærmbilleder

Produktets åbningsskærmbillede er angivet i config.ini, som er placeret under produktets konfigurationsbibliotek. Egenskaben osgi.splashPath i denne fil beskriver de steder, hvor der kan søges efter en fil med navnet splash.bmp. Egenskaben osgi.splashLocation identificerer en komplet og præcis sti til det åbningsskærmbillede, der skal bruges. Angivelse af en splash-sti gør det muligt for sprogspecifikke åbningsskærmbilleder at blive brugt, da den givne søgesti kan angive flere plugins eller fragmenter, der skal søges i, og stier af typen $nl$. I platform SDK'ens config.ini-fil finder du en komplet beskrivelse af de egenskaber, der kan konfigureres i denne fil. Billedet skal leveres i 24-bit BMP-farveformat (RGB format) og skal være ca. 500 x 330 pixel i størrelse.

Placering, størrelse og farve på statusindikatoren, der vises i åbningsskærmbilledet under start kan konfigureres med egenskaberne startupProgressRect, startupMessageRect og startupForegroundColor. I IProductConstants finder du flere oplysninger om disse egenskaber. Bemærk, at som standard rapporteres status ikke ved start. For at aktivere rapportering om forløbet af start,skal du angive følgende egenskab som true, f.eks. i tilpasningsfilen for indstillinger: IWorkbenchPreferenceConstants.SHOW_PROGRESS_ON_STARTUP