<!ELEMENT extension (theme* , colorDefinition* , fontDefinition* , themeElementCategory* , data* , categoryPresentationBinding*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
navn CDATA #IMPLIED>
<!ELEMENT theme (colorOverride* , fontOverride* , description? , data*)>
<!ATTLIST theme
id CDATA #REQUIRED
name CDATA #IMPLIED>
En samling af font-, farve- og datatilsidesættelser. Sådan en samling kan bruges til at ændre udseendet af arbejdsbænken. Der kan være mange temaelementer med samme id. Herved kan komponentforfattere bidrage til eksisterende temaer.
<!ELEMENT themeElementCategory (description)>
<!ATTLIST themeElementCategory
id CDATA #REQUIRED
parentId CDATA #IMPLIED
class CDATA #IMPLIED
label CDATA #IMPLIED>
En logisk gruppering af temaelementdefinitioner. Denne kategori kan inkludere farver og fonte.
org.eclipse.ui.themes.IThemePreview
.<!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) >
En symbolsk farvedefinition.
defaultsTo
, value
eller colorFactory
kan være defineret.defaultsTo
, value
eller colorFactory
kan være defineret. Hvis value
er angivet, kan der angives yderligere værdidefinitioner for den enkelte platform eller det enkelte vinduessystem via elementet colorValue
. themeElementCategory
, som denne farve tilhører. org.eclipse.ui.themes.IColorFactory
. Dette kan bruges i stedet for value
til at angive standardværdien af farven. Brug denne attribut med forsigtighed. Hvis du anvender den, vil det medføre pluginaktivering, når arbejdsbænken startes. false
, bliver bidraget ikke vist for brugeren. <!ELEMENT fontDefinition (fontValue* , description?)>
<!ATTLIST fontDefinition
id CDATA #REQUIRED
label CDATA #REQUIRED
value CDATA #IMPLIED
categoryId CDATA #IMPLIED
defaultsTo CDATA #IMPLIED
isEditable (true | false) >
En symbolsk fontdefinition.
fontværdien. Den er i formatet: fontname-style-height
hvor fontname
navnet på fonten, style
er en typografi (enten "regular"
, "bold"
, "italic"
eller "bold italic"
), og height
er et heltal, der repræsenterer fontens højde.
Eksempel: Times New Roman-bold-36
.
Kun én (eller ingen) af value
eller defaultsTo
kan bruges.
value
er angivet, kan der angives yderligere værdidefinitioner for den enkelte platform eller det enkelte vinduessystem via elementet fontValue
. themeElementCategory
, som denne font tilhører.
Kun én (eller ingen) af value
eller defaultsTo
kan bruges.
false
, bliver bidraget ikke vist for brugeren. <!ELEMENT colorOverride (colorFactory? , colorValue*)>
<!ATTLIST colorOverride
id CDATA #REQUIRED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Giver mulighed for at tilsidesætte farver, der er defineret i colorDefinition
-elementer. Disse farver anvendes, når temaet er i brug.
colorDefinition
, hvor isEditable
er indstillet til false
. value
eller colorFactory
kan være defineret. I modsætning til en colorDefinition
kan du ikke levere en defaultsTo
for en tilsidesættelse.org.eclipse.ui.themes.IColorFactory
. Dette kan bruges i stedet for value
til at angive standardværdien af farven. Brug denne attribut med forsigtighed. Hvis du anvender den, vil det medføre pluginaktivering, når arbejdsbænken startes. <!ELEMENT fontOverride (fontValue*)>
<!ATTLIST fontOverride
id CDATA #REQUIRED
value CDATA #IMPLIED>
Giver mulighed for at tilsidesætte fonte, der er defineret i fontDefinition
-elementer. Disse fonte anvendes, når temaet er i brug.
fontDefinition
, hvor isEditable
er indstillet til false
. tilsidesættelsesværdien af denne font. Den er i formatet: fontname-style-height
hvor fontname
navnet på fonten, style
er en typografi (enten "regular"
, "bold"
, "italic"
eller "bold italic"
), og height
er et heltal, der repræsenterer fontens højde.
Eksempel: Times New Roman-bold-36
.
value
skal være defineret for en fonttilsidesættelse. I modsætning til en fontDefinition
kan du ikke levere en defaultsTo
for en fontOverride
.
Hvis værdien ikke er angivet, anvendes standardfonten.
<!ELEMENT description (#PCDATA)>
En kort beskrivelse af elementets anvendelse.
<!ELEMENT colorFactory (parameter*)>
<!ATTLIST colorFactory
class CDATA #REQUIRED
plugin CDATA #IMPLIED>
Elementversionen af attributten colorFactory
. Den bruges, når colorFactory implementerer org.eclipse.core.runtime.IExecutableExtension
, og der er data med parametre, du vil bruge ved initialiseringen.
org.eclipse.ui.themes.IColorFactory
. Den kan også implementere org.eclipse.core.runtime.IExecutableExtension
.<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
Et parameterelement, der skal anvendes i colorFactory-elementet. Dette overføres som initialiseringsdata til klassen colorFactory.
<!ELEMENT data EMPTY>
<!ATTLIST data
name CDATA #REQUIRED
value CDATA #REQUIRED>
Et element, der giver mulighed for at knytte vilkårlige data til et tema eller til standardtemaet. Disse data kan være gradueringsretninger eller -procenter, etiketter, forfatteroplysninger osv.
Dette element har samme funktionsmåde som definitioner og tilsidesættelser. Hvis der både findes en nøgle i standardtemaet og et identificeret tema, vil den identificerede temaværdi blive brugt, når dette tema åbnes. Hvis det identificerede tema ikke leverer en værdi, anvendes standardværdien.
<!ELEMENT colorValue (colorFactory?)>
<!ATTLIST colorValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Dette element giver mulighed for at angive en farveværdi pr. platform.
value
eller colorFactory
kan være defineret. org.eclipse.ui.themes.IColorFactory
. Dette kan bruges i stedet for value
til at angive værdien af farven. Brug denne attribut med forsigtighed. Hvis du anvender den, vil det medføre pluginaktivering, når arbejdsbænken startes. <!ELEMENT fontValue EMPTY>
<!ATTLIST fontValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #REQUIRED>
Dette element giver mulighed for at angive en fontværdi pr. platform.
fontværdien. Den er i formatet: fontname-style-height
hvor fontname
navnet på fonten, style
er en typografi (enten "regular"
, "bold"
, "italic"
eller "bold italic"
), og height
er et heltal, der repræsenterer fontens højde.
Eksempel: Times New Roman-bold-36
.
<!ELEMENT categoryPresentationBinding EMPTY>
<!ATTLIST categoryPresentationBinding
categoryId CDATA #REQUIRED
presentationId CDATA #REQUIRED>
Dette element giver mulighed for at binde en kategori til en bestemt præsentation som beskrevet af udvidelsespunktet org.eclipse.ui.presentationFactory
. Hvis en kategori har præsentationsbindinger, kan den (og dens underordnede) kun konfigureres af brugeren, hvis den er bundet til den aktive præsentation. Dette er nyttigt, hvis du vil fjerne ubenyttede elementer fra brugerens opmærksomhed.
<udvidelsespunkt=
"org.eclipse.ui.themes"
>
<themeElementCategory id=
"com.xyz.ThemeCategory"
class=
"com.xyz.XYZPreview"
label=
"XYZ-elementer"
/>
<colorDefinition id=
"com.xyz.Forground"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ-forgrundsfarve"
value=
"COLOR_BLACK"
>
<!-- white should be used on GTK -->
<colorValue value=
"COLOR_WHITE"
os=
"linux"
ws=
"gtk"
/>
<beskrivelse>
Denne farve bruges som forgrundsfarve for XYZ-plugineditoren.</description>
</colorDefinition>
<colorDefinition id=
"com.xyz.Background"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ-baggrundsfarve"
>
<colorFactory class=
"org.eclipse.ui.themes.RGBBlendColorFactory"
plugin=
"org.eclipse.ui"
>
<parameter name=
"color1"
value=
"COLOR_WHITE"
/>
<parameter name=
"color2"
value=
"COLOR_BLUE"
/>
</colorFactory>
<!-- black should be used on GTK -->
<colorValue value=
"COLOR_BLACK"
os=
"linux"
ws=
"gtk"
/>
<beskrivelse>
Denne farve bruges som baggrundsfarve for XYZ-plugineditoren.</description>
</colorDefinition>
<fontDefinition id=
"com.xyz.TextFont"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ-editorfont"
defaultsTo=
"org.eclipse.jface.textfont"
>
<beskrivelse>
Denne font bruges af XYY-plugineditoren.</description>
</fontDefinition>
<data name=
"com.xyz.EditorMarginWidth"
value=
"5"
/>
<theme id=
"com.xyz.HarshTheme"
label=
"Barske farver til 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()
leverer en forekomst af org.eclipse.ui.themes.IThemeManager
, der kan bruges til at hente et navngivet tema (efter id, herunder standardtemaet, som har id'en IThemeManager.DEFAULT_THEME
) eller det aktuelle tema. Fra en org.eclipse.ui.themes.ITheme
kan du hente en org.eclipse.jface.resources.ColorRegistry
, en org.eclipse.jface.resources.FontRegistry
og de vilkårlige data, der er knyttet til et tema.
Copyright (c) 2003, 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which accompanies
this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html