<!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>
Uma recolha de substituições de tipo de letra, cor e dados. Essa recolha pode ser utilizada para alterar a aparência da área de trabalho. Podem existir muitos elementos dos temas com o mesmo ID. Isto permite aos autores do componente fazerem contribuições para os temas existentes.
<!ELEMENT themeElementCategory (description)>
<!ATTLIST themeElementCategory
id CDATA #REQUIRED
parentId CDATA #IMPLIED
class CDATA #IMPLIED
label CDATA #IMPLIED>
Um agrupamento lógico das definições do elemento theme. Esta categoria poderá incluir cores e tipos de letras.
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) >
Uma definição de cor simbólica.
defaultsTo
, value
ou colorFactory
. defaultsTo
, value
ou colorFactory
. Se for especificado value
, as definições value adicionais podem ser especificadas numa base de sistema por plataforma/sistema de janelas através do elemento colorValue
.themeElementCategory
a que esta cor pertence. org.eclipse.ui.themes.IColorFactory
. Pode utilizar-se em vez de value
para especificar o valor predefinido da cor. É necessário avisar que esta opção deve ser utilizada cuidadosamente. A utilização deste atributo irá causar a activação do conector no arranque da área de trabalho. false
, então a contribuição não é mostrada ao utilizador. <!ELEMENT fontDefinition (fontValue* , description?)>
<!ATTLIST fontDefinition
id CDATA #REQUIRED
label CDATA #REQUIRED
value CDATA #IMPLIED
categoryId CDATA #IMPLIED
defaultsTo CDATA #IMPLIED
isEditable (true | false) >
Uma definição de tipo de letra simbólica.
o valor do tipo de letra. Encontra-se no formato: fontname-style-height
onde fontname
é o nome de um tipo de letra, style
é um estilo de tipo de letra (um de "regular"
, "bold"
, "italic"
ou "bold italic"
) e height
é um número inteiro que representa a altura do tipo de letra.
Exemplo: Times New Roman-bold-36
.
Apenas pode ser utilizado um (ou nenhum) dos valores value
ou defaultsTo
.
value
for especificado, as definições de valor adicionais podem ser especificadas numa base de sistema de plataforma/sistema de janelas através do elemento fontValue
. themeElementCategory
a que este tipo de letra pertence.
Apenas pode ser utilizado um (ou nenhum) dos valores value
ou defaultsTo
.
false
, então a contribuição não é mostrada ao utilizador. <!ELEMENT colorOverride (colorFactory? , colorValue*)>
<!ATTLIST colorOverride
id CDATA #REQUIRED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Permite a substituição das cores definida nos elementos colorDefinition
. Estas cores serão aplicadas quando o tema estiver a ser utilizado.
colorDefinition
s que tenham isEditable
definido para false
.value
ou colorFactory
.
Ao contrário de colorDefinition
, poderá não fornecer um valor defaultsTo
para uma substituição. org.eclipse.ui.themes.IColorFactory
. Pode utilizar-se em vez de value
para especificar o valor predefinido da cor. É necessário avisar que esta opção deve ser utilizada cuidadosamente, a utilização deste atributo irá causar a activação do conector no arranque da área de trabalho. <!ELEMENT fontOverride (fontValue*)>
<!ATTLIST fontOverride
id CDATA #REQUIRED
value CDATA #IMPLIED>
Permite a substituição dos tipos de letra definidos nos elementos fontDefinition
. Estes tipos de letra serão aplicados quando o tema estiver a ser utilizado.
fontDefinition
s que tenham isEditable
definido para false
.o valor de substituição deste tipo de letra. Encontra-se no formato: fontname-style-height
onde fontname
é o nome de um tipo de letra, style
é um estilo de tipo de letra (um de "regular"
, "bold"
, "italic"
ou "bold italic"
) e height
é um número inteiro que representa a altura do tipo de letra.
Exemplo: Times New Roman-bold-36
.
O elemento value
tem de ser definido para uma substituição de tipo de letra.
Ao contrário de fontDefinition
, não poderá fornecer um valor defaultsTo
para fontOverride
.
Se este valor não for especificado, será utilizado o tipo de letra predefinido
<!ELEMENT description (#PCDATA)>
Uma breve descrição sobre a utilização dos elementos.
<!ELEMENT colorFactory (parameter*)>
<!ATTLIST colorFactory
class CDATA #REQUIRED
plugin CDATA #IMPLIED>
A versão do elemento do atributo colorFactory
. Utiliza-se quando colorFactory implementa org.eclipse.core.runtime.IExecutableExtension
e existirem dados com parâmetros que pretende utilizar na respectiva inicialização.
org.eclipse.ui.themes.IColorFactory
. Pode igualmente implementar org.eclipse.core.runtime.IExecutableExtension
.<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
Um elemento parameter a utilizar no elemento colorFactory. Este será transferido como dados de inicialização para a classe colorFactory.
<!ELEMENT data EMPTY>
<!ATTLIST data
name CDATA #REQUIRED
value CDATA #REQUIRED>
Um elemento que permite que dados arbitrários sejam associados a um tema ou tema predefinido. Estes dados podem ser direcções ou percentagens de gradiente, etiquetas, informação do utilizador, etc.
Este elemento tem um comportamento semelhante às definições e substituições. Se estiver presente uma chave no tema predefinido e no tema identificado, então o valor dos temas identificados será utilizado quando se aceder ao tema. Se o tema identificador não fornecer um valor, será utilizado o valor predefinido.
<!ELEMENT colorValue (colorFactory?)>
<!ATTLIST colorValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Este elemento permite a especificação de um valor de cor numa base por plataforma.
value
ou colorFactory
.
org.eclipse.ui.themes.IColorFactory
. Pode utilizar-se em vez de value
para especificar o valor da cor. É necessário avisar que esta opção deve ser utilizada cuidadosamente. A utilização deste atributo irá causar a activação do conector no arranque da área de trabalho. <!ELEMENT fontValue EMPTY>
<!ATTLIST fontValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #REQUIRED>
Este elemento permite a especificação de um valor de tipo de letra numa base por plataforma.
o valor do tipo de letra. Encontra-se no formato: fontname-style-height
onde fontname
é o nome de um tipo de letra, style
é um estilo de tipo de letra (um de "regular"
, "bold"
, "italic"
ou "bold italic"
) e height
é um número inteiro que representa a altura do tipo de letra.
Exemplo: Times New Roman-bold-36
.
<!ELEMENT categoryPresentationBinding EMPTY>
<!ATTLIST categoryPresentationBinding
categoryId CDATA #REQUIRED
presentationId CDATA #REQUIRED>
Este elemento permite que uma categoria seja associada a uma apresentação específica, como a descrita pelo ponto de extensão org.eclipse.ui.presentationFactory
. Se uma categoria tiver associações de apresentação, então a categoria (e as categorias descendentes) será apenas passível de configuração pelo utilizador se estiver associada à apresentação activa. Isto é útil para remover artigos não utilizados.
<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>
This color is used for the foreground color of the XYZ plugin editor.</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>
This color is used for the background color of the XYZ plugin editor.</description>
</colorDefinition>
<fontDefinition id=
"com.xyz.TextFont"
categoryId=
"com.xyz.ThemeCategory"
label=
"XYZ Editor Font"
defaultsTo=
"org.eclipse.jface.textfont"
>
<description>
This font is used by the XYY plugin editor.</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()
fornece uma instância de org.eclipse.ui.themes.IThemeManager
que pode ser utilizada para obter um tema designado (por id, incluindo o tema predefinido que tem um id de IThemeManager.DEFAULT_THEME
) ou o tema actual. Em org.eclipse.ui.themes.ITheme
poderá obter um org.eclipse.jface.resources.ColorRegistry
, um org.eclipse.jface.resources.FontRegistry
e os dados arbitrários a um tema.
Copyright (c) 2003, 2005 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham estão disponíveis
sob os termos da Eclipse Public License v1.0 que acompanha
esta distribuição e está disponível em http://www.eclipse.org/legal/epl-v10.html