<!ELEMENT extension (theme* , colorDefinition* , fontDefinition* , themeElementCategory* , data* , categoryPresentationBinding*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT theme (colorOverride* , fontOverride* , description? , data*)>
<!ATTLIST theme
id CDATA #REQUIRED
name CDATA #IMPLIED>
Een verzameling lettertypen, kleuren en gegevens die de standaarden vervangen. Zulke collecties kunnen worden gebruikt om de presentatie van de workbench te wijzigen. Er kunnen veel themaelementen met hetzelfde ID bestaan. Hierdoor kunnen componentauteurs bijdragen aan bestaande thema's leveren.
<!ELEMENT themeElementCategory (description)>
<!ATTLIST themeElementCategory
id CDATA #REQUIRED
parentId CDATA #IMPLIED
class CDATA #IMPLIED
label CDATA #IMPLIED>
Een logische groepering van elementdefinities. Deze categorie kan kleuren en lettertypen bevatten.
org.eclipse.ui.themes.IThemePreview
implementeert.<!ELEMENT colorDefinition (colorFactory? , colorValue* , description?)>
<!ATTLIST colorDefinition
id CDATA #IMPLIED
label CDATA #REQUIRED
defaultsTo CDATA #IMPLIED
value CDATA #IMPLIED
categoryId CDATA #IMPLIED
colorFactory CDATA #IMPLIED
isEditable (true | false) >
Een symbolische kleurdefinitie.
defaultsTo
, value
en colorFactory
kan worden gedefinieerd. defaultsTo
, value
en colorFactory
kan worden gedefinieerd. Als value
is opgegeven, kunt u op basis van het platform/venstersysteem extra waardedefinities opgeven in het element colorValue
. themeElementCategory
waartoe de kleur behoort. org.eclipse.ui.themes.IColorFactory
implementeert. U kunt dit gebruiken in plaats van value
om de standaardwaarde van de kleur op te geven. U moet hier voorzichtig mee zijn: het gebruik van dit kenmerk activeert plugins bij het opstarten van de workbench. false
, krijgt de gebruiker de aanlevering niet te zien. <!ELEMENT fontDefinition (fontValue* , description?)>
<!ATTLIST fontDefinition
id CDATA #REQUIRED
label CDATA #REQUIRED
value CDATA #IMPLIED
categoryId CDATA #IMPLIED
defaultsTo CDATA #IMPLIED
isEditable (true | false) >
Een symbolische lettertypedefinitie.
De lettertypewaarde. Deze heeft de vorm lettertypenaam-stijl-hoogte
, waarbij lettertypenaam
de naam is van het lettertype, stijl
een lettertypestijl ("regular"
(normaal), "bold"
(vet), "italic"
(cursief) of "bold italic"
(vet cursief)) en hoogte
een geheel getal dat de hoogte van het lettertype aangeeft.
Voorbeeld: Times New Roman-bold-36
.
U mag alleen value
of defaultsTo
gebruiken (of geen van beide).
value
is opgegeven, kunt u op basis van het platform/venstersysteem extra waardedefinities opgeven in het element fontValue
. themeElementCategory
waartoe het lettertype behoort.
U mag alleen value
of defaultsTo
gebruiken (of geen van beide).
false
, krijgt de gebruiker de aanlevering niet te zien. <!ELEMENT colorOverride (colorFactory? , colorValue*)>
<!ATTLIST colorOverride
id CDATA #REQUIRED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Maak het overschrijven van kleuren mogelijk die zijn gedefinieerd in colorDefinition
-elementen. Deze kleuren worden toegepast als het thema in gebruik is.
colorDefinition
waarin isEditable
is ingesteld op false
.value
en colorFactory
kan worden gedefinieerd. In tegenstelling tot colorDefinition
kunt u geen defaultsTo
gebruiken voor een overschrijvingsactie. org.eclipse.ui.themes.IColorFactory
implementeert. U kunt dit gebruiken in plaats van value
om de standaardwaarde van de kleur op te geven. U moet hier voorzichtig mee zijn: het gebruik van dit kenmerk activeert plugins bij het opstarten van de workbench. <!ELEMENT fontOverride (fontValue*)>
<!ATTLIST fontOverride
id CDATA #REQUIRED
value CDATA #IMPLIED>
Maak het overschrijven van lettertypen mogelijk die zijn gedefinieerd in fontDefinition
-elementen. Deze lettertypen worden toegepast als het thema in gebruik is.
fontDefinition
waarin isEditable
is ingesteld op false
. De vervangende waarde van dit lettertype. Deze heeft de vorm lettertypenaam-stijl-hoogte
, waarbij lettertypenaam
de naam is van het lettertype, stijl
een lettertypestijl ("regular"
(normaal), "bold"
(vet), "italic"
(cursief) of "bold italic"
(vet cursief)) en hoogte
een geheel getal dat de hoogte van het lettertype aangeeft.
Voorbeeld: Times New Roman-bold-36
.
value
moet worden gedefinieerd voor een lettertypeoverschrijving. In tegenstelling tot een fontDefinition
, kunt u geen defaultsTo
opgeven voor een fontOverride
.
Als u dit kenmerk weglaat, wordt het standaardlettertype gehanteerd.
<!ELEMENT description (#PCDATA)>
Een korte omschrijving van het gebruik van de elementen.
<!ELEMENT colorFactory (parameter*)>
<!ATTLIST colorFactory
class CDATA #REQUIRED
plugin CDATA #IMPLIED>
De elementversie van het kenmerk colorFactory
. Deze wordt gebruikt als de colorFactory org.eclipse.core.runtime.IExecutableExtension
implementeert en er parametergegevens zijn die u bij de initialisatie wilt gebruiken.
org.eclipse.ui.themes.IColorFactory
implementeert. Deze kan ook org.eclipse.core.runtime.IExecutableExtension
implementeren. <!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
Een parameterelement dat u in colorFactory gebruikt. Dit wordt als initialisatiegegeven doorgegeven aan de colorFactory-klasse.
<!ELEMENT data EMPTY>
<!ATTLIST data
name CDATA #REQUIRED
value CDATA #REQUIRED>
Een element waarmee willekeurige gegevens gekoppeld kunnen worden aan thema of het standaardthema. Deze gegevens zijn bijvoorbeeld hellingshoeken of -percentages, labels, informatie over de auteur enzovoort.
Het element gedraagt zich op dezelfde manier als definities en vervangingsacties. Als er een sleutel aanwezig is in zowel het standaardthema als een geïdentificeerd thema, wordt de waarde van het geïdentificeerde thema gebruikt. Als het geïdentificeerde thema geen waarde bevat, wordt de standaardwaarde gebruikt.
<!ELEMENT colorValue (colorFactory?)>
<!ATTLIST colorValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Dit element maakt het mogelijk om een kleur op te geven op basis van het platform.
value
en colorFactory
kan worden gedefinieerd. org.eclipse.ui.themes.IColorFactory
implementeert. U kunt dit gebruiken in plaats van value
om de waarde van de kleur op te geven. U moet hier voorzichtig mee zijn: het gebruik van dit kenmerk activeert plugins bij het opstarten van de workbench. <!ELEMENT fontValue EMPTY>
<!ATTLIST fontValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #REQUIRED>
Dit element maakt het mogelijk om een lettertypewaarde op te geven op basis van het platform.
De lettertypewaarde. Deze heeft de vorm lettertypenaam-stijl-hoogte
, waarbij lettertypenaam
de naam is van het lettertype, stijl
een lettertypestijl ("regular"
(normaal), "bold"
(vet), "italic"
(cursief) of "bold italic"
(vet cursief)) en hoogte
een geheel getal dat de hoogte van het lettertype aangeeft.
Voorbeeld: Times New Roman-bold-36
.
<!ELEMENT categoryPresentationBinding EMPTY>
<!ATTLIST categoryPresentationBinding
categoryId CDATA #REQUIRED
presentationId CDATA #REQUIRED>
Met dit element kunt u een categorie aan een specifieke presentatie binden die beschreven is in het extensiepunt org.eclipse.ui.presentationFactory
. Als een categorie presentatiebindingen heeft, kan de gebruiker de categorie (en de onderliggende items) alleen configureren als deze is gebonden aan de actieve presentatie. Dit is een krachtige manier om ongebruikte items als gebruikersoptie te verwijderen.
<extension point=
"org.eclipse.ui.themes"
>
<themeElementCategory id=
"com.xyz.ThemeCategory"
class=
"com.xyz.XYZPreview"
label=
"XYZ-elementen"
/>
<colorDefinition id=
"com.xyz.Forground"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ-voorgrondkleur"
value=
"COLOR_BLACK"
>
<!-- in GTK moet wit worden gebruikt -->
<colorValue value=
"COLOR_WHITE"
os=
"linux"
ws=
"gtk"
/>
<description>
Deze kleur wordt gebruikt als voorgrondkleur in de plugineditor XYZ.</description>
</colorDefinition>
<colorDefinition id=
"com.xyz.Background"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ-achtergrondkleur"
>
<colorFactory class=
"org.eclipse.ui.themes.RGBBlendColorFactory"
plugin=
"org.eclipse.ui"
>
<parameter name=
"color1"
value=
"COLOR_WHITE"
/>
<parameter name=
"color2"
value=
"COLOR_BLUE"
/>
</colorFactory>
<!-- in GTK moet zwart worden gebruikt -->
<colorValue value=
"COLOR_BLACK"
os=
"linux"
ws=
"gtk"
/>
<description>
Deze kleur wordt gebruikt als achtergrondkleur in de plugineditor XYZ.</description>
</colorDefinition>
<fontDefinition id=
"com.xyz.TextFont"
categoryId=
"com.xyz.ThemeCategory"
label=
"Lettertype XYZ-editor"
defaultsTo=
"org.eclipse.jface.textfont"
>
<description>
Dit lettertype wordt gebruikt door de plugineditor XYY.</description>
</fontDefinition>
<data name=
"com.xyz.EditorMarginWidth"
value=
"5"
/>
<theme id=
"com.xyz.HarshTheme"
label=
"Felle kleuren voor XYZ"
>
<colorOverride id=
"com.xyz.Forground"
value=
"COLOR_CYAN"
/>
<colorOverride id=
"com.xyz.Background"
value=
"COLOR_MAGENTA"
/>
<data name=
"com.xyz.EditorMarginWidth"
value=
"1"
/>
</theme>
</extension>
org.eclipse.ui.IWorkbench.getThemeManager()
biedt een instance van org.eclipse.ui.themes.IThemeManager
die gebruikt kan worden om een benoemd thema te vinden (op ID, inclusief het standaardthema met het ID IThemeManager.DEFAULT_THEME
) of het huidige thema te gebruiken. U kunt uit een org.eclipse.ui.themes.ITheme
een org.eclipse.jface.resources.ColorRegistry
, een org.eclipse.jface.resources.FontRegistry
en de willekeurige gegevens die gekoppeld zijn aan een thema ophalen.
Copyright (c) 2003, 2005 IBM Corporation en anderen.
Alle rechten voorbehouden. Dit programma en het begeleidende materiaal zijn beschikbaar gesteld onder de voorwaarden van de Eclipse Public License v1.0 die bij deze distributie is geleverd en beschikbaar is op http://www.eclipse.org/legal/epl-v10.html.