<!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>
Набор переопределений цветов, шрифтов и данных. Такой набор может применяться для изменения оформления рабочей среды. Один идентификатор может указываться в нескольких элементах theme. Это позволяет разработчикам компонентов дополнять существующие темы.
<!ELEMENT themeElementCategory (description)>
<!ATTLIST themeElementCategory
id CDATA #REQUIRED
parentId CDATA #IMPLIED
class CDATA #IMPLIED
label CDATA #IMPLIED>
Логическое группирование определений элементов theme. Эта категория может включать цвета и шрифты.
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), которой принадлежит данный цвет.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) >
Символическое определение шрифта.
значение шрифта. Задается в виде шрифт-стиль-высота, где шрифт
- имя шрифта, стиль - стиль шрифта ("regular", "bold", "italic" или "bold italic"), высота - целое число, представляющее собой высоту шрифта.
Например: Times New Roman-bold-36.
Одновременно можно указывать только один из атрибутов value и defaultsTo (или
вообще ни одного).
value, то с помощью элемента
fontValue можно указать дополнительные определения кодов шрифтов для разных
платформ.themeElementCategory), которой принадлежит данный шрифт.
Одновременно можно указывать только один из атрибутов value и defaultsTo (или
вообще ни одного).
false, то это дополнение не будет показано пользователю. <!ELEMENT colorOverride (colorFactory? , colorValue*)>
<!ATTLIST colorOverride
id CDATA #REQUIRED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Разрешает переопределять цвета, определенные в элементах colorDefinition. Эти цвета будут
применяться при использовании темы.
colorDefinition, для
атрибута isEditable которых установлено значение false.value или colorFactory.
В отличие от colorDefinition, для переопределения нельзя задавать атрибут
defaultsTo.org.eclipse.ui.themes.IColorFactory. Он может быть использован вместо value для задания цвета по умолчанию. Будьте осторожны: применение этого
атрибута может привести к активации модуля при запуске рабочей среды. <!ELEMENT fontOverride (fontValue*)>
<!ATTLIST fontOverride
id CDATA #REQUIRED
value CDATA #REQUIRED>
Позволяет переопределять шрифты, определенные в элементах fontsDefinition. Эти шрифты будут
применяться при использовании темы.
fontDefinition, для
атрибута isEditable которых установлено значение false.код переопределения для данного шрифта. Задается в виде шрифт-стиль-высота, где шрифт
- имя шрифта, стиль - стиль шрифта ("regular", "bold", "italic" или "bold italic"), высота - целое число, представляющее собой высоту шрифта.
Например: 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>
Элемент, позволяющий связывать произвольные данные с темой или темой по умолчанию. Это могут быть следующие данные: направления градиентов, доли в процентах, метки, информация об авторах и т.д.
Этот элемент работает так же, как элементы определения и переопределения. Если ключ содержится как в теме по умолчанию, так и в идентифицированной теме, то при обращении к теме будет использоваться атрибут value идентифицированной темы. Если для идентифицированной темы не задан атрибут value, то применяется значение по умолчанию.
<!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>
Этот элемент позволяет задавать код шрифта для всей платформы.
значение шрифта. Задается в виде шрифт-стиль-высота, где шрифт
- имя шрифта, стиль - стиль шрифта ("regular", "bold", "italic" или "bold italic"), высота - целое число, представляющее собой высоту шрифта.
Например: 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"
/>
<colorDefinition id=
"com.xyz.Forground"
categoryId=
"com.xyz.ThemeCategory"
label=
"Цвет текста XYZ"
value=
"COLOR_BLACK"
>
<!-- для GTK должен применяться белый цвет -->
<colorValue value=
"COLOR_WHITE"
os=
"linux"
ws=
"gtk"
/>
<description>
Это цвет текста в редакторе модуля XYZ.</description>
</colorDefinition>
<colorDefinition id=
"com.xyz.Background"
categoryId=
"com.xyz.ThemeCategory"
label=
"Цвет фона XYZ"
>
<colorFactory class=
"org.eclipse.ui.themes.RGBBlendColorFactory"
plugin=
"org.eclipse.ui"
>
<parameter name=
"color1"
value=
"COLOR_WHITE"
/>
<parameter name=
"color2"
value=
"COLOR_BLUE"
/>
</colorFactory>
<!-- для GTK должен применяться черный цвет -->
<colorValue value=
"COLOR_BLACK"
os=
"linux"
ws=
"gtk"
/>
<description>
Это цвет фона в редакторе модуля XYZ.</description>
</colorDefinition>
<fontDefinition id=
"com.xyz.TextFont"
categoryId=
"com.xyz.ThemeCategory"
label=
"Шрифт редактора XYZ"
defaultsTo=
"org.eclipse.jface.textfont"
>
<description>
Это шрифт, используемый редактором модуля XYY.</description>
</fontDefinition>
<data name=
"com.xyz.EditorMarginWidth"
value=
"5"
/>
<theme id=
"com.xyz.HarshTheme"
label=
"Контрастные цвета для 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, который можно использовать для получения поименованной темы (по идентификатору, включая тему по умолчанию с идентификатором IThemeManager.DEFAULT_THEME) или текущей темы. Из интерфейса
org.eclipse.ui.themes.ITheme можно получить
org.eclipse.jface.resources.ColorRegistry, org.eclipse.jface.resources.FontRegistry
и произвольные данные, связанные с темой.
Copyright (c) 2003, 2005 IBM Corporation и другие.
Все права защищены. Эта программа и сопутствующие материалы распространяются на условиях Eclipse Public License v1.0, поставляемой вместе с продуктом и доступной на Web-сайте
http://www.eclipse.org/legal/epl-v10.html