TXLSXCharts è la raccolta di grafici incorporati esposta da TXLSXWorksheet.Charts , mentre TXLSXChart gestisce il posizionamento del grafico, gli assi e le serie
Dichiarazioni
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;
Membri del grafico
| Title, CategoryAxisTitle and ValueAxisTitle | Testo delle didascalie del grafico e dell'asse primario |
| TitleTextStyle and TitleLayout | Font, colore, enfasi, rotazione, overlay e posizione manuale del titolo del grafico tramite tipi dedicati |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Visibilità, lato, overlay, font e posizione manuale della legenda |
| PlotAreaLayout | Rettangolo manuale interno o esterno dell'area del tracciato, usando coordinate ChartML normalizzate |
| FromRow, FromCol, ToRow and ToCol | Rettangolo di ancoraggio del foglio di lavoro a base uno |
| CategoryAxis and ValueAxis | Asse delle categorie primario (asse X) e asse dei valori primario (asse Y) |
| SecondaryCategoryAxis and SecondaryValueAxis | Assi superiore e destro usati dai gruppi di tracciato secondari |
| SeriesAxis | Asse di profondità usato dai grafici a categorie tridimensionali |
| PlotGroups | Gruppi ordinati per famiglia di grafici che rendono possibili i grafici combinati, mentre Series resta una vista di compatibilità appiattita |
| HasPreservedXml | Indica se il grafico conserva il ChartML originale per round-trip sicuri rispetto alle estensioni |
| ShowDataTable and ShowDataTableKeys | Controlli di visualizzazione della tabella dati |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | Interruttori indipendenti dei bordi della tabella dati, emessi come c:showHorzBorder, c:showVertBordere c:showOutline; tutti e tre sono True per impostazione predefinita |
| HasDropLines and HasSeriesLines | Le linee di caduta dei grafici a linee collegano ogni punto all'asse delle categorie; le linee di serie collegano i segmenti delle serie a barre o linee in pila |
| HasUpDownBars, UpDownGapWidth and HasHiLowLines | Controlli di visualizzazione dei grafici a linee e a borsa |
| Rotation3DX, Rotation3DY, Elevation3D, Perspective3D and RightAngleAxes3D | Controlli della vista dei grafici tridimensionali |
| HeightPercent3D, DepthPercent3D and GapDepth3D | Percentuali di altezza, profondità e distanza tra serie del tracciato tridimensionale |
| RadarStyle | Variante della famiglia radar per il tipo di grafico corrente |
| HoleSize and FirstSliceAng | Percentuale del raggio interno della ciambella (10..90) e angolo di partenza in gradi per grafici a torta e a ciambella |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Layout torta-di-torta e barra-di-torta, regola di suddivisione e dimensioni dei tracciati primario e secondario |
| RoundedCorners | Attiva gli angoli arrotondati dello spazio del grafico |
| AutoTitleDeleted | Elimina il titolo automatico derivato dal nome di un'unica serie ed emette c:autoTitleDeleted |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Colori di riempimento e bordo di grafico e area del tracciato come valori $RRGGBB; 0 mantiene il predefinito del tema |
| ProtectionEnabled, ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection and ProtectedUserInterface | Interruttore di protezione del grafico e singole restrizioni di modifica che emette come c:protection |
| OwnerSheet | Riferimento di sola lettura al foglio di lavoro proprietario di questo grafico |
Tipi di grafico e gruppi di combinazione
TXLSXChartType include le famiglie a colonne, a barre, a linee, a torta, ad area, a ciambella, a dispersione, a bolle, radar, a borsa, torta-di-torta, a superficie, superficie 3D, colonne 3D, barre 3D, linee 3D, torta 3D e area 3D
Il primo gruppo di tracciato è il gruppo di compatibilità controllato da ChartType e AddSeries I gruppi aggiuntivi si aggiungono con AddPlotGroup e possono usare xlsxAxisPrimary oppure xlsxAxisSecondary
Serie, linee di tendenza e barre di errore
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 | Linea di tendenza lineare, esponenziale, logaritmica, polinomiale, a potenza o a media mobile |
| DispEq and DispRSqr | Mostra sul grafico l'equazione e il valore R quadrato |
| Order and Period | Ordine polinomiale o periodo della media mobile per il tipo di linea di tendenza corrispondente |
| ValueType | Entità dell'errore fissa, in percentuale, a deviazione standard, a errore standard o personalizzata |
| NoEndCap | Nasconde il terminale alle estremità di una barra di errore |
Membri degli assi e delle etichette dati
| LogBase and Orientation | Base della scala logaritmica e ordinamento dell'asse normale o invertito |
| MajorGridlines and MinorGridlines | Controlli di visibilità delle linee griglia |
| MinValue, MaxValue, MajorUnit and MinorUnit | Limiti espliciti di scala e spaziatura dei tick dove supportato |
| CrossesAt, TickLblPos and DispUnits | Posizione di intersezione dell'asse, posizionamento delle etichette e unità di visualizzazione |
ShowValue, ShowCategoryName, ShowSeriesName, ShowLegendKey, ShowPercent and ShowBubbleSize | Componenti delle etichette dati per singola serie |
| Separator | Testo usato tra più componenti di etichette dati visualizzate |
Preservazione del ChartML non supportato
Quando TXLSXWorkbook.PreserveUnsupportedParts è abilitato, che è il valore predefinito, un grafico importato conserva il suo ChartML originale Un grafico non modificato riproduce quell'XML senza normalizzazione, mentre le modifiche alle proprietà tipizzate sovrappongono il modello generato da HotXLS all'albero originale
Namespace sconosciuti, AlternateContentdi markup-compatibility, elenchi di estensioni, stili personalizzati e formattazioni non modellate restano collegati ai loro oggetti grafico originali durante le modifiche alle proprietà note Chiamare ClearPreservedXml per scartare questo XML conservato per un singolo grafico e rigenerarlo solo dalle proprietà tipizzate
Esempio
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;Vedere anche