<!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>
置換字型、顏色和資料的集合。這類集合可用來改變工作台的外觀。許多主題元素可能具有相同的 ID。這容許元件作者提出現有的主題。
<!ELEMENT themeElementCategory (description)>
<!ATTLIST themeElementCategory
id CDATA #REQUIRED
parentId CDATA #IMPLIED
class CDATA #IMPLIED
label CDATA #IMPLIED>
主題元素定義的邏輯分組。這個種類可包括顏色與字型。
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) >
符號顏色定義。
defaultsTo
、value
或 colorFactory
三者之一。defaultsTo
、value
或 colorFactory
三者之一。如果指定 value
,就可以利用 colorValue
元素,在個別平台/視窗系統的基礎上指定其他值定義。
themeElementCategory
的選用 ID。org.eclipse.ui.themes.IColorFactory
的類別。這可用來取代 value
來指定顏色的預設值。
請接受忠告,小心謹慎使用 - 使用這個屬性會造成在工作台開機時啟動外掛程式。false
,使用者會見不到構成要素。
<!ELEMENT fontDefinition (fontValue* , description?)>
<!ATTLIST fontDefinition
id CDATA #REQUIRED
label CDATA #REQUIRED
value CDATA #IMPLIED
categoryId CDATA #IMPLIED
defaultsTo CDATA #IMPLIED
isEditable (true | false) >
符號字型定義。
字型值。這個格式為:fontname-style-height
,其中 fontname
是字型的名稱,style
是字型的樣式 ("regular"
、"bold"
、"italic"
或 "bold italic"
之一),且 height
是表示字型高度的整數。
範例:Times New Roman-bold-36
。
只能使用 value
或 defaultsTo
,或兩者都不能使用。
value
,就可以利用 fontValue
元素,在個別平台/視窗系統的基礎上指定其他值定義。
themeElementCategory
的選用 ID。
能使用 value
或 defaultsTo
,或兩者都不能使用。
false
,使用者會見不到構成要素。
<!ELEMENT colorOverride (colorFactory? , colorValue*)>
<!ATTLIST colorOverride
id CDATA #REQUIRED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
容許置換 colorDefinition
元素中定義的顏色。
當主題在使用中,就會套用這些顏色。
isEditable
設為 false
的 colorDefinition
。
value
或 colorFactory
兩者之一。
不像 colorDefinition
,您不能提供置換的 defaultsTo
。
org.eclipse.ui.themes.IColorFactory
的類別。這可用來取代 value
來指定顏色的預設值。
請接受忠告,小心謹慎使用 - 使用這個屬性會造成在工作台開機時啟動外掛程式。<!ELEMENT fontOverride (fontValue*)>
<!ATTLIST fontOverride
id CDATA #REQUIRED
value CDATA #REQUIRED>
容許置換 fontsDefinition
元素中定義的字型。當主題在使用中,就會套用這些字型。
isEditable
設為 false
的 fontDefinition
。
此字型的置換值。這個格式為:fontname-style-height
,其中 fontname
是字型的名稱,style
是字型的樣式 ("regular"
、"bold"
、"italic"
或 "bold italic"
之一),且 height
是表示字型高度的整數。
範例:Times New Roman-bold-36
。
value
必須定義給某個字型置換。
不像 fontDefinition
,您不能提供 fontOverride
的 defaultsTo
。
<!ELEMENT description (#PCDATA)>
元素用法的簡要說明。
<!ELEMENT colorFactory (parameter*)>
<!ATTLIST colorFactory
class CDATA #REQUIRED
plugin CDATA #IMPLIED>
colorFactory
屬性的元素版本。當 colorFactory 實作 org.eclipse.core.runtime.IExecutableExtension
,且您想在它的初值設定中使用參數化資料時,便使用這個項目。
org.eclipse.ui.themes.IColorFactory
的類別。它可能也會實作 org.eclipse.core.runtime.IExecutableExtension
。<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
在 colorFactory 元素內使用的參數元素。這將作為初值設定資料傳給 colorFactory 類別。
<!ELEMENT data EMPTY>
<!ATTLIST data
name CDATA #REQUIRED
value CDATA #REQUIRED>
可讓任意資料關聯於某主題或預設主題的元素。 這個資料可能是漸層指示或百分比、標籤、作者資訊等等。
這個元素有類似於定義和置換的行為。 如果預設主題和識別的主題中都有索引鍵,當存取識別的主題時,會使用識別的主題值。 如果識別的主題沒有提供值,就會使用預設值。
<!ELEMENT colorValue (colorFactory?)>
<!ATTLIST colorValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
這個元素允許在個別平台的基礎上指定顏色值。
value
或 colorFactory
兩者之一。
org.eclipse.ui.themes.IColorFactory
的類別。這可用來取代 value
來指定顏色值。
請接受忠告,小心謹慎使用 - 使用這個屬性會造成在工作台開機時啟動外掛程式。<!ELEMENT fontValue EMPTY>
<!ATTLIST fontValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #REQUIRED>
這個元素允許在個別平台的基礎上指定字型值。
字型值。這個格式為:fontname-style-height
,其中 fontname
是字型的名稱,style
是字型的樣式 ("regular"
、"bold"
、"italic"
或 "bold italic"
之一),且 height
是表示字型高度的整數。
範例:Times New Roman-bold-36
。
<!ELEMENT categoryPresentationBinding EMPTY>
<!ATTLIST categoryPresentationBinding
categoryId CDATA #REQUIRED
presentationId CDATA #REQUIRED>
這個元素可讓您依照 org.eclipse.ui.presentationFactory
延伸點所說明來連結至特定的呈現方式。
如果種類有任何呈現連結,且已連結於作用中的呈現,就只有使用者能夠配置它(及它的子項)。
這可用來從使用者的考量中移除未用的項目。
<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"
>
<!-- white should be used on GTK -->
<colorValue value=
"COLOR_WHITE"
os=
"linux"
ws=
"gtk"
/>
<description>
這個顏色是用在 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>
<!-- black should be used on GTK -->
<colorValue value=
"COLOR_BLACK"
os=
"linux"
ws=
"gtk"
/>
<description>
這個顏色是用在 XYZ 外掛程式編輯器的背景顏色。</description>
</colorDefinition>
<fontDefinition id=
"com.xyz.TextFont"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ Editor Font"
defaultsTo=
"org.eclipse.jface.textfont"
>
<description>
這個字型是用在 XYY 外掛程式編輯器的字型。</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()
提供 org.eclipse.ui.themes.IThemeManager
的實例,可用來取得具名主題(依據 ID,其中包括 ID 為 IThemeManager.DEFAULT_THEME
的預設主題)或現行主題。您可以從 org.eclipse.ui.themes.ITheme
中取得 org.eclipse.jface.resources.ColorRegistry
、org.eclipse.jface.resources.FontRegistry
和主題相關的任意資料。
Copyright (c) 2003, 2005 IBM Corporation and others.
All rights reserved.
本程式與隨附的資料依照 Elipse Public License 1.0 版此次發行所隨附的條款而提供,
可以在以下網址取得:http://www.eclipse.org/legal/epl-v10.html