TXLSXCharts es la colección de gráficos incrustados expuesta por TXLSXWorksheet.Charts, y TXLSXChart controla la posición, los ejes y las series del gráfico
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 del gráfico
| Title, CategoryAxisTitle and ValueAxisTitle | Texto de título del gráfico y del eje primario |
| TitleTextStyle and TitleLayout | Propiedades tipadas para la fuente, el color, el énfasis, la rotación, la superposición y la posición manual del título del gráfico |
| ShowLegend, LegendPosition, LegendTextStyle and LegendLayout | Visibilidad de la leyenda, lado, superposición, fuente y posición manual |
| PlotAreaLayout | Rectángulo de trazado interior o exterior manual usando coordenadas ChartML normalizadas |
| FromRow, FromCol, ToRow and ToCol | Rectángulo de anclaje de la hoja con índices de base uno |
| CategoryAxis and ValueAxis | Eje de categorías o X primario y eje de valores o Y primario |
| 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 Series permanece como una vista de compatibilidad aplanada |
| HasPreservedXml | Informa si el gráfico conserva el ChartML original para viajes de ida y vuelta seguros ante extensiones |
| ShowDataTable and ShowDataTableKeys | Controles de visualización de la tabla de datos |
| ShowDataTableHorzBorder, ShowDataTableVertBorder and ShowDataTableOutline | Conmutadores independientes de bordes de la tabla de datos emitidos como c:showHorzBorder, c:showVertBorder y c:showOutline; los tres tienen True como valor predeterminado |
| HasDropLines and HasSeriesLines | Las líneas de caída de los gráficos de líneas 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íneas y bursátiles |
| 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áficos de radar para el tipo de gráfico actual |
| HoleSize and FirstSliceAng | Porcentaje del radio interior del anillo (10..90) y ángulo inicial en grados para gráficos circulares y de anillo |
| OfPieType, OfPieSplitType, OfPieSplitPos, OfPieSecondPieSize and OfPieGapWidth | Disposición de pie-of-pie y bar-of-pie, regla de división, y tamaños de trazado primario y secundario |
| RoundedCorners | Alterna las esquinas redondeadas del espacio del gráfico |
| AutoTitleDeleted | Suprime el título automático derivado del nombre de una única serie y emite c:autoTitleDeleted |
| ChartBackgroundColor, ChartBorderColor and PlotAreaBackgroundColor | Relleno y colores de 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 | Conmutador 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 propietaria de este gráfico |
Tipos de gráficos y grupos combinados
TXLSXChartType incluye las familias de columnas, barras, líneas, circular, áreas, anillo, dispersión, burbujas, radar, bursátil, of-pie, superficie, superficie 3D, columnas 3D, barras 3D, líneas 3D, circular 3D y áreas 3D
El primer grupo de trazado es el grupo de compatibilidad controlado por ChartType y AddSeries. Los grupos adicionales se agregan 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, de potencia 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 polinómico o periodo de 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 extremo de cualquiera de los lados de una barra de error |
Miembros de ejes y etiquetas de datos
| LogBase and Orientation | Base de la escala logarítmica y orden de ejes normal o invertido |
| MajorGridlines and MinorGridlines | Controles de visibilidad de las líneas de cuadrícula |
| MinValue, MaxValue, MajorUnit and MinorUnit | Límites de escala explícitos y separación de marcas cuando se admite |
| CrossesAt, TickLblPos and DispUnits | Posición de cruce del eje, ubicación de etiquetas y unidades mostradas |
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 |
Preservación de ChartML no compatible
Cuando TXLSXWorkbook.PreserveUnsupportedParts está habilitado, que es el valor predeterminado, un gráfico importado conserva su ChartML original. Un gráfico sin modificar 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, AlternateContent de markup-compatibility, 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