TXLSXCharts er samlingen af indlejrede diagrammer, der eksponeres via TXLSXWorksheet.Charts, og TXLSXChart ejer diagrammets placering, akser og serier
Erklæringer
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;
Diagrammedlemmer
| Title, CategoryAxisTitle and ValueAxisTitle | Tekst til diagram- og primæraksetitler |
| TitleTextStyle and TitleLayout | Typet skrifttype, farve, fremhævning, rotation, overlay og manuel position for diagramtitlen |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Legendeens synlighed, placering, overlay, skrifttype og manuelle position |
| PlotAreaLayout | Manuelt indre eller ydre plotrektangel i normaliserede ChartML-koordinater |
| FromRow, FromCol, ToRow and ToCol | 1-baseret ankerrektangel i regnearket |
| CategoryAxis and ValueAxis | Primær kategori- eller X-akse og primær værdi- eller Y-akse |
| SecondaryCategoryAxis and SecondaryValueAxis | Øverste og højre akser, som bruges af sekundære plotgrupper |
| SeriesAxis | Dybdeakse, som bruges af tredimensionelle kategoridiagrammer |
| PlotGroups | Ordnede diagramfamiliegrupper, der gør kombinationsdiagrammer mulige, mens Series forbliver en fladnet kompatibilitetsvisning |
| HasPreservedXml | Rapporterer, om diagrammet bevarer den originale ChartML til udvidelsessikre roundtrips |
| ShowDataTable and ShowDataTableKeys | Styring af datatabelvisning |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | Uafhængige kontakter for datatabelkanter, der udsendes som c:showHorzBorder, c:showVertBorder og c:showOutline; alle tre er som standard True |
| HasDropLines and HasSeriesLines | Droplinjer i linjediagrammer forbinder hvert punkt med kategoriaksen; serielinjer forbinder segmenter af stablede søjle- eller linjeserier |
| HasUpDownBars, UpDownGapWidth and HasHiLowLines | Styring af visningen for linje- og aktiediagrammer |
| Rotation3DX, Rotation3DY, Elevation3D, Perspective3D and RightAngleAxes3D | Visningsstyring for tredimensionelle diagrammer |
| HeightPercent3D, DepthPercent3D and GapDepth3D | Højde, dybde og seriegab i procent for tredimensionelle plots |
| RadarStyle | Radar-diagramfamilievariant for den aktuelle diagramtype |
| HoleSize and FirstSliceAng | Indre radius i procent (10..90) for doughnut og startvinklen i grader for cirkel- og doughnutdiagrammer |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Layout, opdelingsregel samt primær og sekundær plotstørrelse for pie-of-pie og bar-of-pie |
| RoundedCorners | Slår afrundede hjørner til og fra for diagramområdet |
| AutoTitleDeleted | Undertrykker den automatiske titel, der er afledt af et enkelt serienavn, og udsender c:autoTitleDeleted |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Fyld- og kantfarver for diagram og plotområde som $RRGGBB-værdier; 0 bevarer temastandarden |
| ProtectionEnabled, ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection and ProtectedUserInterface | Diagrammets beskyttelseskontakt og de individuelle redigeringsbegrænsninger, den udsender som c:protection |
| OwnerSheet | Skrivebeskyttet reference til det regneark, der ejer dette diagram |
Diagramtyper og kombinationsgrupper
TXLSXChartType omfatter familierne kolonne, liggende søjle, linje, cirkel, område, doughnut, scatter, boble, radar, aktie, of-pie, overflade, overflade 3D, kolonne 3D, liggende søjle 3D, linje 3D, cirkel 3D og område 3D
Den første plotgruppe er kompatibilitetsgruppen, der styres af ChartType og AddSeries. Yderligere grupper tilføjes med AddPlotGroup og kan bruge enten xlsxAxisPrimary eller xlsxAxisSecondary
Serier, tendenslinjer og fejllinjer
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 | Lineær, eksponentiel, logaritmisk, polynomiel, potens eller glidende gennemsnit-tendenslinje |
| DispEq and DispRSqr | Viser ligningen og R-kvadrat-værdien på diagrammet |
| Order and Period | Polynomiel orden eller glidende gennemsnit-periode for den tilsvarende tendenslinjetype |
| ValueType | Fast, procentvis, standardafvigelses-, standardfejl- eller brugerdefineret fejlmagnitude |
| NoEndCap | Skjuler endehætten i hver ende af en fejllinje |
Akse- og datanærmer-medlemmer
| LogBase and Orientation | Base for logaritmisk skala og normal eller omvendt akserækkefølge |
| MajorGridlines and MinorGridlines | Styring af gitterlinjers synlighed |
| MinValue, MaxValue, MajorUnit and MinorUnit | Eksplicitte skaleringgrænser og tick-afstand, hvor det understøttes |
| CrossesAt, TickLblPos and DispUnits | Aksernes skæringsposition, etiketplacering og visningsenheder |
ShowValue, ShowCategoryName, ShowSeriesName, ShowLegendKey, ShowPercent and ShowBubbleSize | Datanærmekomponenter pr. serie |
| Separator | Tekst mellem flere viste datanærmekomponenter |
Bevaring af ikke-understøttet ChartML
Når TXLSXWorkbook.PreserveUnsupportedParts er aktiveret, hvilket er standarden, bevarer et importeret diagram sin originale ChartML. Et uændret diagram afspiller den XML igen uden normalisering, mens ændringer af typede egenskaber lægger den genererede HotXLS-model oven på det originale træ
Ukendte namespaces, markup-compatibilitetens AlternateContent, udvidelseslister, brugerdefinerede typografier og ikke-modelleret formatering forbliver knyttet til deres oprindelige diagramobjekter under redigering af kendte egenskaber. Kald ClearPreservedXml for at kassere denne gemte XML for ét diagram og kun generere den igen ud fra typede egenskaber
Eksempel
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;Se også