Unit: lxHandleX
Řada grafu s oblastmi vzorců, kešovanými hodnotami, popisky dat, kolekcí trendline a X/Y chybovými úsečkami
Description
Řada si uchovává zobrazovaný název, volitelný vzorec pro název, vzorec kategorií nebo X, vzorec hodnot nebo Y, vzorec velikosti bubliny a řetězcovou či číselnou mezipaměť uloženou vedle každého vzorce. Kešované body zlepšují offline vykreslování a přežijí úpravy grafu, kopírování listů i cykly otevření a uložení
Markery řady a vyhlazení
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | Barva výplně markeru řady pro spojnicové/bodové grafy jako RGB LongWord; hodnota 0 zachová automatickou barvu motivu Excelu |
| MarkerBorderColor | Barva ohraničení markeru řady jako RGB LongWord |
| Smooth | Hodnota MarkerSymbolvykreslí řadu jako vyhlazenou křivku místo přímých úseček; kombinujte sMarkerSize/MarkerSet |
| SmoothSet | Zda byl příznak vyhlazení explicitně nastaven; řídí vyslání příznaku smooth v OOXML |
| LegendDeleted | Hodnota c:legendEntry odstraní tuto řadu z legendy, ale ponechá ji vykreslenou, a vysílá pro její index řady mazací záznam |
Víceúrovňové kategorie
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;
Úrovně kategorií jsou seřazeny od listové úrovně (leaf first), což odpovídá fyzickému pořadí mezipaměti ChartML. Každá úroveň je řídká indexovaná řetězcová mezipaměť. Chybějící body dědí předchozí popisek v dané úrovni, zatímco explicitně uložený prázdný řetězec zahájí prázdný span a zabrání slučování napříč sousedními skupinami
ResolveCategoryLevels jednorázově materializuje přístupnou dvourozměrnou oblast kategorií, jinak zachovává importovanou mezipaměť. BuildCategorySpans vrátí span vnímající nadřazené úrovně v čase O(levels × points) , takže stejný text potomků se slučuje jen v rámci stejného nadřazeného spanu
Popisky dat z buněk
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 je vzorec A1 pro jednotlivé řady a DataLabelsCache uchovává indexovaný text uložený spolu s grafem. Interní oblasti listu se obnovují jednou za generaci sešitu, zatímco nepřístupné nebo externí vzorce ponechávají svou importovanou mezipaměť a nikdy nespouštějí implicitní přístup k souboru ani síti
ShowDataLabelsRangeSet zachovává informaci, zda byla sdílená viditelnost explicitně přítomna, a metody pro body spravují řídké přepisy viditelnosti s nulovým základem. Vlastní text buňky se skládá před komponentami názvu řady, kategorie, hodnoty, procenta a velikosti bubliny, přičemž oddělovač se vkládá pouze mezi neprázdné komponenty
TXLSXChart.DataLabelsRange zůstává kompatibilní fasádou. Jeho setter rozešle hodnotu existujícím řadám a přednastaví ji řadám vytvořeným později, zatímco getter vrátí hodnotu jen tehdy, když všechny řady používají stejný vzorec
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
Kešované body
Nastavte druh mezipaměti na xlsxChartCacheString nebo xlsxChartCacheNumber, pro číselná data volitelně nastavte FormatCode a poté přidávejte indexované body. Číselné mezipaměti bez explicitního formátovacího kódu použijí při zápisu General when written
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