Unit: lxHandleX
带公式区域、缓存值、数据标签、趋势线集合以及 X/Y 误差线的图表系列
Description
系列会保留其显示名称、可选的名称公式、类别或 X 公式、数值或 Y 公式、气泡大小公式，以及存储在每个公式旁边的字符串或数值缓存。缓存数据点可改善离线渲染，并在图表编辑、工作表复制和打开-保存周期中保留下来
Series markers and smoothing
property MarkerFillColor: LongWord;
property MarkerBorderColor: LongWord;
property Smooth: Boolean;
property SmoothSet: Boolean;
property LegendDeleted: Boolean;
| MarkerFillColor | 线形图和散点图系列标记的填充色，以 RGB LongWord 表示；0 表示沿用 Excel 的自动主题色 |
| MarkerBorderColor | 系列标记的边框色，以 RGB LongWord 表示 |
| Smooth | True 时该系列渲染为平滑曲线而非直线段；与 MarkerSymbol/MarkerSize/MarkerSet 配合使用 |
| SmoothSet | 平滑标志是否已被显式设置，用于控制是否写出 OOXML 的 smooth 标志 |
| LegendDeleted | True 时把该系列从图例中移除但保留其绘制，并为它的系列索引写出一个 c:legendEntry 删除项 |
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;
类别级别按叶子在前的顺序排列，与 ChartML 的物理缓存顺序一致。每个级别都是一个稀疏的索引化字符串缓存。缺失的数据点继承该级别中前一个标签，而显式存储的空字符串会开启一个空区段，并阻止相邻分组之间被合并
ResolveCategoryLevels 会一次性具体化一个可访问的二维类别区域，除此之外保留导入的缓存。BuildCategorySpans 以 O(levels × points) 的复杂度返回感知父级的区段，使相同的子级文本只在同一父级区段内合并
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 是系列级的 A1 公式，DataLabelsCache 保留与图表一起存储的索引化文本。内部工作表区域每个工作簿世代刷新一次，而不可访问或外部的公式保留其导入的缓存，绝不触发隐式的文件或网络访问
ShowDataLabelsRangeSet 保留共享可见性是否显式出现的信息，各点方法维护稀疏的从 0 开始的可见性覆盖。自定义单元格文本在组合时位于系列名称、类别、数值、百分比和气泡大小组件之前，分隔符只插入在非空组件之间
TXLSXChart.DataLabelsRange 仍是一个兼容 facade。它的 setter 会广播到既有系列并为之后创建的系列提供初值，它的 getter 只在所有系列使用同一公式时才返回值
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
把缓存类型设为 xlsxChartCacheString 或 xlsxChartCacheNumber，数值数据可选设置 FormatCode，然后添加带索引的数据点。没有显式格式代码的数值缓存在写出时使用 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