Unit: lxHandleX
Series de gráficos con rangos de fórmulas, valores en caché, etiquetas de datos, colección de líneas de tendencia y barras de error X/Y
Description
Una serie conserva su nombre para mostrar, la fórmula de nombre opcional, la fórmula de categorías o de X, la fórmula de valores o de Y, la fórmula de tamaño de burbuja y la caché de cadenas o de números almacenada junto a cada fórmula. Los puntos en caché mejoran el renderizado sin conexión y sobreviven a las ediciones del gráfico, a las copias de hojas de cálculo y a los ciclos de apertura y guardado
Marcadores de serie y suavizado
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | Color de relleno del marcador de la serie para gráficos de líneas o de dispersión, como un LongWord RGB; 0 conserva el color de tema automático de Excel |
| MarkerBorderColor | Color del borde del marcador de la serie como un LongWord RGB |
| Smooth | True dibuja la serie como una curva suavizada en lugar de segmentos de línea recta; combinar con MarkerSymbol/MarkerSize/MarkerSet |
| SmoothSet | Indica si la marca de suavizado se estableció explícitamente, lo que determina si se emite la marca smooth de OOXML |
| LegendDeleted | True quita esta serie de la leyenda manteniéndola trazada, y emite una eliminación de c:legendEntry para su índice de serie |
Categorías multinivel
property CategoriesMultiLevel: Boolean;
property CategoryLevelCount: Integer;
property CategoryLevels[Index: Integer]: TXLSXChartDataCache;
function AddCategoryLevel: TXLSXChartDataCache;
procedure ClearCategoryLevels;
procedure ResolveCategoryLevels;
function BuildCategorySpans(APointCount: Integer;
out ASpans: TXLSXChartCategorySpans): Integer;
Los niveles de categorías se ordenan con el nivel hoja primero, en concordancia con el orden físico de la caché de ChartML. Cada nivel es una caché de cadenas indexada dispersa. Los puntos faltantes heredan la etiqueta anterior de ese nivel, mientras que una cadena vacía almacenada de forma explícita inicia un span vacío y evita la combinación entre grupos adyacentes
ResolveCategoryLevels materializa una vez un rango de categorías bidimensional accesible y, en cualquier otro caso, conserva la caché importada. BuildCategorySpans devuelve spans que tienen en cuenta el elemento padre en tiempo O(levels × points), de modo que los textos de categorías hijas iguales solo se combinan dentro del mismo span del padre
Etiquetas de datos procedentes de celdas
property DataLabelsRange: WideString;
property DataLabelsCache: TXLSXChartDataCache;
property ShowDataLabelsRange: Boolean;
property ShowDataLabelsRangeSet: Boolean;
property SeparatorSet: Boolean;
property DataLabelRangeOverrideCount: Integer;
property DataLabelRangeOverrideIndexes[Index: Integer]: Integer;
property DataLabelRangeOverrideValues[Index: Integer]: Boolean;
procedure ResolveDataLabelsRange;
procedure SetPointShowDataLabelsRange(APointIndex: Integer;
AVisible: Boolean);
procedure ClearPointShowDataLabelsRangeOverrides;
function TryGetPointShowDataLabelsRange(APointIndex: Integer;
out AVisible: Boolean): Boolean;
DataLabelsRange es una fórmula A1 por serie y DataLabelsCache conserva el texto indexado almacenado junto al gráfico. Los rangos internos de la hoja de cálculo se actualizan una vez por generación del libro de trabajo, mientras que las fórmulas inaccesibles o externas mantienen su caché importada y nunca activan un acceso implícito a archivos o a la red
ShowDataLabelsRangeSet preserva si la visibilidad compartida estaba presente de forma explícita, y los métodos por punto mantienen invalidaciones de visibilidad dispersas de base cero. El texto de celda personalizado se compone antes de los componentes de nombre de serie, categoría, valor, porcentaje y tamaño de burbuja, con el separador insertado solo entre componentes no vacíos
TXLSXChart.DataLabelsRange sigue siendo una fachada de compatibilidad: su setter difunde el valor a las series existentes y preconfigura las series creadas después, mientras que su getter devuelve un valor solo cuando todas las series usan la misma fórmula
Properties
Name
NameRange
CategoriesRange
ValuesRange
BubbleSizeRange
DataLabelsRange
NameCache
CategoryCache
CategoriesMultiLevel
CategoryLevelCount
CategoryLevels
ValueCache
BubbleSizeCache
DataLabelsCache
DataLabelRangeOverrideCount
DataLabelRangeOverrideIndexes
DataLabelRangeOverrideValues
TrendlineCount
Trendlines
ErrBarX
ErrBarY
ShowValue
ShowCategoryName
ShowSeriesName
ShowLegendKey
ShowPercent
ShowBubbleSize
ShowDataLabelsRange
ShowDataLabelsRangeSet
Separator
SeparatorSet
MarkerFillColor
MarkerBorderColor
Smooth
SmoothSet
LegendDeleted
Puntos en caché
Establezca el tipo de caché en xlsxChartCacheString o xlsxChartCacheNumber, asigne opcionalmente FormatCode para datos numéricos y después añada puntos indexados. Las cachés numéricas sin un código de formato explícito usan General al escribirse
Methods
procedure Assign
function AddTrendline
function AddErrorBar
function AddCategoryLevel
procedure ClearCategoryLevels
procedure ResolveCategoryLevels
function BuildCategorySpans
procedure ResolveDataLabelsRange
procedure SetPointShowDataLabelsRange
procedure ClearPointShowDataLabelsRangeOverrides
function TryGetPointShowDataLabelsRange
See also