<!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 coleta de substituições de fontes, cores e dados. Essa coleta pode ser utilizada para alterar a aparência do workbench. Muitos elementos do tema podem existir com o mesmo ID. Isso permite que os autores do componente contribuam com temas existentes.
<!ELEMENT themeElementCategory (description)>
<!ATTLIST themeElementCategory
id CDATA #REQUIRED
parentId CDATA #IMPLIED
class CDATA #IMPLIED
label CDATA #IMPLIED>
Um agrupamento lógico de definições de elementos do tema. Essa categoria pode incluir cores e fontes.
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 simbólica de cor.
defaultsTo
, value
ou colorFactory
.defaultsTo
, value
ou colorFactory
. Se value
estiver especificado, será possível especificar definições de valores adicionais com base na plataforma/sistema em janelas por meio do elemento colorValue
.themeElementCategory
ao qual essa cor pertence.org.eclipse.ui.themes.IColorFactory
. Pode ser utilizada no lugar de value
para especificar o valor padrão da cor.
A utilização deve ser cuidadosa - o uso desse atributo causará a
ativação do plug-in na inicialização do workbench.false
, a contribuição não será mostrada ao usuário.<!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 simbólica de fonte.
o valor da fonte. Ele está no formato: fontname-style-height
em que fontname
é o nome de uma fonte, style
é o estilo de uma fonte ("regular"
, "bold"
, "italic"
ou "bold italic"
) e height
é um inteiro que representa a altura da fonte.
Exemplo: Times New Roman-negrito-36
.
É possível utilizar somente um (ou nenhum) de value
ou defaultsTo
.
value
estiver especificado, será possível especificar definições de valores adicionais com base na plataforma/sistema em janelas por meio do elemento fontValue
.themeElementCategory
ao qual essa fonte pertence.
É possível utilizar somente um (ou nenhum) de value
ou defaultsTo
.
false
, a contribuição não será mostrada ao usuário.<!ELEMENT colorOverride (colorFactory? , colorValue*)>
<!ATTLIST colorOverride
id CDATA #REQUIRED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Permite a substituição de cores definidas em elementos colorDefinition
. Essas cores serão aplicadas quando o tema estiver sendo utilizado.
colorDefinition
s que possuem isEditable
definido como false
.value
ou colorFactory
.
Ao contrário de colorDefinition
, não é possível fornecer defaultsTo
para uma substituição.org.eclipse.ui.themes.IColorFactory
. Pode ser utilizada no lugar de value
para especificar o valor padrão da cor.
A utilização deve ser cuidadosa - o uso desse atributo causará a
ativação do plug-in na inicialização do workbench.<!ELEMENT fontOverride (fontValue*)>
<!ATTLIST fontOverride
id CDATA #REQUIRED
value CDATA #REQUIRED>
Permite a substituição de fontes definidas em elementos fontsDefinition
. Essas fontes serão aplicadas quando o tema estiver sendo utilizado.
fontDefinition
s que possuem isEditable
definido como false
.o valor de substituição dessa fonte. Ele está no formato: fontname-style-height
em que fontname
é o nome de uma fonte, style
é o estilo de uma fonte ("regular"
, "bold"
, "italic"
ou "bold italic"
) e height
é um inteiro que representa a altura da fonte.
Exemplo: Times New Roman-negrito-36
.
value
deve ser definido para uma substituição de fonte.
Ao contrário de fontDefinition
, não é possível fornecer defaultsTo
para fontOverride
.
<!ELEMENT descrição (#PCDATA)>
Uma breve descrição sobre o uso de elementos.
<!ELEMENT colorFactory (parameter*)>
<!ATTLIST colorFactory
class CDATA #REQUIRED
plugin CDATA #IMPLIED>
A versão de elemento do atributo colorFactory
. É utilizado quando colorFactory implementa org.eclipse.core.runtime.IExecutableExtension
e há dados de parâmetros que você deseja utilizar na inicialização.
org.eclipse.ui.themes.IColorFactory
. Ela também pode implementar org.eclipse.core.runtime.IExecutableExtension
.<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
Um elemento de parâmetro a ser utilizado no elemento colorFactory. Ele será transmitido como dados de inicialização para a classe colorFactory.
<!ELEMENT data EMPTY>
<!ATTLIST data
name CDATA #REQUIRED
value CDATA #REQUIRED>
Um elemento que permite aos dados arbitrários serem associados a um tema ou ao tema padrão. Esses dados podem ser direções ou porcentagens de gradiente, etiquetas, informações de autoria, etc.
Esse elemento tem o comportamento semelhante a definições e substituições. Se uma chave estiver presente no tema padrão e em um tema identificado, o valor dos temas identificados será utilizado quando esse tema for acessado. Se o tema identificado não fornecer um valor, o padrão será utilizado.
<!ELEMENT colorValue (colorFactory?)>
<!ATTLIST colorValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Esse elemento permite a especificação de um valor de cor com base na plataforma.
value
ou colorFactory
.org.eclipse.ui.themes.IColorFactory
. Pode ser utilizada no lugar de value
para especificar o valor da cor.
A utilização deve ser cuidadosa - o uso desse atributo causará a
ativação do plug-in na inicialização do workbench.<!ELEMENT fontValue EMPTY>
<!ATTLIST fontValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #REQUIRED>
Esse elemento permite a especificação de um valor de fonte com base na plataforma.
o valor da fonte. Ele está no formato: fontname-style-height
em que fontname
é o nome de uma fonte, style
é o estilo de uma fonte ("regular"
, "bold"
, "italic"
ou "bold italic"
) e height
é um inteiro que representa a altura da fonte.
Exemplo: Times New Roman-negrito-36
.
<!ELEMENT categoryPresentationBinding EMPTY>
<!ATTLIST categoryPresentationBinding
categoryId CDATA #REQUIRED
presentationId CDATA #REQUIRED>
Esse elemento permite que uma categoria seja ligada a uma apresentação específica, conforme descrito pelo ponto de extensão org.eclipse.ui.presentationFactory
. Se uma categoria tiver ligações de apresentação, ela (e seus filhos) será configurável apenas pelo usuário se ele estiver ligado à apresentação ativa. Isso é útil para a remoção de itens não utilizados de acordo com o usuário.
<extension point=
"org.eclipse.ui.themes"
>
<themeElementCategory id=
"com.xyz.ThemeCategory"
class=
"com.xyz.XYZPreview"
label=
"Elementos XYZ"
/>
<colorDefinition id=
"com.xyz.Forground"
categoryId=
"com.xyz.ThemeCategory"
label=
"Cor XYZ do Primeiro Plano"
value=
"COLOR_BLACK"
>
<!-- deve ser utilizado branco no GTK -->
<colorValue value=
"COLOR_WHITE"
os=
"linux"
ws=
"gtk"
/>
<description>
Essa é a cor utilizada para o primeiro plano do editor de plug-in XYZ.</description>
</colorDefinition>
<colorDefinition id=
"com.xyz.Background"
categoryId=
"com.xyz.ThemeCategory"
label=
"Cor do Segundo Plano 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>
<!-- deve ser utilizado preto no GTK -->
<colorValue value=
"COLOR_BLACK"
os=
"linux"
ws=
"gtk"
/>
<description>
Essa é a cor utilizada para o segundo plano do editor de plug-in XYZ.</description>
</colorDefinition>
<fontDefinition id=
"com.xyz.TextFont"
categoryId=
"com.xyz.ThemeCategory"
label=
"Fonte do Editor XYZ"
defaultsTo=
"org.eclipse.jface.textfont"
>
<description>
Essa é a fonte utilizada pelo editor de plugin XYY.</description>
</fontDefinition>
<data name=
"com.xyz.EditorMarginWidth"
value=
"5"
/>
<theme id=
"com.xyz.HarshTheme"
label=
"Cores Harsh para 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 nomeado (pelo id, incluindo o
tema padrão que possui um ID de
IThemeManager.DEFAULT_THEME
) ou o tema atual. A partir de um org.eclipse.ui.themes.ITheme
, é possível obter um org.eclipse.jface.resources.ColorRegistry
, um org.eclipse.jface.resources.FontRegistry
e os dados arbitrários associados a um tema.
Direitos Autorais (c) 2003, 2005 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham são disponibilizados
sob os termos da Eclipse Public License v1.0 que acompanha esta
distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/epl-v10.html