TXLSXCharts est la collection de graphiques incorporés exposée par TXLSXWorksheet.Charts , et TXLSXChart gère le placement du graphique, les axes et les séries
Déclarations
function TXLSXCharts.Add: TXLSXChart; overload;
function TXLSXCharts.Add(AChartType: TXLSXChartType; const ATitle: WideString; AFromRow, AFromCol, AToRow, AToCol: Integer): TXLSXChart; overload;
function TXLSXChart.AddSeries(const AName, ACategories, AValues: WideString): TXLSXChartSeries;
function TXLSXChart.AddPlotGroup(AChartType: TXLSXChartType; AAxisGroup: TXLSXChartAxisGroup = xlsxAxisPrimary): TXLSXChartPlotGroup;
procedure TXLSXChart.ClearSeries;
procedure TXLSXChart.ClearPlotGroups;
procedure TXLSXChart.ClearPreservedXml;
property TXLSXChart.ChartType: TXLSXChartType;
property TXLSXChart.HasPreservedXml: Boolean;
property TXLSXChart.CategoryAxis, ValueAxis: TXLSXChartAxis;
property TXLSXChart.SecondaryCategoryAxis, SecondaryValueAxis: TXLSXChartAxis;
property TXLSXChart.SeriesAxis: TXLSXChartAxis;
property TXLSXChart.TitleTextStyle, LegendTextStyle: TXLSXChartTextStyle;
property TXLSXChart.PlotAreaLayout, TitleLayout, LegendLayout: TXLSXChartLayout;
property TXLSXChart.ShowLegend, TitleOverlay, LegendOverlay: Boolean;
property TXLSXChart.LegendPosition: TXLSXChartLegendPosition;
property TXLSXChart.Series[Index: Integer]: TXLSXChartSeries;
property TXLSXChart.PlotGroups[Index: Integer]: TXLSXChartPlotGroup;
property TXLSXChart.RadarStyle: TXLSXChartRadarStyle;
property TXLSXChart.HoleSize, FirstSliceAng: Integer;
property TXLSXChart.OfPieType: TXLSXChartOfPieType;
property TXLSXChart.OfPieSplitType: TXLSXChartOfPieSplitType;
property TXLSXChart.OfPieSplitPos, OfPieSecondPieSize, OfPieGapWidth: Integer;
property TXLSXChart.RoundedCorners, AutoTitleDeleted: Boolean;
property TXLSXChart.ChartBackgroundColor, ChartBorderColor, PlotAreaBackgroundColor: LongWord;
property TXLSXChart.ProtectionEnabled: Boolean;
property TXLSXChart.ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection, ProtectedUserInterface: Boolean;
property TXLSXChart.ShowDataTableHorzBorder, ShowDataTableVertBorder, ShowDataTableOutline: Boolean;
property TXLSXChart.HasDropLines, HasSeriesLines: Boolean;
property TXLSXChart.OwnerSheet: TXLSXWorksheet;
Membres du graphique
| Title, CategoryAxisTitle and ValueAxisTitle | Texte de titre du graphique et des axes principaux |
| TitleTextStyle and TitleLayout | Police, couleur, emphase, rotation, superposition et position manuelle typées du titre du graphique |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Visibilité de la légende, côté, superposition, police et position manuelle |
| PlotAreaLayout | Rectangle de tracé intérieur ou extérieur manuel en coordonnées ChartML normalisées |
| FromRow, FromCol, ToRow and ToCol | Rectangle d'ancrage de la feuille de calcul basé sur un |
| CategoryAxis and ValueAxis | Axe des catégories (ou axe X) principal et axe des valeurs (ou axe Y) principal |
| SecondaryCategoryAxis and SecondaryValueAxis | Axes supérieur et droit utilisés par les groupes de tracé secondaires |
| SeriesAxis | Axe de profondeur utilisé par les graphiques de catégories tridimensionnels |
| PlotGroups | Groupes ordonnés de familles de graphiques qui rendent les graphiques combinés possibles tandis que Series reste une vue de compatibilité aplatie |
| HasPreservedXml | Indique si le graphique conserve le ChartML d'origine pour des allers-retours sûrs pour les extensions |
| ShowDataTable and ShowDataTableKeys | Commandes d'affichage de la table de données |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | Commutateurs indépendants de bordure de table de données émis sous forme de c:showHorzBorder, c:showVertBorderet c:showOutline; les trois valent True par défaut |
| HasDropLines and HasSeriesLines | Les lignes de chute des graphiques en courbes relient chaque point à l'axe des catégories ; les lignes de séries relient les segments des séries de barres ou de courbes empilées |
| HasUpDownBars, UpDownGapWidth and HasHiLowLines | Commandes d'affichage des graphiques en courbes et boursiers |
| Rotation3DX, Rotation3DY, Elevation3D, Perspective3D and RightAngleAxes3D | Commandes de vue des graphiques tridimensionnels |
| HeightPercent3D, DepthPercent3D and GapDepth3D | Pourcentages de hauteur, de profondeur et d'écart de séries du tracé tridimensionnel |
| RadarStyle | Variante de la famille de graphiques radar pour le type de graphique courant |
| HoleSize and FirstSliceAng | Pourcentage du rayon intérieur de l'anneau (10..90) et angle de départ en degrés pour les graphiques en secteurs et en anneau |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Disposition des graphiques secteurs-de-secteurs et barres-de-secteurs, règle de scission, et tailles des tracés principal et secondaire |
| RoundedCorners | Active ou désactive les coins arrondis de l'espace graphique |
| AutoTitleDeleted | Supprime le titre automatique dérivé du nom d'une série unique et émet c:autoTitleDeleted |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Couleurs de remplissage et de bordure du graphique et de la zone de tracé sous forme de valeurs $RRGGBB ; 0 conserve la valeur par défaut du thème |
| ProtectionEnabled, ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection and ProtectedUserInterface | Commutateur de protection du graphique et restrictions individuelles d'édition qu'il émet sous forme de c:protection |
| OwnerSheet | Référence en lecture seule à la feuille de calcul propriétaire de ce graphique |
Types de graphiques et groupes de combinaison
TXLSXChartType inclut les familles histogramme, barres, courbes, secteurs, aires, anneau, nuage de points, bulles, radar, boursier, secteurs-de-secteurs, surface, surface 3D, histogramme 3D, barres 3D, courbes 3D, secteurs 3D et aires 3D
Le premier groupe de tracé est le groupe de compatibilité contrôlé par ChartType et AddSeries ; les groupes supplémentaires sont ajoutés avec AddPlotGroup et peuvent utiliser xlsxAxisPrimary ou xlsxAxisSecondary
Séries, courbes de tendance et barres d'erreur
function TXLSXChartSeries.AddTrendline(AType: TXLSXChartTrendlineType): TXLSXChartTrendline;
function TXLSXChartSeries.AddErrorBar(ADir: TXLSXChartErrDir): TXLSXChartErrBar;
property TXLSXChartSeries.Trendlines[Index: Integer]: TXLSXChartTrendline;
property TXLSXChartSeries.ErrBarX, ErrBarY: TXLSXChartErrBar;
property TXLSXChartTrendline.TrendlineType: TXLSXChartTrendlineType;
property TXLSXChartTrendline.DispEq, DispRSqr: Boolean;
property TXLSXChartTrendline.Order, Period: Integer;
property TXLSXChartErrBar.ValueType: TXLSXChartErrValType;
property TXLSXChartErrBar.Value, PlusValue, MinusValue: Double;
| TrendlineType | Courbe de tendance linéaire, exponentielle, logarithmique, polynomiale, de puissance ou moyenne mobile |
| DispEq and DispRSqr | Affiche l'équation et la valeur R au carré sur le graphique |
| Order and Period | Ordre polynomial ou période de moyenne mobile pour le type de courbe de tendance correspondant |
| ValueType | Amplitude d'erreur fixe, en pourcentage, d'écart-type, d'erreur standard ou personnalisée |
| NoEndCap | Masque la marque aux deux extrémités d'une barre d'erreur |
Membres d'axes et d'étiquettes de données
| LogBase and Orientation | Base de l'échelle logarithmique et ordre des axes normal ou inversé |
| MajorGridlines and MinorGridlines | Commandes de visibilité du quadrillage |
| MinValue, MaxValue, MajorUnit and MinorUnit | Bornes d'échelle explicites et espacement des graduations lorsqu'ils sont pris en charge |
| CrossesAt, TickLblPos and DispUnits | Position de croisement de l'axe, placement des étiquettes et unités d'affichage |
ShowValue, ShowCategoryName, ShowSeriesName, ShowLegendKey, ShowPercent and ShowBubbleSize | Composants d'étiquettes de données par série |
| Separator | Texte utilisé entre plusieurs composants d'étiquettes de données affichées |
Conservation du ChartML non pris en charge
Lorsque TXLSXWorkbook.PreserveUnsupportedParts est activé, ce qui est le cas par défaut, un graphique importé conserve son ChartML d'origine. Un graphique non modifié rejoue ce XML sans normalisation, tandis que les modifications de propriétés typées superposent le modèle HotXLS généré à l'arborescence d'origine
Les espaces de noms inconnus, l' AlternateContentde markup-compatibility, les listes d'extensions, les styles personnalisés et la mise en forme non modélisée restent attachés à leurs objets de graphique d'origine pendant les modifications de propriétés connues. Appelez ClearPreservedXml pour abandonner ce XML conservé pour un graphique et le regénérer uniquement à partir des propriétés typées
Exemple
var
Chart: TXLSXChart;
Secondary: TXLSXChartPlotGroup;
begin
Chart := Sheet.Charts.Add(xlsxChartLine, 'Monthly sales', 2, 5, 18, 12);
Chart.AddSeries('Sales', 'Sheet1!$A$2:$A$13', 'Sheet1!$B$2:$B$13');
Chart.ValueAxisTitle := 'Amount';
Chart.TitleTextStyle.Name := 'Aptos Display';
Chart.TitleTextStyle.Size := 18;
Chart.TitleTextStyle.Bold := True;
Chart.PlotAreaLayout.Target := xlsxChartLayoutInner;
Chart.PlotAreaLayout.SetPositionAndSize(0.12, 0.18, 0.72, 0.64);
Chart.ShowLegend := True;
Chart.LegendPosition := xlsxChartLegendBottom;
Chart.LegendTextStyle.Size := 10;
Secondary := Chart.AddPlotGroup(xlsxChartColumn, xlsxAxisSecondary);
Secondary.AddSeries('Margin', 'Sheet1!$A$2:$A$13', 'Sheet1!$C$2:$C$13');
Chart.SecondaryValueAxis.Title := 'Margin percent';
Chart.Series[0].AddTrendline(xlsxTrendLinear).DispRSqr := True;
Chart.Series[0].ShowValue := True;
end;Voir aussi