<!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>
Kolekce potlačení nastavení písem, barev a dat. Tuto kolekci je možno použít ke změně vzhledu pracovní plochy. Může existovat celá řada prvků motivu se stejným Id. Díky tomu mohou autoři komponent přispívat do stávajících motivů.
<!ELEMENT themeElementCategory (description)>
<!ATTLIST themeElementCategory
id CDATA #REQUIRED
parentId CDATA #IMPLIED
class CDATA #IMPLIED
label CDATA #IMPLIED>
Logické seskupení definic prvku motivu. V této kategorii mohou být zahrnuty barvy a písma.
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) >
Symbolická definice barvy.
defaultsTo
, value
nebo colorFactory
.defaultsTo
, value
nebo colorFactory
. Pokud je zadána hodnota value
, lze zadávat další definice hodnot pro jednotlivé platformy/systémy oken pomocí prvku colorValue
.themeElementCategory
, k němuž tato barva patří.org.eclipse.ui.themes.IColorFactory
. Lze použít k určení výchozí hodnoty barvy namísto value
. Tohoto využívejte uvážlivě - užitím tohoto atributu dojde k aktivaci modulu plug-in při spuštění modulu Workbench. false
, nebude tento příspěvek uživateli zobrazen.<!ELEMENT fontDefinition (fontValue* , description?)>
<!ATTLIST fontDefinition
id CDATA #REQUIRED
label CDATA #REQUIRED
value CDATA #IMPLIED
categoryId CDATA #IMPLIED
defaultsTo CDATA #IMPLIED
isEditable (true | false) >
Symbolická definice písma.
Hodnota písma. Je ve tvaru: fontname-style-height
, kde fontname
je název písma, style
je styl písma (jedna z možností "regular"
, "bold"
, "italic"
nebo "bold italic"
) a height
je celé číslo představující výšku písma.
Příklad: Times New Roman-bold-36
.
Je možné zadat pouze jednu (nebo žádnou) z následujících hodnot - value
nebo defaultsTo
.
value
, mohou být zadávány další definice hodnot pro jednotlivé platformy/systémy oken pomocí prvku fontValue
.themeElementCategory
, k němuž toto písmo patří.
Je možné zadat pouze jednu (nebo žádnou) z následujících hodnot - value
nebo defaultsTo
.
false
, nebude tento příspěvek uživateli zobrazen.<!ELEMENT colorOverride (colorFactory? , colorValue*)>
<!ATTLIST colorOverride
id CDATA #REQUIRED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Umožňuje přepsat nastavení barev definované v prvcích colorDefinition
. Tyto barvy budou použity, je-li aktivní daný motiv.
colorDefinition
parametr isEditable
nastaví na hodnotu false
.value
nebo colorFactory
.
Na rozdíl od colorDefinition
nelze pro přepsaná nastavení použít hodnotu defaultsTo
.org.eclipse.ui.themes.IColorFactory
. Lze použít k určení výchozí hodnoty barvy namísto value
. Tohoto využívejte uvážlivě - užitím tohoto atributu dojde k aktivaci modulu plug-in při spuštění modulu Workbench.<!ELEMENT fontOverride (fontValue*)>
<!ATTLIST fontOverride
id CDATA #REQUIRED
value CDATA #REQUIRED>
Umožňuje přepsat nastavení písem definované v prvcích fontsDefinition
. Tato písma budou použita, je-li aktivní daný motiv.
fontDefinition
parametr isEditable
nastaví na hodnotu false
.Přepisující hodnota tohoto písma. Je ve tvaru: fontname-style-height
, kde fontname
je název písma, style
je styl písma (jedna z možností "regular"
, "bold"
, "italic"
nebo "bold italic"
) a height
je celé číslo představující výšku písma.
Příklad: Times New Roman-bold-36
.
Hodnota value
musí být u přepsaného nastavení písma definována.
Na rozdíl od fontDefinition
pro fontOverride
nelze použít hodnotu defaultsTo
.
<!ELEMENT description (#PCDATA)>
Krátký popis použití prvků.
<!ELEMENT colorFactory (parameter*)>
<!ATTLIST colorFactory
class CDATA #REQUIRED
plugin CDATA #IMPLIED>
Verze prvku atributu colorFactory
. Používá se, pokud colorFactory implementuje org.eclipse.core.runtime.IExecutableExtension
a existují určitá parametrizovaná data, která chcete použít při jeho inicializaci.
org.eclipse.ui.themes.IColorFactory
. Může také imlementovat org.eclipse.core.runtime.IExecutableExtension
.<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
Prvek parametru, který má být použit v rámci prvku colorFactory. Bude odeslán třídě colorFactory jako inicializační data.
<!ELEMENT data EMPTY>
<!ATTLIST data
name CDATA #REQUIRED
value CDATA #REQUIRED>
Prvek, který umožňuje k motivu či k výchozímu motivu přidružovat libovolná data. Tato data mohou obsahovat ukazatele či procenta stupnice barev, označení, informace o autorovi apod.
Tento prvek se ve výsledku projevuje obdobně jako definovaná nastavení a přepsaná nastavení. Pokud klávesa existuje ve výchozím motivu i ve zvoleném motivu, bude v okamžiku přístupu k motivu použita hodnota ze zvoleného motivu. Pokud zvolený motiv příslušnou hodnotu neobsahuje, bude použita hodnota z výchozího motivu.
<!ELEMENT colorValue (colorFactory?)>
<!ATTLIST colorValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Tento prvek umožňuje nastavení hodnoty barvy u jednotlivých platforem.
value
nebo colorFactory
.org.eclipse.ui.themes.IColorFactory
. Lze použít k určení hodnoty barvy namísto value
. Tohoto využívejte uvážlivě - užitím tohoto atributu dojde k aktivaci modulu plug-in při spuštění modulu Workbench.<!ELEMENT fontValue EMPTY>
<!ATTLIST fontValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #REQUIRED>
Tento prvek umožňuje nastavení hodnoty písma u jednotlivých platforem.
Hodnota písma. Je ve tvaru: fontname-style-height
, kde fontname
je název písma, style
je styl písma (jedna z možností "regular"
, "bold"
, "italic"
nebo "bold italic"
) a height
je celé číslo představující výšku písma.
Příklad: Times New Roman-bold-36
.
<!ELEMENT categoryPresentationBinding EMPTY>
<!ATTLIST categoryPresentationBinding
categoryId CDATA #REQUIRED
presentationId CDATA #REQUIRED>
Tento prvek umožňuje přidružení kategorie ke zvolené prezentaci popsané v bodu rozšíření org.eclipse.ui.presentationFactory
. Má-li kategorie jakékoliv vazby na prezentace, uživatel ji (a příslušné dílčí prvky) bude moci konfigurovat jen tehdy, pokud je přidružená k prezentaci, která je právě aktivní. Toho lze výhodně využít, budeme-li chtít z uživatelských nastavení odstranit nepoužívané položky.
<extension point=
"org.eclipse.ui.themes"
>
<themeElementCategory id=
"com.xyz.ThemeCategory"
class=
"com.xyz.XYZPreview"
label=
"XYZ Elements"
/>
<colorDefinition id=
"com.xyz.Forground"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ Foreground Color"
value=
"COLOR_BLACK"
>
<!-- na GTK by měla být použita bílá -->
<colorValue value=
"COLOR_WHITE"
os=
"linux"
ws=
"gtk"
/>
<description>
Tato barva je použita pro popředí editoru modulu plug-in XYZ.</description>
</colorDefinition>
<colorDefinition id=
"com.xyz.Background"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ Background Color"
>
<colorFactory class=
"org.eclipse.ui.themes.RGBBlendColorFactory"
plugin=
"org.eclipse.ui"
>
<parameter name=
"color1"
value=
"COLOR_WHITE"
/>
<parameter name=
"color2"
value=
"COLOR_BLUE"
/>
</colorFactory>
<!-- na GTK by měla být použita černá -->
<colorValue value=
"COLOR_BLACK"
os=
"linux"
ws=
"gtk"
/>
<description>
Tato barva je použita pro pozadí editoru modulu plug-in XYZ.</description>
</colorDefinition>
<fontDefinition id=
"com.xyz.TextFont"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ Editor Font"
defaultsTo=
"org.eclipse.jface.textfont"
>
<description>
Toto písmo je použito v editoru modulu plug-in XYZ.</description>
</fontDefinition>
<data name=
"com.xyz.EditorMarginWidth"
value=
"5"
/>
<theme id=
"com.xyz.HarshTheme"
label=
"Harsh Colors for 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()
nabízí instanci org.eclipse.ui.themes.IThemeManager
, kterou lze použít k získání pojmenovaného motivu (podle id, včetně výchozího motivu, jenž má IThemeManager.DEFAULT_THEME
) nebo motivu aktuálního. Z org.eclipse.ui.themes.ITheme
lze získat org.eclipse.jface.resources.ColorRegistry
, org.eclipse.jface.resources.FontRegistry
a doplňkové údaje přidružené k motivu.
Copyright (c) 2003, 2005 IBM Corporation a další.
Všechna práva vyhrazena.
Tento program a doprovodné materiály jsou zpřístupněny za podmínek licence Eclipse Public License
v1.0, která je součástí této distribuce a je k dispozici na adrese
http://www.eclipse.org/legal/epl-v10.html