TXLSXCharts ist die von TXLSXWorksheet.Charts bereitgestellte Sammlung eingebetteter Diagramme, und TXLSXChart verwaltet Position, Achsen und Reihen des Diagramms
Deklarationen
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;
Diagrammmitglieder
| Title, CategoryAxisTitle and ValueAxisTitle | Titeltext für Diagramm und primäre Achse |
| TitleTextStyle and TitleLayout | Typisierte Schrift, Farbe, Hervorhebung, Drehung, Overlay und manuelle Position des Diagrammtitels |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Sichtbarkeit, Seite, Overlay, Schrift und manuelle Position der Legende |
| PlotAreaLayout | Manuelles inneres oder äußeres Plotrechteck in normalisierten ChartML-Koordinaten |
| FromRow, FromCol, ToRow and ToCol | Eins-basiertes Arbeitsblatt-Ankerrechteck |
| CategoryAxis and ValueAxis | Primäre Kategorie- bzw. X-Achse und primäre Werte- bzw. Y-Achse |
| SecondaryCategoryAxis and SecondaryValueAxis | Obere und rechte Achse für sekundäre Plotgruppen |
| SeriesAxis | Tiefenachse dreidimensionaler Kategoriediagramme |
| PlotGroups | Geordnete Diagrammfamilien-Gruppen, die Kombinationsdiagramme ermöglichen, während Series eine abgeflachte Kompatibilitätsansicht bleibt |
| HasPreservedXml | Gibt an, ob das Diagramm das originale ChartML für erweiterungssichere Roundtrips bewahrt |
| ShowDataTable and ShowDataTableKeys | Steuerung der Datentabellenanzeige |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | Unabhängige Datentabellen-Rahmenschalter, ausgegeben als c:showHorzBorder, c:showVertBorder, und c:showOutline; alle drei stehen standardmäßig auf True |
| HasDropLines and HasSeriesLines | Drop-Linien in Liniendiagrammen verbinden jeden Punkt mit der Kategorieachse; Reihenlinien verbinden Segmente gestapelter Balken- oder Linienreihen |
| HasUpDownBars, UpDownGapWidth and HasHiLowLines | Anzeigeoptionen für Linien- und Aktiendiagramme |
| Rotation3DX, Rotation3DY, Elevation3D, Perspective3D and RightAngleAxes3D | Steuerung der dreidimensionalen Diagrammansicht |
| HeightPercent3D, DepthPercent3D and GapDepth3D | Prozentwerte für Plot-Höhe, -Tiefe und Reihenabstand im dreidimensionalen Diagramm |
| RadarStyle | Netzdiagramm-Variante für den aktuellen Diagrammtyp |
| HoleSize and FirstSliceAng | Innenradius-Prozentsatz des Ringdiagramms (10..90) und Startwinkel in Grad für Kreis- und Ringdiagramme |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Layout und Aufteilungsregel von Pie-of-Pie und Bar-of-Pie sowie die Plotgrößen von primärem und sekundärem Diagramm |
| RoundedCorners | Schaltet abgerundete Ecken für den Diagrammbereich um |
| AutoTitleDeleted | Unterdrückt den aus einem einzelnen Reihennamen abgeleiteten automatischen Titel und schreibt c:autoTitleDeleted |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Füll- und Rahmenfarben von Diagramm und Plotbereich als $RRGGBB-Werte; 0 belässt den Design-Standard |
| ProtectionEnabled, ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection and ProtectedUserInterface | Schalter für den Diagrammschutz und die einzelnen Bearbeitungsbeschränkungen, ausgegeben als c:protection |
| OwnerSheet | Schreibgeschützter Verweis auf das Arbeitsblatt, das dieses Diagramm besitzt |
Diagrammtypen und Kombinationsgruppen
TXLSXChartType umfasst die Familien Säulen, Balken, Linie, Kreis, Fläche, Ring, Punkt, Blase, Netz, Kurs, Of-Pie, Oberfläche, Oberfläche 3D, Säulen 3D, Balken 3D, Linie 3D, Kreis 3D und Fläche 3D
Die erste Plotgruppe ist die Kompatibilitätsgruppe, die von ChartType und AddSeries gesteuert wird Weitere Gruppen werden mit AddPlotGroup hinzugefügt und können entweder xlsxAxisPrimary oder xlsxAxisSecondary
Reihen, Trendlinien und Fehlerbalken
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 | Lineare, exponentielle, logarithmische, polynomische, Potenz- oder gleitende Trendlinie |
| DispEq and DispRSqr | Zeigt Gleichung und R-Quadrat-Wert im Diagramm |
| Order and Period | Polynomordnung oder gleitender Durchschnittszeitraum für den jeweiligen Trendlinientyp |
| ValueType | Fester, prozentualer, Standardabweichungs-, Standardfehler- oder benutzerdefinierter Fehlerwert |
| NoEndCap | Blendet die Kappe an beiden Enden eines Fehlerbalkens aus |
Achsen- und Datenbeschriftungsmitglieder
| LogBase and Orientation | Basis der logarithmischen Skala und normale oder umgekehrte Achsenreihenfolge |
| MajorGridlines and MinorGridlines | Sichtbarkeit der Gitternetzlinien |
| MinValue, MaxValue, MajorUnit and MinorUnit | Explizite Skalierungsgrenzen und Teilstrichabstände, wo unterstützt |
| CrossesAt, TickLblPos and DispUnits | Position der Achsenkreuzung, Beschriftungsplatzierung und Anzeigeeinheiten |
ShowValue, ShowCategoryName, ShowSeriesName, ShowLegendKey, ShowPercent and ShowBubbleSize | Datenbeschriftungskomponenten je Reihe |
| Separator | Text zwischen mehreren angezeigten Komponenten der Datenbeschriftung |
Erhalt von nicht unterstütztem ChartML
Wenn TXLSXWorkbook.PreserveUnsupportedParts aktiviert ist, was der Standard ist, behält ein importiertes Diagramm sein originales ChartML Ein unverändertes Diagramm gibt dieses XML ohne Normalisierung wieder, während Änderungen an typisierten Eigenschaften das generierte HotXLS-Modell über den originalen Baum legen
Unbekannte Namespaces, Markup-Kompatibilitäts- AlternateContent, Erweiterungslisten, benutzerdefinierte Stile und nicht modellierte Formatierungen bleiben bei Bearbeitungen bekannter Eigenschaften an ihren originalen Diagrammobjekten hängen Mit ClearPreservedXml verwerfen Sie dieses bewahrte XML für ein einzelnes Diagramm und lassen es erneut ausschließlich aus den typisierten Eigenschaften erzeugen
Beispiel
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;Siehe auch