TXLSXCharts je kolekce vložených grafů dostupná přes TXLSXWorksheet.Charts , kde TXLSXChart má na starosti umístění grafu, osy a řady
Deklarace
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;
Členové grafu
| Title, CategoryAxisTitle and ValueAxisTitle | Text nadpisu grafu a popisků hlavních os |
| TitleTextStyle and TitleLayout | Písmo, barva, řez, otočení, překrytí a ruční umístění nadpisu grafu přes typizované rozhraní |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Zobrazení legendy, strana, překrytí, písmo a ruční umístění |
| PlotAreaLayout | Ruční vnitřní nebo vnější obdélník oblasti grafu v normalizovaných souřadnicích ChartML |
| FromRow, FromCol, ToRow and ToCol | Obdélník ukotvení na listu s indexováním od 1 |
| CategoryAxis and ValueAxis | Hlavní osa kategorií (X) a hlavní osa hodnot (Y) |
| SecondaryCategoryAxis and SecondaryValueAxis | Horní a pravá osa používaná vedlejšími skupinami grafu |
| SeriesAxis | Osa hloubky používaná trojrozměrnými kategoriálními grafy |
| PlotGroups | Uspořádané skupiny rodin grafů, které umožňují spojené grafy, zatímco Series zůstává zploštělým pohledem pro kompatibilitu |
| HasPreservedXml | Vrací informaci, zda graf zachovává původní ChartML pro round-trip bez ztráty rozšíření |
| ShowDataTable and ShowDataTableKeys | Řízení zobrazení tabulky dat |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | Nezávislé přepínače okrajů tabulky dat zapisované jako c:showHorzBorder, c:showVertBordera c:showOutline; všechny tři mají výchozí hodnotu True |
| HasDropLines and HasSeriesLines | Spojnice u čárových grafů vedou z každého bodu na osu kategorií; linky řad spojují segmenty řad skládaných pruhových nebo čárových grafů |
| HasUpDownBars, UpDownGapWidth and HasHiLowLines | Řízení zobrazení čárových a burzovních grafů |
| Rotation3DX, Rotation3DY, Elevation3D, Perspective3D and RightAngleAxes3D | Řízení pohledu trojrozměrného grafu |
| HeightPercent3D, DepthPercent3D and GapDepth3D | Procentuální výška, hloubka a mezery mezi řadami trojrozměrné oblasti grafu |
| RadarStyle | Varianta rodiny pavinkových grafů pro aktuální typ grafu |
| HoleSize and FirstSliceAng | Procento vnitřního poloměru prstencového grafu (10..90) a počáteční úhel ve stupních pro koláčové a prstencové grafy |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Rozložení grafů typu koláč s vedlejším koláčem a pruhový s vedlejším pruhovým, pravidlo rozdělení a velikosti hlavní a vedlejší oblasti grafu |
| RoundedCorners | Přepíná zaoblené rohy plochy grafu |
| AutoTitleDeleted | Potlačí automatický nadpis odvozený z názvu jediné řady a zapíše c:autoTitleDeleted |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Barvy výplně a okrajů grafu a oblasti grafu jako hodnoty $RRGGBB; 0 ponechá výchozí hodnotu motivu |
| ProtectionEnabled, ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection and ProtectedUserInterface | Přepínač ochrany grafu a dílčí omezení úprav, která zapisuje jako c:protection |
| OwnerSheet | Odkaz pouze pro čtení na list, jemuž tento graf patří |
Typy grafů a kombinované skupiny
TXLSXChartType zahrnuje rodiny sloupcových, pruhových, čárových, koláčových, plošných, prstencových, bodových, bublinkových, pavinkových a burzovních grafů, grafů typu koláč s vedlejším koláčem a povrchových grafů, dále 3D varianty povrchového, sloupcového, pruhového, čárového, koláčového a plošného grafu
První skupina grafu je skupina pro kompatibilitu, kterou řídí ChartType a AddSeries Další skupiny se přidávají metodou AddPlotGroup a mohou použít xlsxAxisPrimary nebo xlsxAxisSecondary
Řady, trendové čáry a chybové úsečky
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ární, exponenciální, logaritmická, polynomiální nebo mocninová trendová čára, případně klouzavý průměr |
| DispEq and DispRSqr | Zobrazuje na grafu rovnici a hodnotu R-kvadrát |
| Order and Period | Řád polynomu nebo perioda klouzavého průměru pro příslušný typ trendové čáry |
| ValueType | Pevná hodnota, procento, směrodatná odchylka, směrodatná chyba nebo vlastní velikost chyby |
| NoEndCap | Skryje čepičky na koncích chybové úsečky |
Členové os a popisků dat
| LogBase and Orientation | Základ logaritmické škály a normální nebo obrácené pořadí osy |
| MajorGridlines and MinorGridlines | Řízení viditelnosti mřížkových čar |
| MinValue, MaxValue, MajorUnit and MinorUnit | Explicitní hranice měřítka a rozestup dílků osy, je-li podporováno |
| CrossesAt, TickLblPos and DispUnits | Poloha průsečíku osy, umístění popisků a zobrazovací jednotky |
ShowValue, ShowCategoryName, ShowSeriesName, ShowLegendKey, ShowPercent and ShowBubbleSize | Komponenty popisků dat pro jednotlivé řady |
| Separator | Text používaný mezi více zobrazenými komponentami popisku dat |
Zachování nepodporovaného ChartML
Když je povolen přepínač TXLSXWorkbook.PreserveUnsupportedParts (což je výchozí stav), importovaný graf si zachová původní ChartML Nedotčený graf tento XML přehraje bez normalizace, zatímco změny typizovaných vlastností promítnou vygenerovaný model HotXLS přes původní strom
Neznámé jmenné prostory, prvek AlternateContentpro kompatibilitu značení, seznamy rozšíření, vlastní styly a formátování, které model nepokrývá, zůstávají i při úpravách známých vlastností navázány na původní objekty grafu Vyvolejte ClearPreservedXml , pokud chcete tento uchovaný XML u jednoho grafu zahodit a vygenerovat jej znovu pouze z typizovaných vlastností
Příklad
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;Viz také