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 o respetivo nome de apresentação, a fórmula de nome opcional, a fórmula de categoria ou X, a fórmula de valor ou Y, a fórmula de tamanho de bolha e a cache de cadeias ou numérica armazenada junto de cada fórmula. Os pontos em cache melhoram a renderização offline e sobrevivem a edições do gráfico, a cópias de folhas de cálculo e a ciclos de abrir-guardar.
Marcadores e suavização da série
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | Cor de preenchimento do marcador da série em gráficos de linhas/dispersão, como um LongWord RGB; 0 mantém a cor de tema automática do Excel |
| MarkerBorderColor | Cor de contorno do marcador da série, como um LongWord RGB |
| Smooth | True desenha a série como uma curva suavizada em vez de segmentos de linha reta; utilizar em conjunto com MarkerSymbol/MarkerSize/MarkerSet |
| SmoothSet | Indica se o sinalizador de suavização foi explicitamente definido, condicionando a emissão do sinalizador smooth do OOXML |
| LegendDeleted | True remove esta série da legenda mantendo-a desenhada, emitindo um delete de c:legendEntry para o respetivo índice de série |
Categorias multinível
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 categorias são ordenados com as folhas primeiro, correspondendo à ordem física da cache no ChartML. Cada nível é uma cache de cadeias indexada e esparsa. Os pontos em falta herdam o rótulo anterior nesse nível, enquanto uma cadeia vazia armazenada explicitamente inicia um intervalo vazio e impede a fusão entre grupos adjacentes
O ResolveCategoryLevels materializa uma única vez um intervalo de categorias bidimensional acessível e, fora disso, retém a cache importada. O BuildCategorySpans devolve spans com conhecimento do pai em tempo O(levels × points), para que texto filho igual só seja fundido dentro do mesmo span de pai
Rótulos de dados provenientes de células
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;
O DataLabelsRange é uma fórmula A1 por série e o DataLabelsCache retém o texto indexado armazenado com o gráfico. Os intervalos internos da folha de cálculo são atualizados uma vez por geração do livro de trabalho, enquanto as fórmulas inacessíveis ou externas mantêm a cache importada e nunca desencadeiam acesso implícito a ficheiros ou à rede
O ShowDataLabelsRangeSet preserva se a visibilidade partilhada estava explicitamente presente, e os métodos por ponto mantêm overrides de visibilidade esparsos com base zero. O texto de célula personalizado é composto antes dos componentes nome da série, categoria, valor, percentagem e tamanho de bolha, com o separador inserido apenas entre componentes não vazios
O TXLSXChart.DataLabelsRange permanece uma facade de compatibilidade. O respetivo setter propaga o valor às séries existentes e predefined-o para as séries criadas depois, enquanto o getter só devolve um valor quando todas as séries utilizam 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
Pontos em cache
Defina o tipo de cache como xlsxChartCacheString ou xlsxChartCacheNumber, defina opcionalmente o FormatCode para dados numéricos e, em seguida, adicione pontos indexados. As caches numéricas sem um código de formato explícito utilizam General ao serem escritas
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