<!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>
Une collection de remplacements de polices, de couleurs et de données. Une telle collection peut servir à modifier l'apparence du plan de travail.
<!ELEMENT themeElementCategory (description)>
<!ATTLIST themeElementCategory
id CDATA #REQUIRED
parentId CDATA #IMPLIED
class CDATA #IMPLIED
label CDATA #IMPLIED>
Un regroupement logique des définitions de l'élément de thème. Cette catégorie peut inclure des couleurs et des polices.
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) >
Une définition de couleur symbolique.
defaultsTo
,
value
ou colorFactory
peut être définie.defaultsTo
, value
ou colorFactory
peut être définie. Si value
est précisée, d'autres définitions de valeurs peuvent être indiquées
par plateforme/système de fenêtrage via l'élément colorValue
.themeElementCategory
auquel la couleur appartient.org.eclipse.ui.themes.IColorFactory
. Elle
peut être utilisée à la place de value
pour indiquer la
valeur par défaut de la couleur. Recourez-y toutefois avec
parcimonie car l'utilisation de cet attribut entraîne
l'activation de plug-ins.false
, la contribution n'est pas
présentée à l'utilisateur.<!ELEMENT fontDefinition (fontValue* , description?)>
<!ATTLIST fontDefinition
id CDATA #REQUIRED
label CDATA #REQUIRED
value CDATA #IMPLIED
categoryId CDATA #IMPLIED
defaultsTo CDATA #IMPLIED
isEditable (true | false) >
Une définition de police symbolique.
nompolice-style-hauteur
où nompolice
est le nom de la police, style
est le style de la police ("regular"
, "bold"
, "italic"
ou "bold italic"
) et hauteur
est un entier correspondant à la taille de la police.
Exemple : Times New Roman-bold-36
.
Seule une (ou aucune) valeur value
ou
defaultsTo
peut être utilisée.
value
est précisée, d'autres définitions de valeurs
peuvent être indiquées par plateforme/système de fenêtrage via
l'élément fontValue
.themeElementCategory
auquel cette police appartient.
Seule une (ou aucune) valeur value
ou
defaultsTo
peut être utilisée.
false
, la contribution n'est pas
présentée à l'utilisateur.<!ELEMENT colorOverride (colorFactory? , colorValue*)>
<!ATTLIST colorOverride
id CDATA #REQUIRED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Permet de remplacer des couleurs définies dans les éléments colorDefinition
. Ces
couleurs seront appliquées lorsque le thème est utilisé.
colorDefinition
, avec isEditable
possédant
la valeur false
.value
ou
colorFactory
peut être définie.
Contrairement à colorDefinition
, vous n'indiquez pas la
valeur de defaultsTo
pour un remplacement.org.eclipse.ui.themes.IColorFactory
. Elle peut être
utilisée à la place de value
pour indiquer la valeur par
défaut de la couleur. Recourez-y toutefois avec parcimonie car
l'utilisation de cet attribut entraîne l'activation de plug-ins.<!ELEMENT fontOverride (fontValue*)>
<!ATTLIST fontOverride
id CDATA #REQUIRED
value CDATA #REQUIRED>
Permet de remplacer des polices définies dans les éléments
fontsDefinition
. Ces polices seront appliquées
lorsque le thème est utilisé.
fontDefinition
, avec
isEditable
possédant la valeur false
.nompolice-style-hauteur
où nompolice
est le nom de la police, style
est le style de la police ("regular"
, "bold"
, "italic"
ou "bold italic"
) et hauteur
est un entier correspondant à la taille de la police.
Exemple : Times New Roman-bold-36
.
Vous devez définir value
pour un remplacement de
police.
Contrairement à fontDefinition
, vous
n'indiquez pas la valeur de defaultsTo
pour
fontOverride
.
<!ELEMENT description (#CDATA)>
Une brève description de l'utilisation des éléments.
<!ELEMENT colorFactory (parameter*)>
<!ATTLIST colorFactory
class CDATA #REQUIRED
plugin CDATA #IMPLIED>
La version de l'élément de l'attribut colorFactory
. Elle est utilisée lorsque colorFactory implémente
org.eclipse.core.runtime.IExecutableExtension
et que des
données paramétrées doivent être employée à son initialisation.
org.eclipse.ui.themes.IColorFactory
. Elle
peut aussi implémenter org.eclipse.core.runtime.IExecutableExtension
.<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
Un élément de paramètre à utiliser dans l'élément colorFactory. Il sera transmis comme donnée d'initialisation à la classe colorFactory.
<!ELEMENT data EMPTY>
<!ATTLIST data
name CDATA #REQUIRED
value CDATA #REQUIRED>
Un élément permettant que des données arbitraires soient associées à un thème (par défaut ou non). Ces données peuvent correspondre à des sens ou des pourcentages de dégradés, à des intitulés, à des informations sur l'auteur, etc.
Le comportement de cet élément est similaire aux définitions et aux remplacements. Si une clé figure dans le thème par défaut et celui identifié, la valeur de ce dernier sera utilisée si l'utilisateur y accède. Si le thème identifié ne fournit pas une valeur, celle par défaut est alors employée.
<!ELEMENT colorValue (colorFactory?)>
<!ATTLIST colorValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #IMPLIED
colorFactory CDATA #IMPLIED>
Cet élément permet la spécification d'une valeur de couleur par plateforme.
value
ou
colorFactory
peut être définie.org.eclipse.ui.themes.IColorFactory
. Elle peut être
utilisée à la place de value
pour indiquer la valeur de
la couleur. Recourez-y toutefois avec parcimonie car l'utilisation de
cet attribut entraîne l'activation de plug-ins.<!ELEMENT fontValue EMPTY>
<!ATTLIST fontValue
os CDATA #IMPLIED
ws CDATA #IMPLIED
value CDATA #REQUIRED>
Cet élément permet la spécification d'une valeur de police par plateforme.
nompolice-style-hauteur
où nompolice
est le nom de la police, style
est le style de la police ("regular"
, "bold"
, "italic"
ou "bold italic"
) et hauteur
est un entier correspondant à la taille de la police.
Exemple : Times New Roman-bold-36
.
<!ELEMENT categoryPresentationBinding EMPTY>
<!ATTLIST categoryPresentationBinding
categoryId CDATA #REQUIRED
presentationId CDATA #REQUIRED>
Cet élément permet de lier une catégorie à une présentation
spécifique, comme décrit par le point d'extension
org.eclipse.ui.presentationFactory
. Si une catégorie
renferme des liaisons de présentation, elle et ses enfants peuvent
uniquement être configurés par l'utilisateur si elle est liée à une
présentation active. Cette opération est pratique pour supprimer
des éléments inutilisés.
<extension point=
"org.eclipse.ui.themes"
>
<themeElementCategory id=
"com.xyz.ThemeCategory"
class=
"com.xyz.XYZPreview"
label=
"Eléments XYZ"
/>
<colorDefinition id=
"com.xyz.Forground"
categoryId=
"com.xyz.ThemeCategory"
label=
"Couleur d'avant-plan XYZ"
value=
"COLOR_BLACK"
>
<!-- le blanc doit être utilisé sur GTK -->
<colorValue value=
"COLOR_WHITE"
os=
"linux"
ws=
"gtk"
/>
<description>
Cette couleur est utilisée pour l'avant-plan de l'éditeur de plug-in XYZ.</description>
</colorDefinition>
<colorDefinition id=
"com.xyz.Background"
categoryId=
"com.xyz.ThemeCategory"
label=
"Couleur d'arrière-plan 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>
<!-- le noir doit être utilisé sur GTK -->
<colorValue value=
"COLOR_BLACK"
os=
"linux"
ws=
"gtk"
/>
<description>
Cette couleur est utilisée pour l'arrière-plan de l'éditeur de plug-in XYZ.</description>
</colorDefinition>
<fontDefiniton id=
"com.xyz.TextFont"
categoryId=
"com.xyz.ThemeCategory"
label=
"Police de l'éditeur XYZ"
defaultsTo=
"org.eclipse.jface.textfont"
>
<description>
Cette police est utilisée par l'éditeur de plug-in XYZ.</description>
</fontDefintion>
<data name=
"com.xyz.EditorMarginWidth"
value=
"5"
/>
<theme id=
"com.xyz.HarshTheme"
label=
"Couleurs vives pour 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()
fournit org.eclipse.ui.themes.IThemeManager
. Cette
classe peut être utilisée pour obtenir un thème nommé (par ID, y
compris le thème par défaut dont l'ID est
IThemeManager.DEFAULT_THEME
) ou le thème en cours. A partir de org.eclipse.ui.themes.ITheme
, vous pouvez
obtenir org.eclipse.jface.resources.ColorRegistry
,
org.eclipse.jface.resources.FontRegistry
et les
données arbitraires associées à un thème.
Copyright (c) 2003, 2004 IBM Corporation and others.
All rights reserved. Ce programme et les produits qui l'accompagnent sont
fournis sous licence v1.0 associée à cette distribution et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/cpl-v10.html