<!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 #REQUIRED>
Colección de valores de alteración temporal de font, color y datos. Una colección de este tipo puede utilizarse para alterar el aspecto del entorno de trabajo.
<!ELEMENT themeElementCategory (description)>
<!ATTLIST themeElementCategory
id CDATA #REQUIRED
parentId CDATA #IMPLIED
class CDATA #IMPLIED
label CDATA #IMPLIED>
Agrupación lógica de definiciones de elemento theme. Esta categoría puede incluir colores y fonts.
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) >
Definición de color simbólico.
defaultsTo
, value
o colorFactory
.defaultsTo
, value
o colorFactory
. Si se especifica value
, pueden especificarse definiciones de valor adicionales en función de la plataforma o el sistema de ventanas por medio del elemento colorValue
.themeElementCategory
a la que pertenece
este color.org.eclipse.ui.themes.IColorFactory
. Puede utilizarse en lugar de value
para especificar el valor por omisión del color. Tenga en cuenta que debe utilizarlo con precaución: la utilización de este atributo provocará la activación del conector.false
, la contribución no se muestra al usuario.<!ELEMENT fontDefinition (fontValue* , description?)>
<!ATTLIST fontDefinition
id CDATA #REQUIRED
label CDATA #REQUIRED
value CDATA #IMPLIED
categoryId CDATA #IMPLIED
defaultsTo CDATA #IMPLIED
isEditable (true | false) >
Definición de font simbólico.
fontname-style-height
donde fontname
es el nombre de un font, style
es un estilo de font
("regular"
, "bold"
, "italic"
o "bold italic"
) y
height
es un entero que representa la altura del font.
Ejemplo: Times New Roman-bold-36
.
Sólo puede utilizarse value
o defaultsTo
, o ninguno de ellos.
value
, pueden especificarse definiciones de valor adicionales en función de la plataforma o el sistema de ventanas por medio del elemento fontValue
.themeElementCategory
a la que pertenece
este font.
Sólo puede utilizarse value
o defaultsTo
, o ninguno de ellos.
false
, la contribución no se muestra al usuario.<!ELEMENT colorOverride (colorFactory? , colorValue*)>
<!ATTLIST colorOverride
id CDATA #REQUIRED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Permite alterar temporalmente los colores definidos en los elementos
colorDefinition
. Estos colores se aplicarán cuando el tema se esté utilizando.
colorDefinition
que tengan isEditable
establecido en
false
.value
o colorFactory
.
A diferencia de una
colorDefinition
, no puede suministrar defaultsTo
para un valor de alteración temporal.org.eclipse.ui.themes.IColorFactory
. Puede utilizarse en lugar de value
para especificar el valor por omisión del color. Tenga en cuenta que debe utilizarlo con precaución: la utilización de este atributo provocará la activación del conector.<!ELEMENT fontOverride (fontValue*)>
<!ATTLIST fontOverride
id CDATA #REQUIRED
value CDATA #REQUIRED>
Permite alterar temporalmente los fonts definidos en los elementos
fontsDefinition
. Estos fonts se aplicarán cuando el tema se esté utilizando.
fontDefinition
que tengan isEditable
establecido en
false
.fontname-style-height
donde fontname
es el nombre de un font, style
es un estilo de font
("regular"
, "bold"
, "italic"
o "bold italic"
) y
height
es un entero que representa la altura del font.
Ejemplo: Times New Roman-bold-36
.
value
debe definirse para una alteración temporal de font.
A diferencia de una
fontDefinition
, no puede suministrar defaultsTo
para un fontOverride
.
<!ELEMENT description (#CDATA)>
Breve descripción de la utilización de los elementos
<!ELEMENT colorFactory (parameter*)>
<!ATTLIST colorFactory
class CDATA #REQUIRED
plugin CDATA #IMPLIED>
Versión del elemento del atributo colorFactory
. Se utiliza cuando colorFactory
implementa org.eclipse.core.runtime.IExecutableExtension
y existen datos
parametrizados que deben utilizarse en su inicialización.
org.eclipse.ui.themes.IColorFactory
. También puede implementar
org.eclipse.core.runtime.IExecutableExtension
.<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
Elemento parameter que debe utilizarse dentro del elemento colorFactory. Se pasará como datos de inicialización a la clase colorFactory.
<!ELEMENT data EMPTY>
<!ATTLIST data
name CDATA #REQUIRED
value CDATA #REQUIRED>
Elemento que permite asociar datos arbitrarios con un tema o con el tema por omisión. Estos datos pueden ser direcciones de gradiente o porcentajes, etiquetas, información de autor, etc.
Este elemento tiene un comportamiento similar al de las definiciones y alteraciones temporales. Si una clave está presente tanto en el tema por omisión como en un tema identificado, se utilizará el valor de temas identificados cuando se acceda a ese tema. Si el tema identificado no suministra un valor, se utilizaré el valor por omisión.
<!ELEMENT colorValue (colorFactory?)>
<!ATTLIST colorValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Este elemento permite especificar un valor de color en función de la plataforma.
value
o colorFactory
.org.eclipse.ui.themes.IColorFactory
. Puede utilizarse en lugar de value
para especificar el valor del color. Tenga en cuenta que debe utilizarlo con precaución: la utilización de este atributo provocará la activación del conector.<!ELEMENT fontValue EMPTY>
<!ATTLIST fontValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #REQUIRED>
Este elemento permite especificar un valor de font en función de la plataforma.
fontname-style-height
donde fontname
es el nombre de un font, style
es un estilo de font
("regular"
, "bold"
, "italic"
o "bold italic"
) y
height
es un entero que representa la altura del font.
Ejemplo: Times New Roman-bold-36
.
<!ELEMENT categoryPresentationBinding EMPTY>
<!ATTLIST categoryPresentationBinding
categoryId CDATA #REQUIRED
presentationId CDATA #REQUIRED>
Este elemento permite enlazar una categoría con una presentación específica, según lo
descrito por el punto de extensión org.eclipse.ui.presentationFactory
. Si una categoría tiene enlaces de presentación, el usuario sólo podrá configurarla a ella (y a sus hijos) si está enlazada a la presentación activa. Esto es útil para eliminar elementos no utilizados.
<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=
"Color de primer plano de XYZ"
value=
"COLOR_BLACK"
>
<!-- en GTK debe utilizarse el blanco -->
<colorValue value=
"COLOR_WHITE"
os=
"linux"
ws=
"gtk"
/>
<description>
Este color se utiliza para el primer plano del editor de conector XYZ.</description>
</colorDefinition>
<colorDefinition id=
"com.xyz.Background"
categoryId=
"com.xyz.ThemeCategory"
label=
"Color de fondo 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>
<!-- en GTK debe utilizarse el negro -->
<colorValue value=
"COLOR_BLACK"
os=
"linux"
ws=
"gtk"
/>
<description>
Este color se utiliza para el fondo del editor de conector XYZ.</description>
</colorDefinition>
<fontDefiniton id=
"com.xyz.TextFont"
categoryId=
"com.xyz.ThemeCategory"
label=
"Font de editor XYZ"
defaultsTo=
"org.eclipse.jface.textfont"
>
<description>
Este font lo utiliza el editor del conector XYY.</description>
</fontDefintion>
<data name=
"com.xyz.EditorMarginWidth"
value=
"5"
/>
<theme id=
"com.xyz.HarshTheme"
label=
"Colores originales 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()
suministra org.eclipse.ui.themes.IThemeManager
. Esta clase puede utilizarse para obtener un tema con nombre (por ID, incluyendo el tema por omisión que tiene un ID IThemeManager.DEFAULT_THEME
) o el tema actual. Desde
org.eclipse.ui.themes.ITheme
, puede obtener
org.eclipse.jface.resources.ColorRegistry
,
org.eclipse.jface.resources.FontRegistry
y los datos arbitrarios asociados con un tema.
Copyright (c) 2003, 2004 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están disponibles
bajo los términos de la licencia pública común (Common Public License) v1.0 que acompaña a
esta distribución, y está disponible en
http://www.eclipse.org/legal/cpl-v10.html