TXLSXCharts is de collectie ingesloten grafieken die TXLSXWorksheet.Charts blootlegt, en TXLSXChart beheert de plaatsing van de grafiek, de assen en de reeksen
Declaraties
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;
Grafiekleden
| Title, CategoryAxisTitle and ValueAxisTitle | Bijschrifttekst van de grafiek en de primaire assen |
| TitleTextStyle and TitleLayout | Getypeerd lettertype, kleur, nadruk, rotatie, overlay en handmatige positie van de grafiektitel |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Zichtbaarheid van de legenda, kant, overlay, lettertype en handmatige positie |
| PlotAreaLayout | Handmatige binnen- of buitenrechthoek van de plot met genormaliseerde ChartML-coördinaten |
| FromRow, FromCol, ToRow and ToCol | Op 1 gebaseerde ankerrechthoek in het werkblad |
| CategoryAxis and ValueAxis | Primaire categorieas of X-as en primaire waardeas of Y-as |
| SecondaryCategoryAxis and SecondaryValueAxis | Boven- en rechterassen die secundaire plotgroepen gebruiken |
| SeriesAxis | Diepte-as die driedimensionale categoriediagrammen gebruiken |
| PlotGroups | Geordende groepen per grafiekfamilie die combinatiediagrammen mogelijk maken, terwijl Series een afgeplatte compatibiliteitsweergave blijft |
| HasPreservedXml | Rapporteert of de grafiek de oorspronkelijke ChartML behoudt voor extensieveilige roundtrips |
| ShowDataTable and ShowDataTableKeys | Weergaveopties voor de gegevenstabel |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | Onafhankelijke schakelaars voor de randen van de gegevenstabel, uitgevoerd als c:showHorzBorder, c:showVertBorderen c:showOutline; alle drie staan ze standaard op True |
| HasDropLines and HasSeriesLines | Droplijnen verbinden bij lijndiagrammen elk punt met de categorieas; serielijnen verbinden de segmenten van gestapelde balk- of lijnreeksen |
| HasUpDownBars, UpDownGapWidth and HasHiLowLines | Weergaveopties voor lijn- en beursdiagrammen |
| Rotation3DX, Rotation3DY, Elevation3D, Perspective3D and RightAngleAxes3D | Weergaveopties voor driedimensionale diagrammen |
| HeightPercent3D, DepthPercent3D and GapDepth3D | Percentages voor hoogte, diepte en reeksgat van de driedimensionale plot |
| RadarStyle | Radarvariant voor het huidige grafiektype |
| HoleSize and FirstSliceAng | Binnenstraalpercentage van de ring (10..90) en de starthoek in graden voor cirkel- en ringdiagrammen |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Indeling, splitregel en de groottes van de primaire en secundaire plot bij pie-of-pie en bar-of-pie |
| RoundedCorners | Schakelt afgeronde hoeken voor de grafiekruimte in of uit |
| AutoTitleDeleted | Onderdrukt de automatische titel die van een enkele reeksnaam wordt afgeleid en schrijft c:autoTitleDeleted |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Vul- en randkleuren van grafiek en plotgebied als $RRGGBB-waarden; 0 behoudt de standaardwaarde uit het thema |
| ProtectionEnabled, ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection and ProtectedUserInterface | Beveiligingsschakelaar van de grafiek en de afzonderlijke beperkingen die deze als c:protection |
| OwnerSheet | Alleen-lezen verwijzing naar het werkblad dat deze grafiek bezit |
Grafiektypes en combinatiegroepen
TXLSXChartType omvat de families kolom, balk, lijn, cirkel, vlak, ring, spreiding, bel, radar, aandeel, pie-of-pie, surface, surface 3D, kolom 3D, balk 3D, lijn 3D, cirkel 3D en vlak 3D
De eerste plotgroep is de compatibiliteitsgroep die door ChartType en AddSeries wordt aangestuurd. Extra groepen voeg je toe met AddPlotGroup , en die kunnen zowel xlsxAxisPrimary als xlsxAxisSecondary
Reeksen, trendlijnen en foutbalken
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 | Lineaire, exponentiële, logaritmische, polynomiale, machts- of voortschrijdend-gemiddelde trendlijn |
| DispEq and DispRSqr | Toont de vergelijking en de R-kwadraatwaarde op de grafiek |
| Order and Period | Polynomiale orde of periode van het voortschrijdend gemiddelde voor het bijbehorende trendlijntype |
| ValueType | Vaste, procentuele, standaarddeviatie-, standaardfout- of aangepaste foutgrootte |
| NoEndCap | Verbergt het eindkapje aan weerszijden van een foutbalk |
Leden voor assen en gegevenslabels
| LogBase and Orientation | Basis van de logaritmische schaal en normale of omgekeerde asvolgorde |
| MajorGridlines and MinorGridlines | Opties voor de zichtbaarheid van rasterlijnen |
| MinValue, MaxValue, MajorUnit and MinorUnit | Expliciete schaalgrenzen en tickafstand, waar ondersteund |
| CrossesAt, TickLblPos and DispUnits | Kruispositie van de as, labelplaatsing en weergave-eenheden |
ShowValue, ShowCategoryName, ShowSeriesName, ShowLegendKey, ShowPercent and ShowBubbleSize | Componenten van gegevenslabels per reeks |
| Separator | Tekst tussen meerdere weergegeven componenten van een gegevenslabel |
Niet-ondersteunde ChartML behouden
Wanneer TXLSXWorkbook.PreserveUnsupportedParts is ingeschakeld — wat het standaardgedrag is — behoudt een geïmporteerde grafiek de oorspronkelijke ChartML. Een ongewijzigde grafiek speelt die XML zonder normalisatie af, terwijl wijzigingen in getypeerde eigenschappen het gegenereerde HotXLS-model over de oorspronkelijke boom heen leggen
Onbekende namespaces, markup-compatibility AlternateContent, extensielijsten, aangepaste stijlen en niet-gemodelleerde opmaak blijven tijdens bewerkingen van bekende eigenschappen aan hun oorspronkelijke grafiekobjecten hangen. Roep ClearPreservedXml aan om deze bewaarde XML voor één grafiek weg te gooien en deze uitsluitend uit getypeerde eigenschappen te hergenereren
Voorbeeld
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;Zie ook