Unit: lxHandleX
Seria wykresu z zakresami formuł, wartościami z pamięci podręcznej, etykietami danych, kolekcją linii trendu oraz słupkami błędów X/Y
Description
Seria zachowuje swoją nazwę wyświetlaną, opcjonalną formułę nazwy, formułę kategorii lub X, formułę wartości lub Y, formułę rozmiaru bąbelka oraz pamięć podręczną ciągów lub liczb zapisaną obok każdej formuły. Zbuforowane punkty poprawiają renderowanie offline i przetrwają edycje wykresu, kopie arkuszy oraz cykle otwarcia i zapisu.
Series markers and smoothing
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | Kolor wypełnienia markera serii dla wykresów liniowych/punktowych jako RGB LongWord; 0 zachowuje automatyczny kolor motywu Excela |
| MarkerBorderColor | Kolor obramowania markera serii jako RGB LongWord |
| Smooth | True renderuje serię jako wygładzoną krzywą zamiast prostych odcinków; łączy się z MarkerSymbol/MarkerSize/MarkerSet |
| SmoothSet | Czy flaga wygładzania została ustawiona jawnie; warunkuje emisję flagi smooth w OOXML |
| LegendDeleted | True usuwa tę serię z legendy, pozostawiając ją na wykresie, i emituje wpis usuwający c:legendEntry dla indeksu tej serii |
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;
Poziomy kategorii są uporządkowane od liści, zgodnie z fizyczną kolejnością pamięci podręcznej ChartML. Każdy poziom jest rzadką indeksowaną pamięcią podręczną ciągów. Brakujące punkty dziedziczą poprzednią etykietę w swoim poziomie, natomiast jawnie zapisany pusty ciąg otwiera pusty zakres i zapobiega scalaniu sąsiednich grup
ResolveCategoryLevels jednorazowo materializuje dostępny dwuwymiarowy zakres kategorii, a w pozostałych przypadkach zachowuje zaimportowaną pamięć podręczną. BuildCategorySpans zwraca zakresy świadome rodzica w czasie O(levels × points), dzięki czemu identyczny tekst potomny jest scalany tylko w obrębie tego samego zakresu rodzica
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 to formuła A1 pojedynczej serii, a DataLabelsCache przechowuje indeksowany tekst zapisany wraz z wykresem. Wewnętrzne zakresy arkusza odświeżają się raz na generację skoroszytu, natomiast formuły niedostępne lub zewnętrzne zachowują zaimportowaną pamięć podręczną i nigdy nie wyzwalają niejawnego dostępu do plików ani sieci
ShowDataLabelsRangeSet zachowuje informację, czy współdzielona widoczność była obecna jawnie, a metody punktowe utrzymują rzadkie nadpisania widoczności o indeksach od zera. Tekst z własnych komórek jest składany przed nazwą serii, kategorią, wartością, procentem i rozmiarem bąbelka, a separator trafia wyłącznie między niepuste składniki
TXLSXChart.DataLabelsRange pozostaje fasadą zgodności: jej setter rozgłasza wartość do istniejących serii i inicjuje serie utworzone później, a getter zwraca wartość tylko wtedy, gdy każda seria używa tej samej formuły
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
Ustaw rodzaj pamięci podręcznej na xlsxChartCacheString lub xlsxChartCacheNumber, opcjonalnie ustaw FormatCode dla danych liczbowych, a następnie dodaj indeksowane punkty. Pamięci podręczne liczb bez jawnego kodu formatu używają przy zapisie General
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