Unit: lxHandleX
Séries de gráfico com intervalos de fórmulas, valores em cache, rótulos de dados, coleção de linhas de tendência e barras de erro X/Y
Description
Uma série retém seu nome de exibição, fórmula de nome opcional, fórmula de categoria ou X, fórmula de valor ou Y, fórmula de tamanho da bolha e o cache de cadeias ou números armazenado junto a cada fórmula. Pontos em cache melhoram a renderização offline e sobrevivem a edições do gráfico, cópias de planilhas e ciclos de abrir-salvar
Series markers and smoothing
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | Cor de preenchimento do marcador da série para gráficos de linha/dispersão como um RGB LongWord; 0 mantém a cor de tema automática do Excel |
| MarkerBorderColor | Cor de borda do marcador da série como um RGB LongWord |
| Smooth | True renderiza a série como uma curva suavizada em vez de segmentos de linha reta; combine com MarkerSymbol/MarkerSize/MarkerSet |
| SmoothSet | Se o sinalizador de suavização foi definido explicitamente, controlando a emissão do sinalizador smooth do OOXML |
| LegendDeleted | True remove esta série da legenda mantendo-a plotada, emitindo uma exclusão de c:legendEntry para o índice da série |
Multi-level categories
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;
Os níveis de categoria são ordenados da folha primeiro, acompanhando a ordem física do cache do ChartML. Cada nível é um cache de cadeias indexado esparso. Pontos ausentes herdam o rótulo anterior naquele nível, enquanto uma cadeia vazia armazenada explicitamente inicia um intervalo vazio e impede a mesclagem entre grupos adjacentes
ResolveCategoryLevels materializa uma vez um intervalo de categorias bidimensional acessível e, caso contrário, retém o cache importado. BuildCategorySpans retorna intervalos com reconhecimento do pai em tempo O(levels × points), de modo que texto filho igual só é mesclado dentro do mesmo intervalo de pai
Cell-sourced data labels
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 é uma fórmula A1 por série e DataLabelsCache retém o texto indexado armazenado com o gráfico. Intervalos internos de planilhas são atualizados uma vez por geração da pasta de trabalho, enquanto fórmulas inacessíveis ou externas mantêm o cache importado e nunca disparam acesso implícito a arquivos ou à rede
ShowDataLabelsRangeSet preserva se a visibilidade compartilhada estava presente explicitamente, e os métodos de ponto mantêm substituições esparsas de visibilidade com base zero. Texto personalizado de células é composto antes dos componentes de nome da série, categoria, valor, percentual e tamanho da bolha, com o separador inserido apenas entre componentes não vazios
TXLSXChart.DataLabelsRange permanece como uma fachada de compatibilidade. Seu setter propaga o valor para as séries existentes e o pré-configura nas séries criadas depois, enquanto seu getter retorna um valor apenas quando todas as séries usam a mesma 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
Cached points
Defina o tipo de cache como xlsxChartCacheString ou xlsxChartCacheNumber, opcionalmente defina FormatCode para dados numéricos e adicione os pontos indexados. Caches numéricos sem um código de formato explícito usam General quando gravados
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