库的其他 API 成员

本页补全了为核心工作簿、工作表、渲染、导入、诊断和查看器 API 提供支持的公共类型的参考内容，这些类型无需单独的面向任务指南

筛选和条件格式

TXLSCfValue、 TXLSDataBarSpec、 TXLSColorScaleSpec、 TXLSIconSetSpec和 TXLSDxfStyle 接受 AttachWriteGuardOwner，把规则对象链接到其所属工作簿，使编辑自动获得写入防护；所有者实现 TXLSCondFormatWriteGuardOwner，其唯一的 AcquireWriteGuard 方法把工作簿的写入防护交给规则。 TXLSDxfStyle 还添加了 FontColorIndex 与 FontColorIsIndexed ，以及用于调色板索引规则颜色的 FillFgColorIndex / FillFgColorIsIndexed 和 FillBgColorIndex / FillBgColorIsIndexed 这两组属性，并新增差异字体覆盖项 FontName、 FontSize和 FontScheme （空字符串、磅值，或 major / minor这类主题字体槽位），与既有的加粗、斜体、下划线和颜色成员并列；每次赋值都会获取写入防护，并把规则标记为脏以便重新输出

TXLSConnections、 TXLSDataTables和 TXLSQueryTables 公开 OnAcquireWriteGuard （类型分别为 TXLSConnectionAcquireWriteGuard、 TXLSDataTableAcquireWriteGuard和 TXLSQueryTableAcquireWriteGuard），其编辑路径通过该钩子先获取所属工作簿的 IXLSWorkbookWriteGuard 再进行修改，并在修改之后推进工作簿世代；防护会记录 StartGeneration， Complete 则标记写入完成，使依赖缓存能够重建

保留的数据连接带有类型化描述： TXLSConnectionKind （xlckUnknown、 xlckOdbc、 xlckDao、 xlckFile、 xlckWeb、 xlckOleDb、 xlckText、 xlckAdo）对连接分类， TXLSConnectionCredentials （xlccIntegrated、 xlccNone、 xlccStored、 xlccPrompt）记录其身份验证模式，每个连接参数值都以 TXLSConnectionParameterValueKind （xlcpvNone、 xlcpvBoolean、 xlcpvDouble、 xlcpvInteger、 xlcpvString、 xlcpvCell）标记。What-if 数据表通过 TXLSDataTableKind

模拟运算表与数据透视分组

图标集阈值可以通过编程方式渲染或验证： XLSCfIconSetCount 报告一个 TXLSIconSetType 定义了多少个图标， XLSBuildCfIconGeometry 则用绘制单个图标所需的图元（ TXLSCfIconGeometry ，种类TXLSCfIconPrimitive： TXLSCfIconPrimitiveKind、 cfipPolygon、 cfipEllipse、 cfipRect）和点（ cfipLine）填充TXLSCfIconPoint，让自定义渲染器与 Excel 内置图标形状保持一致

诊断、公式跟踪与验证

导入验证架构

来自 lxImportCheck 的 TXLSImportCheck 依据应用自有的规则验证 TXLSXWorksheet；它检查存储的标量值和存储的公式结果，使用从 1 开始的工作表坐标，不隐式地把文本转换为数字、日期或布尔值

Validator := TXLSImportCheck.Create;
try
  Validator.HeaderRow := 1;
  Rule := Validator.AddRule(2);
  Rule.Name := 'quantity';
  Rule.Flags := [irRequired, irValueType, irValueRange];
  Rule.ValueKind := ivkInteger;
  Rule.MinimumValue := 1;
  Rule.MaximumValue := 1000;

  Validator.AddUniqueRule([1, 3]).Name := 'account-and-region';
  Validator.AddCrossColumnRule(4, 5, icLessOrEqual).Name := 'start-before-end';
  FailureCount := Validator.Check(Sheet);
  if FailureCount > 0 then
    Validator.Annotate(Sheet, 'Import validator');
finally
  Validator.Free;
end;

HeaderRow > 0 从下一行开始检查并优先于 FirstRow；否则 FirstRow 默认为 1；LastRow = 0 使用工作表最后一个已用行，而正数的 LastRow 可以包含不存在的单元格而不创建它们；列必须在 1 到 16,384 之间，活动数据行边界必须在 1 到 1,048,576 之间

列规则与显式类型

AddRule(Column) 会替换并释放该列此前的规则；逐值的类型、范围、长度和模式谓词会跳过缺失值、null 和空字符串，而 irRequired 会报告它们；唯一性保留下文描述的独立策略；非空空白仍是一个值；数字不算布尔值，日期不算普通数字，看起来像数字的字符串仍是文本

赋值 MinimumValue 或 MaximumValue 即启用该边界； HasMinimum或 HasMaximum 任一都可以再次禁用它；两个包含性开关默认为 True；边界必须是有限的类型化数字或日期，两个边界必须可比较并描述一个非空区间；反序、缺失、不兼容或空的边界会在工作表验证开始前引发异常

数字边界比较数值，日期边界比较日期；整数对整数的比较保留全部 Int64 和 UInt64 位；不兼容类别的值无法通过范围检查；文本长度和正则谓词继续检查标量的文本表示，正则检查保留既有 IsMatch 行为，因此在需要完整文本匹配时请使用 ^...$ 这样的锚点；无效的正则表达式为兼容起见会禁用其模式检查

日期格式的 Excel 值

从 Excel 导入的单元格即使数字格式显示为日期，也可能包含数值序列号；当这是接受的导入架构时，请显式选择序列号模式；该模式只影响验证，绝不改变存储的单元格值

Rule := Validator.AddRule(4);
Rule.Flags := [irRequired, irValueType, irValueRange];
Rule.ValueKind := ivkDate;
if Sheet.Workbook.Date1904 then
  Rule.DateSerialMode := idsExcel1904
else
  Rule.DateSerialMode := idsExcel1900;
Rule.MinimumValue := VarFromDateTime(EncodeDate(2026, 1, 1));
Rule.MaximumValue := VarFromDateTime(EncodeDate(2026, 12, 31));

VarFromDateTime 声明在 Variants 中， EncodeDate 声明在 SysUtils 中；数值序列号必须非负，且必须解析到 10000 年 1 月 1 日之前；带小数的序列号保留其当日时间；1900 体系拒绝从 60（含）到 61（不含）之间的每一个序列号，因为该区间表示虚构的闰日；1904 体系把序列号零映射到 1904 年 1 月 1 日

日期边界包含当日时间，因此设为 12 月 31 日午夜的最大值会排除当天更晚的时间；当必须接受整个最后一天时，请使用次年 1 月 1 日作为不包含的上界；诸如 10/08/2026 的文本日期无论配置了哪种序列号模式都保持为文本

组合唯一性与跨列比较

组合键保留每个成员精确的 Variant 类型和文本标识； Integer(1)、 Double(1)、字符串 '1'、布尔值和日期是不同的成员；没有大小写折叠、Unicode 规范化、区域设置解析或分隔符歧义； ('ab', 'c')和 ('a', 'bc') 这样的组合仍然不同；每轮验证都从全新的元组索引开始

SkipIncompleteRows = True 时，缺失、null 或空字符串的成员会把该行排除在元组唯一性之外；设为 False 时这些成员以其原始 Variant 标识参与；重复项把第一个元组列报告为其单元格地址，并通过 FirstDuplicateRow 报告第一个匹配行

既有的单列 irUnique 保留其基于文本、不区分大小写的匹配行为并跳过缺失或 null 值；当某一列需要严格的类型化标识时，请使用 AddUniqueRule([Column])

跨列比较从不把字符串强转为数字、数字强转为布尔或普通数字强转为日期；不兼容类别的混合即使对 icNotEqual 也会失败；字符串比较区分组合与分解的 Unicode，保留内嵌的 null 字符，并按“较短前缀优先”排序； SkipBlankValues = False 时，任一空白操作数都会产生跨列违规

结构化结果与更正工作簿

Check(Sheet) 返回违规数量， ViolationCount和从零计数的 Violation(Index) 枚举报告；一条列规则报告其第一个失败的谓词，而独立配置的元组和比较规则可以为同一单元格追加更多违规；当调用方需要稳定的应用规则标识时，请赋值有意义的 Name

公式单元格使用其存储的缓存值验证；没有存储缓存结果的公式报告 ivFormulaCacheMissing，错误结果报告 ivCellError；当需要新鲜的公式结果时，请在检查前显式重新计算；验证不访问外部来源、不更改公式定义，也不求值未缓存的公式

OnVerifyCell 保留 TlxImportVerifyCell 回调签名，并在适用的列谓词和唯一性检查成功后运行；它返回布尔值并可设置应用错误消息；回调必须保持工作簿和验证架构不变，工作簿写入会被读取租约拒绝；回调异常会传播，租约随后释放供后续操作使用

Check 绝不批注、删除行或具体化打包值；检查后使用 Annotate 应用红色字体并把错误文本追加到既有批注，或显式调用 KeepOnlyViolations 移除未违规的行并创建更正工作簿；这些方法会修改所提供的工作表，因此请在审阅报告后于目标工作簿上调用

验证在同步调用期间借用工作表和工作簿；它不采纳调用方的对象所有权，也不要求接口所有的工作簿；读取租约在整个检查期间保护相关的存储单元格快照和存储公式缓存访问

外部链接保存策略

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

property IXLSWorkbook.SaveExternalLinkValues: Boolean;
property IXLSWorkbook.UpdateLinks: TXLSExternalLinkUpdateMode;
property TXLSXWorkbook.SaveExternalLinkValues: Boolean;
property TXLSXWorkbook.UpdateLinks: TXLSExternalLinkUpdateMode;
      

计算审核与工作簿提示

function TXLSWorkbook.RecalcAndVerify(MaxIssues: Integer = 10000): TXLSCalculationAuditReport;
function TXLSXWorkbook.RecalcAndVerify(MaxIssues: Integer = 10000): TXLSCalculationAuditReport;
function TXLSWorkbook.RecalcAndVerifyEx(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSXWorkbook.RecalcAndVerifyEx(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSWorkbook.RunCalculationAudit(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSWorkbook.FormulaIsVolatile(Formula: WideString): Boolean;

function TXLSWorkbook.AuditOverlayHash(SheetIndex, Row, Col: Integer): Integer;
function TXLSWorkbook.AuditOverlayRead(SheetIndex, Row, Col: Integer; var Value: Variant): Boolean;
procedure TXLSWorkbook.AuditOverlayWrite(SheetIndex, Row, Col: Integer; const Value: Variant);
procedure TXLSWorkbook.AuditOverlayClear;

TXLSCalculationAuditIssueKind = (xlcaiCacheMismatch, xlcaiParseFailure,
  xlcaiMissingFunction, xlcaiMissingName, xlcaiUnsupportedArguments,
  xlcaiCircularReference, xlcaiExternalReferenceDenied,
  xlcaiExternalReferenceMissing, xlcaiDataTableSkipped, xlcaiCancelled,
  xlcaiInternalFailure);

TXLSCalculationAuditIssue = record
  Kind: TXLSCalculationAuditIssueKind;
  SheetIndex: Integer;
  SheetName: WideString;
  Row: Integer;
  Col: Integer;
  Formula: WideString;
  Symbol: WideString;
  Expected: Variant;
  Actual: Variant;
  ResultCode: Integer;
  Stack: WideString;
  ExternalTarget: WideString;
end;
TXLSCalculationAuditIssues = array of TXLSCalculationAuditIssue;

TXLSRecalcAuditProgress = procedure(ASender: TObject;
  ACurrent, ATotal: Integer; var ACancel: Boolean) of object;

property WorkbookCodeName: WideString;
property CalculationThreadMode: TXLSCalculationThreadMode;
property ForceFullCalculationState: TXLSOptionalBooleanState;
property RefreshAllOnLoadState: TXLSOptionalBooleanState;
      

表公式与 IME 状态

property TXLSXTable.ColumnCalculatedFormulaArrayStates[Index: Integer]: TXLSTableFormulaArrayState;
property TXLSXTable.ColumnTotalsFormulaArrayStates[Index: Integer]: TXLSTableFormulaArrayState;
property TDataValidation.ImeMode: TXLSDataValidationImeMode;
property TXLSXDataValidation.ImeModeKind: TXLSDataValidationImeMode;
      

Web 加载项任务窗格的检查与移除

function IXLSWorkbook.HasWebAddinTaskPanes: Boolean;
function IXLSWorkbook.WebAddinTaskPaneCount: Integer;
function IXLSWorkbook.RemoveWebAddinTaskPanes: Integer;
function TXLSXWorkbook.HasWebAddinTaskPanes: Boolean;
function TXLSXWorkbook.WebAddinTaskPaneCount: Integer;
function TXLSXWorkbook.RemoveWebAddinTaskPanes: Integer;
      

工作簿对象显示策略

TXLSObjectDisplayMode = (xlsodmShowAll, xlsodmShowPlaceholders,
  xlsodmHideAll);

property IXLSWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSXWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSPaginationModel.ExportObjectPlaceholders: Boolean;
property TXLSPDFExport.ExportObjectPlaceholders: Boolean;
property TXLSSvgExport.ExportObjectPlaceholders: Boolean;
property TXLSPageImageExporter.ExportObjectPlaceholders: Boolean;
property TXLSPrintDocument.ExportObjectPlaceholders: Boolean;
property TXLSXHtmlExportOptions.ExportObjectPlaceholders: Boolean;
      

渲染校准值与快照

TXLSRenderCalibration = record
  WidthCorrection: Double;
  HeightCorrection: Double;
  LineSpacing: Double;
  CellMarginFactor: Double;
  ScreenScaling: Integer;
  MeasurementDpi: Integer;
end;

function XLSDefaultRenderCalibration: TXLSRenderCalibration;
function XLSValidateRenderCalibration(const AValue: TXLSRenderCalibration;
  out AInvalidField: TXLSRenderCalibrationField): Boolean;
      

渲染几何与字体度量

TXLSRenderGeometryBackend = (xlsrgbAutoFit, xlsrgbPagination, xlsrgbPdf,
  xlsrgbSvg, xlsrgbBitmap, xlsrgbPrintPreview, xlsrgbViewer, xlsrgbHtml);

TXLSRenderFont = record
  Name: WideString;
  Size: Double;
  Styles: TXLSRenderFontStyles;
  Charset: Byte;
end;

function CreateXLSRenderGeometry(
  const ACalibration: TXLSRenderCalibration;
  AWorkbookGeneration: UInt64;
  ABackend: TXLSRenderGeometryBackend;
  ACacheCapacity: Integer = 4096): IXLSRenderGeometry;

property TXLSHTMLExport.RenderGeometry: IXLSRenderGeometry;
property TXLSXHtmlExportSession.RenderGeometry: IXLSRenderGeometry;
      

导入、代码生成、比较与监视

工作簿比较

来自 lxCompare 的 TXLSXWorkbookCompare 比较两个 TXLSXWorkbook 实例，不重新计算公式，也不修改任何一个工作簿；工作表按不区分大小写的名称配对，仅改变工作表顺序不会产生差异

Options 的默认值为空，两个容差默认为零；默认比较报告新增或移除的工作表、新增或移除的存储单元格、变化的类型化字面值、变化的公式文本以及新增或移除的合并区域

字面值比较区分数字、文本、布尔值、日期、错误和空白：数字 1 与文本 '1' 不同，布尔值与其文本拼写不同，日期保留自身类型，错误按存储的错误代码比较；值相等的数值存储类型比较相等，而精确比较时不同的 Int64 值仍然不同

Options 的类型是 TlxCompareOptions，即 TlxCompareOption 的集合；启用一个选项会把它的差异加到默认比较中

SetFeatureLimits(MaxBytes, MaxItems) 在更改任一设置前验证两个正数限制； MaxFeatureBytes 默认 64 MiB， MaxFeatureItems 默认 1,000,000，单独的 setter 保留同样的原子验证

功能预算覆盖来自两个工作簿的分离规范字节总量和计数条目，包括富文本 run、筛选器 XML 节点、数据透视表字段、域成员与记录值以及 Slicer 或 Timeline 连接；读取器在构造原生 XML 前检查计数和大型文本输入，强制有界输出流，超出限制时引发 EXLSXSemanticBudget

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) 在更改任一设置前验证两个参数；两者必须有限且非负，单独的 AbsoluteTolerance和 RelativeTolerance setter 使用同样的验证

数值字面值和数值缓存值在其绝对差不超过 AbsoluteTolerance，或其差相对较大绝对值不超过 RelativeTolerance 时比较相等；阈值为零保留精确相等，相对计算避免极端相反值下的溢出，容差不强转文本，也不适用于日期、样式或几何

LeftName和 RightName 设置 Report 行使用的可选显示名称，默认为 left和 right；名称只影响报告，不影响工作表配对或比较

Comparer := TXLSXWorkbookCompare.Create;
try
  Comparer.Options := [lcoFormulaCachedResults, lcoCellStyles,
    lcoAxisGeometry];
  Comparer.SetNumericTolerance(0.001, 0.000001);
  DifferenceCount := Comparer.Compare(LeftWorkbook, RightWorkbook);
  for I := 0 to DifferenceCount - 1 do
  begin
    Entry := Comparer.Diff(I);
    ReportLines.Add(Entry.Describe);
  end;
finally
  Comparer.Free;
end;

Compare 返回差异数量， Count 随后读取该数量， Diff(Index) 使用从零开始的索引返回比较器拥有的 TlxCompareDiff；读取条目期间请保留比较器，并在又一次成功比较后重新获取条目

每个条目提供 Kind、 Sheet、适用时从 1 开始的 Row和 Col、 Ref、 LeftText、 RightText以及类型化的 LeftKind / RightKind 值； TlxCompareValueKind 包含 lcvNone、 lcvBlank、 lcvNumber、 lcvText、 lcvBoolean、 lcvDateTime、 lcvError和 lcvFormula， lcvNone 用于缺失的一侧或非值差异

TlxCompareKind 保留 lckSheetAdded、 lckSheetRemoved、 lckCellAdded、 lckCellRemoved、 lckValueChanged、 lckFormulaChanged、 lckMergeAdded和 lckMergeRemoved，并新增 lckFormulaCacheChanged、 lckStyleChanged、 lckRowGeometryChanged和 lckColumnGeometryChanged

样式差异在 LeftText和 RightText 中携带稳定的规范样式指纹；几何差异携带比较过的尺寸、隐藏、大纲和折叠状态， Ref 标识受影响的连续轴区间，行差异的 Row 设为其首行、 Col 为零，列差异的 Col 设为其首列、 Row 为零

功能差异使用 lckDefinedNameChanged、 lckDataValidationChanged、 lckConditionalFormatChanged、 lckTableChanged、 lckDrawingChanged、 lckPivotTableChanged、 lckPivotCacheChanged、 lckSlicerChanged或 lckTimelineChanged； Change 为 lccChanged、 lccAdded或 lccRemoved，存在的一侧携带其规范定义指纹，缺失的一侧携带空字符串

lckRichTextChanged 标识其单元格坐标处变化的 run 定义，并在 LeftText和 RightText 中携带规范 run 指纹；数值容差适用于单元格字面值和公式缓存，类型化功能定义则精确比较

功能引用标识作用域名称或表格名称，或对验证、条件格式和绘图定义使用从 1 开始的序列位置；插入或移动有序功能可能改变多个位置，而工作簿级名称条目的 Sheet 为空

lckBlankStyleRegionChanged 通过 Row、 Col、包含边界的 LastRow和 LastCol 以及 A1 Ref 标识变化的空白矩形；存储坐标由普通单元格比较和 lcoCellStyles 处理，因此请同时启用两个样式选项以一起检查存储单元格和空白区域

Describe 格式化单个条目， Report(List) 把格式化的条目追加到调用方拥有的 TStrings；类型化值变化在类型不同时包含类型标签，结果按工作表名称、行、列、差异类别和引用排序，而不是按单元格插入顺序

比较持有读取租约，通过分离的游标快照遍历存储单元格并保留打包存储；几何比较划分存储元数据边界和紧凑的重复行跨度，空白样式比较扫过活动矩形和存储单元格边界而不扫描百万行的矩形网格；工作量随存储功能、区域交集和报告的差异增长

失败的比较保留上一次成功的结果；无效的容差赋值同样保留既有设置和结果，而传入 nil 工作簿会清除结果并返回零

该比较覆盖 XLSX 外观层的存储单元格内容和选定的类型化功能定义；名称、验证、条件格式、表格和图表公式的拼写通过语义公式解析器规范化，而数据透视表计算公式保留其存储的定义文本

表格筛选器接受受支持的自定义、值列表、日期分组、颜色、图标、动态和 top-count 形状以及排序条件；独立的筛选列和值集条目规范化其顺序，布尔默认值和数字拼写规范化，排序条件顺序仍然有效

类型化的数据透视表、Slicer 和 Timeline 比较解析受支持的本地工作表来源和非 OLAP 绑定，不刷新也不评估可用性；原生 Slicer 可用性提示是派生的显示元数据，而成员选择和可识别的原生排序元数据会被比较

不透明的原生绘图属性、不完整的二进制数据透视表模型、外部或 OLAP 数据透视表来源、原始 PivotTable 补充记录和扩展 XML、未知的筛选器 XML，以及未建模的 Slicer 或 Timeline 扩展属性或子元素都会引发 EXLSSemanticSnapshot；保留此类数据并不意味着语义等价

选定的导入 PivotTable 和 PivotCache 功能也在比较类型化投影之前验证保留的原生 XML，包括嵌套字段元数据和缓存记录；未知命名空间、属性、子元素和扩展负载在同一协作功能限制内显式失败，而建模的 Slicer 缓存绑定仍然受支持

TSimpleDomNode.RawName 在读取器规范化的 Name 之外暴露原始元素 QName，允许命名空间敏感的检查而不改变既有的解析器名称匹配

工作簿设置和不透明的包元数据仍在比较范围之外；基础样式比较不评估条件格式或表样式外观，绘图比较保留语义快照受支持的图像、文本框、图表和有序组边界

有效富文本属性

TMsoFbtOpt.StoredPids 按排序顺序返回存储的 OfficeArt 属性标识符， TMsoFbtSp.PersistentFlags 公开原生形状标志而不分配属性或锚点

TMsoShapeContainer.HasPreservedObjectData 标识保留的 OBJ 尾部字节； HasOrdinaryEmbeddedPictureObjectData 检查图片尾部是否只包含可识别的剪贴板格式和零图片标志记录，并在不复制负载的情况下拒绝链接或未知记录

TMSOShapeTextBox.HasValidTextRuns 检查存储的 TXO run 边界和保留字段而不创建 run； TMsoDrawing.HasUnmodeledAppearance 标识被类型化解析器跳过的原生绘图数据，让捕获能够显式拒绝未解析的外观

TXLSXRichTextRun.BoldSet、 ItalicSet、 StrikethroughSet、 UnderlineSet、 VertAlignSet和 ColorSet 把继承的字体属性与显式覆盖区分开，包括 false 标志、none、基线和自动颜色；即使其值等于新 run 的初始默认值，setter 也会把属性标记为显式

TXLSXRichText.HasUnsupportedAppearance 报告类型化 run 模型无法表示的原生富属性；可移植捕获和有效富文本比较会显式拒绝此类 run，而受支持的共享/内联 run 属性和空白保留其导入语义

有效富文本比较在合并相邻相等 run 之前应用显式的 false 覆盖；继承与显式清除的属性在共享字符串去重和受支持的 XML 往返中保持不同

TXMLReader.ResolveNamespaceUri(Prefix, Uri) 在不改变读取器位置的情况下解析当前作用域内的命名空间绑定，不存在绑定时返回 false；空前缀请求默认命名空间，原始 QName 仍可用于命名空间敏感的检查

不可变的富文本/场景记录、捕获源扩展和 HXRSNP02 传输契约在 便携式无头输出中描述

分离式样式与轴检查

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) 为有效的从 1 开始坐标返回分离的 TXLSSemanticCellStyle，解析存储和打包样式、工作表默认值、适用的样式叠加、隐式日期格式、索引颜色和主题颜色，不具体化单元格，也不改变样式池；公开调用获取读取租约，并排除条件格式和表样式规则

TXLSXWorksheet.GetStoredAxisSpans(IsRow) 返回 TXLSXAxisSpans，即 TXLSXAxisSpan 记录数组，含包含边界的从 1 开始 FirstIndex和 LastIndex；它报告尺寸、隐藏、大纲和折叠元数据足迹，保留紧凑的重复行高跨度，并把工作表的有效默认值留给其普通属性

返回的跨度描述存储的元数据足迹，而不是不相交的规范化划分；比较两个轴的应用可以合并它们的首末边界，然后对每个结果区间各检查一次有效状态

TXLSXWorksheet.GetStoredStyleRegions 返回分离的 TXLSXStyleRegions，为紧凑的虚拟格式化足迹包含 FirstRow、 FirstCol、 LastRow和 LastCol 边界；这些足迹可能重叠，调用方使用 ReadSemanticCellStyle 读取它们的有效外观

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) 返回分离的 TXLSXSemanticFeatures 条目，含稳定的 Key、规范 Definition 字节和计数 ItemCount；可选的正数限制默认为 64 MiB 和 1,000,000 条

TXLSXSemanticFeatureKind 包含 xlsxSemanticDefinedNames、 xlsxSemanticDataValidations、 xlsxSemanticConditionalFormats、 xlsxSemanticTables、 xlsxSemanticDrawings、 xlsxSemanticPivotTables、 xlsxSemanticPivotCaches、 xlsxSemanticSlicers、 xlsxSemanticSlicerCaches、 xlsxSemanticTimelines和 xlsxSemanticTimelineCaches

定义名称和三种缓存使用工作簿级作用域并允许 nil 工作表；其他种类要求工作表属于该工作簿，规则和绘图保留其存储顺序，返回的数组和缓冲区是调用方拥有的副本；这些读取器获取读取租约，并继承上文描述的类型化覆盖范围和显式不受支持数据行为

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) 为从 1 开始坐标返回分离的规范 run 字节，当不存在富文本且 IncludePlainText 为 false 时返回空缓冲区；可选的 ConsumedItems: PInteger 接收捕获的 run 数量，纯文本捕获保留打包存储

TXLSPivotCacheField.GroupItemTypes[Index] 公开与 GroupItemLabels[Index] 对应的类型化种类，并拒绝存储分组标签域之外的索引

公式元数据与数据透视表查询回调

TXLSGetCellFormulaText和 TXLSCalculator.OnGetCellFormulaText 使用从 1 开始的 SheetIndex 和从 0 开始的 Row/Col 读取存储的表达式文本，返回 lxOk 或类型化错误代码，并遵守公式隐藏保护； TXLSGetPivotTable和 OnGetPivotTable 使用从 1 开始的 SheetIndex 和从 0 开始的区域坐标定位借用的表格

工作簿引擎在常规、只读和隔离计算上下文中接线这些可选回调；回调不重新计算目标、不刷新数据透视表来源，也不转移所有权

TXLSPivotDataConstraint 存储 FieldName和类型化 Item， TXLSPivotDataConstraints 收集字段/项对； TXLSPivotTable.GetDataValue 从分离的本地表格/缓存快照查询一个可见的受支持聚合， IntersectsQueryRange 使用包含建模报表筛选器单元格的从 1 开始工作表边界

TlxPivotQueryBudget 同步接收工作量和内存估算并返回求值能否继续； EXLSPivotQueryBudget和 EXLSPivotQueryUnsupported 区分耗尽的限制与不受支持的缓存或聚合模型

TXLSPivotCache.QueryModelIsComplete 独立于 BIFF 原始重放完整性记录解码查询就绪状态； QueryRecordsValid 公开导入记录有效性， SetQueryRecordValidity 在不刷新记录的情况下应用格式读取器优先级

显式代码页字节

把返回的 RawByteString 直接传给 AddRawString 或面向字节的流操作；把它转换为默认 AnsiString 可能在原生 FPC 系统上重新编码其字节

经典定义名称与数组公式块

经典字体、格式与样式池

包与二进制存储辅助工具

绘图与工作簿查看器新增内容

分页、图像输出与打印

经典图表模型与工作表图表对象

强类型图表解码模型

解码后的图表状态以普通记录和枚举的形式公开，检查代码无需再遍历原始 BIFF 记录： TXLSChartInfo 携带解码后的图表摘要，包含 TXLSChartTypeFamily （cfBar、 cfLine、 cfPie、 cfArea、 cfScatter、 cfRadar、 cfDoughnut、 cfSurface、 cfBubble），每个系列报告 TXLSChartSeriesType， TXLSChart3DState 和 TXLSChart3DInfo 描述三维视图。 TXLSChartAxisType （catCategory、 catValue、 catSeries、 catDate）和 TXLSChartLegendPosition 对坐标轴和图例分类，日期轴模型则使用 TXLSChartDateUnit （xcduDays、 xcduMonths、 xcduYears）和 TXLSChartDateValues。 TXLSCustomChart 通过 TXLSChartInfo公开解码后的模型；趋势线和误差线注解是强类型对象（TXLSChartTrendline、 TXLSChartErrorBars），可从每个系列访问

图表创作记录

图表工作表和构建器创作接受普通记录而非对象图： TXLSChartTrendlineInfo、 TXLSChartErrorBarsInfo、 TXLSChartDataLabelsInfo和 TXLSChartSeriesStyleInfo 填充传递给 TXLSWorksheets.AddChartSheet 和共享图表构建器的系列条目， TXLSPivotChartInfo 则描述图表附加到数据透视表时使用的数据透视图框架

经典图表填充检查

TXLSCustomChart.GetChartModel 解码 GelFrame 记录中受支持的原生 OfficeArt 属性表和第三属性表，包括复杂负载条目之后的属性；既有的构建器表示仍然受支持，格式错误的表边界使此前的类型化填充保持不变，并报告不受支持的记录

图表检查在添加类型化状态前验证完整的存储文本和批注负载：被截断的趋势线名称或数据标签分隔符通过 _UnsupportedSemanticRecordID 报告其记录 ID，而 nil 或尺寸不足的 SeriesText 头对 BIFF5 和 BIFF8 都报告该记录不受支持；声明的系列文本范围超出其负载时引发 EReadError，释放部分模型并使存储的图表记录保持不变

标记 getter 和填充检查保留原始图表存储；声明的外观捕获路径另行验证受支持的核心图表，而未经验证的富标题或形状扩展校验和仍然不受支持

有界的存储图表、字符串与字体读取器

TXLSChartStoredBytes 是分离的字节数组， TXLSChartStoredRecord 包含 RecordId和 Data；这些读取器检查保留的源存储，不创建解码的图表模型，也不求值公式

共享字符串表维护与 SST 输出

来自 lxStringTable 的 TXLSStringTable 支撑经典工作簿的共享字符串；以下成员覆盖读取端注册、槽位维护以及用于往返保存的原始 SST 输出

PDF 附件、签名与 HTML 导出

计算审核与工作簿控制

旧版 PivotCache 框架兼容性

StreamId 写为 SXStreamID 记录（[MS-XLS] §2.4.303），并作为 SXDB 头的 idstm 字段重复出现，两者必须相等； SourceDataType 写为 SXVS 记录（[MS-XLS] §2.4.317： $0001 工作表、 $0002 外部、 $0004 合并计算、 $0010 方案），并作为 SXDB 头的 vsType 字段重复出现，两者必须相等。从工作表区域构建的缓存以工作表类型起始，而从文件读回的缓存保留其子流携带的值，因此 BIFF 写入器绝不会让 SXDB 字段指向自己没有发出的记录； RawHasStorageStream 标记从自己的存储流加载的缓存，其工作簿全局描述符位于缓存记录之前

剪贴板集成与粘贴选项

TXLSPasteOption = (xlpoValuesOnly, xlpoInsertRows, xlpoInsertCols);
TXLSPasteOptions = set of TXLSPasteOption;

function XLSGetClipboardText: WideString;
function XLSSetClipboardText(const Text: WideString): Boolean;
function XLSSetClipboardTextAndHtml(const Text: WideString;
  const Html: AnsiString): Boolean;
function XLSBuildHtmlClipboard(const Html: AnsiString): AnsiString;
function XLSEncodeClipboardField(const Text: WideString): WideString;
function XLSClipboardHasText: Boolean;
function XLSParseClipboardGrid(const ClipboardText: WideString;
  Loader: TXLSCSVLoader): Boolean;
function XLSClipboardHasXmlSpreadsheet: Boolean;
function XLSGetClipboardXmlSpreadsheet: WideString;
function XLSParseXmlSpreadsheet(const XmlText: WideString;
  Loader: TXLSCSVLoader): Boolean;
function XLSClipboardHasBiff8: Boolean;
function XLSGetClipboardBiff8: AnsiString;
function XLSReadClipboardPasteData(out Biff8: AnsiString;
  out Text: WideString): Boolean;
function XLSSetClipboardBiff8(const Biff8: AnsiString;
  const Text: WideString; const Html: AnsiString = ''): Boolean;
      

单元格显示文本解析

TXLSCellDisplayMode = (xcdmFormattedValue, xcdmFormulaText,
  xcdmSuppressedZero);

TXLSCellDisplayOptions = record
  ShowFormulas: Boolean;
  ShowZeros: Boolean;
  SheetProtected: Boolean;
  FormulaWidthFactor: Double;
  DateSerialZero: Double;
end;

TXLSCellDisplayInput = record
  HasFormula: Boolean;
  FormulaHidden: Boolean;
  IsNumericZero: Boolean;
  FormulaText: WideString;
  FormattedText: WideString;
end;

TXLSCellDisplayResult = record
  Mode: TXLSCellDisplayMode;
  Text: WideString;
  TreatAsText: Boolean;
  EffectiveWidthFactor: Double;
end;

function XLSDefaultCellDisplayOptions: TXLSCellDisplayOptions;
function XLSNormalizeFormulaDisplayText(const FormulaText: WideString): WideString;
function XLSResolveCellDisplay(const Options: TXLSCellDisplayOptions;
  const Input: TXLSCellDisplayInput): TXLSCellDisplayResult;
      

经典数据验证对象

TXLSDataValidationType = (xlsDvAny, xlsDvWhole, xlsDvDecimal, xlsDvList,
  xlsDvDate, xlsDvTime, xlsDvTextLength, xlsDvCustom);
TXLSDvErrorStyle = (xlsDvErrStop, xlsDvErrWarning, xlsDvErrInformation);

TDVRange = class;             { one validation rule over one or more ranges }
TDVRangeList = class;         { the per-sheet rule collection }
TDataValidator = class;       { engine that checks edits against the rules }
      

索引颜色扫描与解析

TXLSIndexedColorKind = (xickPalette, xickAutomatic, xickSystem, xickInvalid);
TXLSSystemColorRole = (xscrNone, xscrWindowText, xscrWindowBackground,
  xscrChartText, xscrChartBackground, xscrChartNeutral, xscrToolTipText);

TXLSIndexedColorResolution = record
  Kind: TXLSIndexedColorKind;
  RawIndex: Int64;
  PaletteSlot: Integer;
  SystemColorRole: TXLSSystemColorRole;
  ARGB: LongWord;
  HasResolvedColor: Boolean;
end;

TXLSNearestIndexedColorMatch = record
  InputARGB: LongWord;
  ColorIndex: Integer;
  PaletteSlot: Integer;
  ARGB: LongWord;
  DistanceSquared: Double;
  ExactMatch: Boolean;
end;

TXLSIndexedColorUsageKind = (xicukFont, xicukFillForeground,
  xicukFillBackground, xicukGradient, xicukBorder, xicukConditionalFormat,
  xicukChart, xicukShape, xicukComment, xicukWorksheet, xicukOther);
      

A1 引用辅助函数

function XLSA1CellRef(ARow, ACol: Integer): WideString;
function XLSTryParseA1CellRef(const ARef: WideString;
  out ARow, ACol: Integer): Boolean;
function XLSTryParseA1RangeRef(const ARef: WideString;
  out ARow1, ACol1, ARow2, ACol2: Integer): Boolean;
      

另请参阅

• 附加的经典 XLS API 成员
• 高级 XLSX API 成员
• 稀疏分级显示几何
• 公式追踪与审核
• 工作簿查看器