Permet de représenter un graphique de type "Pie". Se base sur la classe Java XChart PieChart.
Paramètre style
Objet Hash dont les clés sont les noms des propriétés de style et les valeurs la valeur associée à chaque propriété. Cet objet regroupe un ensemble de propriétés de base communes à tous les types de graphiques ainsi qu'un ensemble de propriétés spécifiques aux graphiques "Pie".
Type des propriétés
Chaque propriété est définie dans une classe XChart (classe de base Styler ou classe spécifique PieStyler) par sa méthode "setter". Lorsqu'une de ces propriétés est utilisée dans cette macro, son type Freemarker est celui correspondant au type Java associé.
Type Java Font
Certaines propriétés Java sont du type complexe Font (https://docs.oracle.com/javase/8/docs/api/java/awt/Font.html). Dans ce cas, le type Freemarker correspondant est une chaîne alphanumérique au format suivant :
"fontName-style-pointsize" où :
- fontName représente le nom de la police,
- style représente le style de la police parmi "PLAIN", "BOLD", "BOLDITALIC" ou "ITALIC",
- pointsize représente la taille de la police en points.
Exemples : "Arial-BOLD-18", "SansSerif-PLAIN-24"
Type Java Color
Certaines propriétés Java sont du type complexe Font (https://docs.oracle.com/javase/8/docs/api/java/awt/Color.html). Dans ce cas, le type Freemarker correspondant est une chaîne alphanumérique au format suivant :
- "0xRRGGBB" ou "#rrggbb" (composantes Rouge Vert Bleu de la couleur en mode hexadécimal),
- Le nom littéral d'une couleur parmi "red", "orange", "yellow", "olive", "purple", "fuschia", "white", "lime", "green", "navy", "blue", "aqua", "teal", "black", "silver", "gray", "magenta", "pink", "cyan", "light_grey", "lightgrey", "brown", "grey", "dark_grey", "darkgrey",
- "rgb(r,g,b)" " (composantes Rouge Vert Bleu de la couleur en mode décimal).
Styles de base (classe Java XChart Styler) |
|
Nom de la propriété |
Type de la valeur |
AnnotationsFont |
Cf. Type Java Font |
AntiAlias |
Booléen |
BaseFont |
Cf. Type Java Font |
ChartBackgroundColor |
Cf. Type Java Color |
ChartFontColor |
Cf. Type Java Color |
ChartPadding |
Number (entier) |
ChartTitleBoxBackgroundColor |
Cf. Type Java Color |
ChartTitleBoxBorderColor |
Cf. Type Java Color |
ChartTitleBoxVisible |
Booléen |
ChartTitleFont |
Cf. Type Java Font |
ChartTitlePadding |
Number (entier) |
ChartTitleVisible |
Booléen |
DecimalPattern |
String |
HasAnnotations |
Booléen |
LegendBackgroundColor |
Cf. Type Java Color |
LegendBorderColor |
Cf. Type Java Color |
LegendFont |
Cf. Type Java Font |
LegendLayout |
String "Vertical", "Horizontal" |
LegendPadding |
Number (entier) |
LegendPosition |
String "OutsideE", "InsideNW", "InsideNE", "InsideSE", "InsideSW", "InsideN", "InsideS", "OutsideS" |
LegendSeriesLineLength |
Number (entier) |
LegendVisible |
Booléen |
PlotBackgroundColor |
Cf. Type Java Color |
PlotBorderColor |
Cf. Type Java Color |
PlotBorderVisible |
Booléen |
PlotContentSize |
Number (décimal) |
SeriesColors |
Séquence de Color |
|
Propriété non supportée |
SeriesMarkers |
Séquence de String "Circle", "Cross", "Diamond", "None", "Oval", "Plus", "Rectangle", "Square", "Trapezoid", "TriangleDown", "TriangleUp" |
Theme |
String |
ToolTipBackgroundColor |
Cf. Type Java Color |
ToolTipBorderColor |
Cf. Type Java Color |
ToolTipFont |
Cf. Type Java Font |
ToolTipHighlightColor |
Cf. Type Java Color |
ToolTipsAlwaysVisible |
Booléen |
ToolTipsEnabled |
Booléen |
ToolTipType |
String "xLabels", "yLabels", "xAndYLabels" |
YAxisGroupPosition |
Séquence de séquences de longueur 2. Chaque sous-séquence contient un Number (entier) et un String "Left", "Right" |
Styles spécifiques (classe Java XChart PieStyler) |
|
AnnotationDistance |
Number (décimal) |
AnnotationType |
String "Value", "Percentage", "Label", "LabelAndPercentage" |
Circular |
Booléen |
DefaultSeriesRenderStyle |
String "Pie", "Donut" |
DonutThickness |
Number (décimal) |
DrawAllAnnotations |
Booléen |
StartAngleInDegrees |
Number (décimal) |
SumFont |
Cf. Type Java Font |
SumFontSize |
Number (décimal) |
SumVisible |
Booléen |
↑ Haut de page
Paramètre series
Séquence d'objets Hash représentant les séries de données du graphique "Pie". De plus, pour chaque série, il est possible de définir des propriétés de style. Chaque objet Hash représente une série : ces propriétés permettent de stoker les valeurs des données ainsi que les valeurs des propriétés de style.
Propriétés des données d'une série
Une série d'un graphique "Pie" est représentée par son nom et par une seule valeur (Cf. méthode addSeries https://knowm.org/javadocs/xchart/org/knowm/xchart/PieChart.html).
Nom de la propriété |
Type de la valeur |
Obligatoire |
name |
String |
O |
value |
Number |
O |
↑ Haut de page
Propriétés de style d'une série
Ces propriétés permettent de particulariser une série en surchargeant une propriété de style définie dans l'objet Hash du paramètre Style de la macro. Chaque propriété est définie dans une classe XChart (classe de base Series ou classe spécifique PieSeries) par sa méthode "setter".
Lorsqu'une de ces propriétés est utilisée dans cette macro, son type Freemarker est celui correspondant au type Java associé.
Styles de séries de base (classe Java XChart Series) |
|
Nom de la propriété |
Type de la valeur |
Enabled |
Booléen |
FillColor |
Cf. Type Java Color |
Label |
String |
ShowInLegend |
Booléen |
YAxisGroup |
Number (entier) |
Styles de séries spécifiques (classe Java XChart PieSeries) |
|
String "Pie", "Donut" |
|
↑ Haut de page