TXLSXCharts är samlingen med inbäddade diagram som exponeras via TXLSXWorksheet.Charts , och TXLSXChart äger diagrammets placering, axlar och serier
Deklarationer
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;
Diagrammedlemmar
| Title, CategoryAxisTitle and ValueAxisTitle | Rubriktext för diagrammet och den primära axeln |
| TitleTextStyle and TitleLayout | Typad stil för diagramrubrikens teckensnitt, färg, betoning, rotation, överlapp och manuella position |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Legendens synlighet, sida, överlapp, teckensnitt och manuella position |
| PlotAreaLayout | Manuell inre eller yttre rektangel för ritningsområdet i normaliserade ChartML-koordinater |
| FromRow, FromCol, ToRow and ToCol | Ettbaserad förankringsrektangel i kalkylbladet |
| CategoryAxis and ValueAxis | Primär kategoriaxel (X-axel) och primär värdeaxel (Y-axel) |
| SecondaryCategoryAxis and SecondaryValueAxis | Övre och högra axlar som används av sekundära plottgrupper |
| SeriesAxis | Djupaxeln som används av tredimensionella kategoridiagram |
| PlotGroups | Ordnade diagramfamiljsgrupper som gör kombinationsdiagram möjliga, medan Series förblir en tillplattad kompatibilitetsvy |
| HasPreservedXml | Rapporterar om diagrammet behåller sin ursprungliga ChartML för Roundtrips som tål okända tillägg |
| ShowDataTable and ShowDataTableKeys | Styrning av datatabellvisning |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | Oberoende brytare för datatabellens kanter som skrivs ut som c:showHorzBorder, c:showVertBorderoch c:showOutline; samtliga tre är True som standard |
| HasDropLines and HasSeriesLines | Släpplinjer i linjediagram förbinder varje punkt med kategoriaxeln; serielinjer förbinder segment i staplade stapel- eller linjeserier |
| HasUpDownBars, UpDownGapWidth and HasHiLowLines | Visningsstyrning för linje- och aktiediagram |
| Rotation3DX, Rotation3DY, Elevation3D, Perspective3D and RightAngleAxes3D | Visningsstyrning för tredimensionella diagram |
| HeightPercent3D, DepthPercent3D and GapDepth3D | Procentsatser för ritningsområdets höjd, djup och seriegap i tredimensionella diagram |
| RadarStyle | Varianten av radardiagramfamiljen för den aktuella diagramtypen |
| HoleSize and FirstSliceAng | Procentuell innerradie för ringdiagram (10..90) och startvinkeln i grader för cirkel- och ringdiagram |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Pie-of-pie- och bar-of-pie-layout, delningsregel samt primära och sekundära plottstorlekar |
| RoundedCorners | Växlar avrundade hörn för diagramytan |
| AutoTitleDeleted | Undertrycker den automatiska rubrik som härleds från ett enskilt serienamn och skriver ut c:autoTitleDeleted |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Fyllnads- och kantfärger för diagram och ritningsområde som $RRGGBB-värden; 0 behåller temats standard |
| ProtectionEnabled, ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection and ProtectedUserInterface | Diagrammets skyddsbrytare och de enskilda redigeringsbegränsningar den skriver ut som c:protection |
| OwnerSheet | Skrivskyddad referens till det kalkylblad som äger det här diagrammet |
Diagramtyper och kombinationsgrupper
TXLSXChartType omfattar familjerna kolumn, stapel, linje, cirkel, område, ring, punkt, bubbla, radar, aktie, of-pie, yta, yta 3D, kolumn 3D, stapel 3D, linje 3D, cirkel 3D och område 3D
Den första plottgruppen är kompatibilitetsgruppen som styrs av ChartType och AddSeries Ytterligare grupper läggs till med AddPlotGroup och kan använda antingen xlsxAxisPrimary eller xlsxAxisSecondary
Serier, trendlinjer och felstaplar
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 | Trendlinje av typen linjär, exponentiell, logaritmisk, polynom, potens eller glidande medelvärde |
| DispEq and DispRSqr | Visar ekvationen och R-kvadrat-värdet i diagrammet |
| Order and Period | Polynomordning eller period för glidande medelvärde för motsvarande trendlinjetyp |
| ValueType | Fast, procentuell, standardavvikelse-, standardfel- eller anpassad felmagnitud |
| NoEndCap | Döljer ändstycket i varje ände av en felstapel |
Axel- och dataetikettmedlemmar
| LogBase and Orientation | Bas för logaritmisk skala samt normal eller omvänd axelordning |
| MajorGridlines and MinorGridlines | Styrning av gitterlinjernas synlighet |
| MinValue, MaxValue, MajorUnit and MinorUnit | Explicita skalgränser och skalstrecksavstånd där det stöds |
| CrossesAt, TickLblPos and DispUnits | Axelskärningsposition, etikettplacering och visningsenheter |
ShowValue, ShowCategoryName, ShowSeriesName, ShowLegendKey, ShowPercent and ShowBubbleSize | Dataetikettkomponenter per serie |
| Separator | Text som används mellan flera visade dataetikettkomponenter |
Bevara ChartML som inte stöds
När TXLSXWorkbook.PreserveUnsupportedParts är aktiverat, vilket är standard, behåller ett importerat diagram sin ursprungliga ChartML Ett orört diagram spelar upp det XML:et utan normalisering, medan ändringar av typade egenskaper lägger den genererade HotXLS-modellen över det ursprungliga trädet
Okända namnrymder, markupkompatibel AlternateContent, tilläggslistor, anpassade stilar och omodellerad formatering förblir knutna till sina ursprungliga diagramobjekt vid redigering av kända egenskaper Anropa ClearPreservedXml för att kassera det behållna XML:et för ett diagram och generera om det endast från typade egenskaper
Exempel
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 även