TXLSXCharts, TXLSXWorksheet.Charts üzerinden erişime açılan gömülü grafik koleksiyonudur; TXLSXChart ise grafiğin yerleşimini, eksenlerini ve serilerini barındırır
Bildirimler
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;
Grafik üyeleri
| Title, CategoryAxisTitle and ValueAxisTitle | Grafik ile ana eksenlerin başlık metinleri |
| TitleTextStyle and TitleLayout | Grafik başlığı için tipli yazı tipi, renk, vurgu, döndürme, bindirme ve elle konumlandırma |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Gösterge görünürlüğü, tarafı, bindirmesi, yazı tipi ve elle konumu |
| PlotAreaLayout | Normalize edilmiş ChartML koordinatlarıyla belirlenen elle iç veya dış plot alanı dikdörtgeni |
| FromRow, FromCol, ToRow and ToCol | Bire dayalı çalışma sayfası çapa dikdörtgeni |
| CategoryAxis and ValueAxis | Ana kategori ya da X ekseni ile ana değer ya da Y ekseni |
| SecondaryCategoryAxis and SecondaryValueAxis | İkincil plot gruplarının kullandığı üst ve sağ eksenler |
| SeriesAxis | Üç boyutlu kategori grafiklerinin kullandığı derinlik ekseni |
| PlotGroups | Kombinasyon grafiklerini mümkün kılan sıralı grafik ailesi grupları; Series ise düzleştirilmiş bir uyumluluk görünümü olarak kalır |
| HasPreservedXml | Grafiğin, eklenti güvenli gidiş-dönüşler için özgün ChartML'yi koruyup korumadığını bildirir |
| ShowDataTable and ShowDataTableKeys | Veri tablosu görüntüleme denetimleri |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | c:showHorzBorder, c:showVertBorder ve c:showOutline olarak üretilen bağımsız veri tablosu kenarlık anahtarları; üçü de varsayılan olarak True |
| HasDropLines and HasSeriesLines | Çizgi grafiklerinde her noktayı kategori eksenine bağlayan iz düşüm çizgileri; yığılmış çubuk veya çizgi serilerinin segmentlerini bağlayan seri çizgileri |
| HasUpDownBars, UpDownGapWidth and HasHiLowLines | Çizgi ve borsa grafikleri için görüntüleme denetimleri |
| Rotation3DX, Rotation3DY, Elevation3D, Perspective3D and RightAngleAxes3D | Üç boyutlu grafik görünüm denetimleri |
| HeightPercent3D, DepthPercent3D and GapDepth3D | Üç boyutlu plot yüksekliği, derinliği ve seri aralığı yüzdeleri |
| RadarStyle | Geçerli grafik türü için radar grafik ailesi varyantı |
| HoleSize and FirstSliceAng | Halka grafiği iç yarıçap yüzdesi (10..90) ile pasta ve halka grafiklerinde başlangıç açısı (derece cinsinden) |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Pasta içinde pasta ve çubuk içinde pasta yerleşimi, bölme kuralı ile birincil ve ikincil plot boyutları |
| RoundedCorners | Grafik alanı köşelerinin yuvarlatılmasını açar veya kapatır |
| AutoTitleDeleted | Tek seri adından türetilen otomatik başlığı bastırır ve c:autoTitleDeleted üretir |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Grafik ve plot alanı dolgu ile kenarlık renkleri, $RRGGBB değerleri olarak; 0 tema varsayılanını korur |
| ProtectionEnabled, ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection and ProtectedUserInterface | Grafik koruması anahtarı ve c:protection olarak ürettiği tek tek düzenleme kısıtları |
| OwnerSheet | Bu grafiğin ait olduğu çalışma sayfasına salt okunur başvuru |
Grafik türleri ve kombinasyon grupları
TXLSXChartType; sütun, çubuk, çizgi, pasta, alan, halka, dağılım, kabarcık, radar, borsa, pasta içi pasta, yüzey, yüzey 3D, sütun 3D, çubuk 3D, çizgi 3D, pasta 3D ve alan 3D ailelerini içerir
İlk plot grubu, ChartType ve AddSeries tarafından denetlenen uyumluluk grubudur Ek gruplar AddPlotGroup ile eklenir ve xlsxAxisPrimary ya da xlsxAxisSecondary kullanabilir
Seriler, trend çizgileri ve hata çubukları
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 | Doğrusal, üstel, logaritmik, polinom, kuvvet veya hareketli ortalama trend çizgisi |
| DispEq and DispRSqr | Grafiğin üzerinde denklemi ve R-kare değerini gösterir |
| Order and Period | İlgili trend çizgisi türü için polinom derecesi veya hareketli ortalama periyodu |
| ValueType | Sabit, yüzde, standart sapma, standart hata veya özel hata büyüklüğü |
| NoEndCap | Hata çubuğunun uçlarındaki kapakları gizler |
Eksen ve veri etiketi üyeleri
| LogBase and Orientation | Logaritmik ölçek tabanı ile normal ya da ters eksen sıralaması |
| MajorGridlines and MinorGridlines | Izgara çizgisi görünürlük denetimleri |
| MinValue, MaxValue, MajorUnit and MinorUnit | Desteklendiği yerde açık ölçekleme sınırları ve tik aralığı |
| CrossesAt, TickLblPos and DispUnits | Eksen kesişim konumu, etiket yerleşimi ve görüntüleme birimleri |
ShowValue, ShowCategoryName, ShowSeriesName, ShowLegendKey, ShowPercent and ShowBubbleSize | Seri başına veri etiketi bileşenleri |
| Separator | Birden çok görüntülenen veri etiketi bileşeni arasında kullanılan metin |
Desteklenmeyen ChartML'nin korunması
Ki zaten varsayılan olan TXLSXWorkbook.PreserveUnsupportedParts etkin olduğunda, içe aktarılan grafik özgün ChartML'sini korur Dokunulmamış bir grafik bu XML'i normalleştirmeden yeniden üretir; tipli özelliklerde yapılan değişiklikler ise üretilen HotXLS modelini özgün ağacın üzerine bindirir
Bilinmeyen ad alanları, markup-compatibility öğesi AlternateContent, eklenti listeleri, özel stiller ve modellenmemiş biçimlendirme, bilinen özellikler düzenlenirken özgün grafik nesnelerine bağlı kalır Tek bir grafik için bu saklanan XML'i atmak ve yalnızca tipli özelliklerden yeniden üretmek üzere ClearPreservedXml çağırın
Örnek
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;Ayrıca bkz.