TXLSXCharts es la colección de gráficos incrustados expuesta por TXLSXWorksheet.Charts y TXLSXChart posee la colocación del gráfico, los ejes y las series
Declaraciones
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;
Miembros de gráfico
| Title, CategoryAxisTitle and ValueAxisTitle | Texto de título del gráfico y del eje principal |
| TitleTextStyle and TitleLayout | Fuente, color, énfasis, rotación, superposición y posición manual tipadas del título del gráfico |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Visibilidad, lado, superposición, fuente y posición manual de la leyenda |
| PlotAreaLayout | Rectángulo de trazado interior o exterior manual usando coordenadas ChartML normalizadas |
| FromRow, FromCol, ToRow and ToCol | Rectángulo ancla de la hoja de cálculo basado en uno |
| CategoryAxis and ValueAxis | Eje de categoría o X principal y eje de valor o Y principal |
| SecondaryCategoryAxis and SecondaryValueAxis | Ejes superior y derecho usados por grupos de trazado secundarios |
| SeriesAxis | Eje de profundidad usado por gráficos de categorías tridimensionales |
| PlotGroups | Grupos ordenados de familias de gráficos que hacen posibles los gráficos combinados, mientras que Series sigue siendo una vista de compatibilidad aplanada |
| HasPreservedXml | Informa de si el gráfico conserva el ChartML original para round-trips seguros para extensiones |
| ShowDataTable and ShowDataTableKeys | Controles de visualización de la tabla de datos |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | Interruptores independientes de bordes de la tabla de datos emitidos como c:showHorzBorder, c:showVertBorder y c:showOutline; los tres son True por defecto |
| HasDropLines and HasSeriesLines | Las líneas de caída de los gráficos de línea conectan cada punto con el eje de categorías; las líneas de series conectan los segmentos de series de barras o líneas apiladas |
| HasUpDownBars, UpDownGapWidth and HasHiLowLines | Controles de visualización de gráficos de línea y de cotizaciones |
| Rotation3DX, Rotation3DY, Elevation3D, Perspective3D and RightAngleAxes3D | Controles de vista de gráficos tridimensionales |
| HeightPercent3D, DepthPercent3D and GapDepth3D | Porcentajes de altura, profundidad y separación de series del trazado tridimensional |
| RadarStyle | Variante de la familia de gráfico radial para el tipo de gráfico actual |
| HoleSize and FirstSliceAng | Porcentaje del radio interior del anillo (10..90) y el ángulo inicial en grados para gráficos circulares y de anillo |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Disposición pie-de-pie y barra-de-pie, regla de división y tamaños de trazado primario y secundario |
| RoundedCorners | Activa las esquinas redondeadas del espacio del gráfico |
| AutoTitleDeleted | Suprime el título automático derivado de un único nombre de serie y emite c:autoTitleDeleted |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Colores de relleno y borde del gráfico y del área de trazado como valores $RRGGBB; 0 conserva el valor predeterminado del tema |
| ProtectionEnabled, ProtectedChartObjects, ProtectedDataEditing, ProtectedFormatting, ProtectedSelection and ProtectedUserInterface | Interruptor de protección del gráfico y las restricciones individuales de edición que emite como c:protection |
| OwnerSheet | Referencia de solo lectura a la hoja de cálculo que posee este gráfico |
Tipos de gráfico y grupos de combinación
TXLSXChartType incluye las familias de columnas, barras, líneas, circular, área, anillo, dispersión, burbujas, radial, cotizaciones, pie-de-pie, superficie, superficie 3D, columnas 3D, barras 3D, líneas 3D, circular 3D y área 3D
El primer grupo de trazado es el grupo de compatibilidad controlado por ChartType y AddSeries. Los grupos adicionales se añaden con AddPlotGroup y pueden usar xlsxAxisPrimary o xlsxAxisSecondary
Series, líneas de tendencia y barras de error
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 | Línea de tendencia lineal, exponencial, logarítmica, polinómica, potencial o de media móvil |
| DispEq and DispRSqr | Muestra la ecuación y el valor R cuadrado en el gráfico |
| Order and Period | Orden del polinomio o periodo de la media móvil para el tipo de línea de tendencia correspondiente |
| ValueType | Magnitud de error fija, porcentual, de desviación estándar, de error estándar o personalizada |
| NoEndCap | Oculta el casquete en cualquier extremo de una barra de error |
Ejes y etiquetas de datos
| LogBase and Orientation | Base de escala logarítmica y ordenación del eje normal o invertida |
| MajorGridlines and MinorGridlines | Controles de visibilidad de las líneas de cuadrícula |
| MinValue, MaxValue, MajorUnit and MinorUnit | Límites de escalado explícitos y espaciado de marcas donde está soportado |
| CrossesAt, TickLblPos and DispUnits | Posición de cruce del eje, colocación de etiquetas y unidades de visualización |
ShowValue, ShowCategoryName, ShowSeriesName, ShowLegendKey, ShowPercent and ShowBubbleSize | Componentes de etiquetas de datos por serie |
| Separator | Texto usado entre varios componentes de etiquetas de datos mostrados |
Conservación de ChartML no soportado
When TXLSXWorkbook.PreserveUnsupportedParts is enabled, which is the default, un gráfico importado conserva su ChartML original. Un gráfico no tocado reproduce ese XML sin normalización, mientras que los cambios en propiedades tipadas superponen el modelo HotXLS generado sobre el árbol original
Los espacios de nombres desconocidos, el AlternateContent de compatibilidad de marcado, las listas de extensiones, los estilos personalizados y el formato no modelado permanecen adjuntos a sus objetos de gráfico originales durante las ediciones de propiedades conocidas. Llame a ClearPreservedXml para descartar este XML retenido de un gráfico y regenerarlo solo a partir de propiedades tipadas
Ejemplo
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;Véase también