高级 XLSX API 成员
这些成员涵盖不太常见但公开的 XLSX 编辑表面,它们补充了主要的工作簿、工作表、区域、样式、筛选和图表参考页面
工作表窗格、显示和背景
TXLSXWorksheet.SplitPanes 和 RemoveSplit 编辑拆分窗格状态;SplitRow、SplitCol、PaneStateKind 和 ScrollCol 暴露存储的视图坐标
DisplayRowColHeaders 控制行和列标题,GridLinesSet 区分显式网格线选择与默认值,DefaultFormat 加上 StyleOverlays 暴露工作表级样式状态
BackgroundImageData 和 BackgroundImageFormat 暴露工作表背景图像,BackgroundImageResource 提供与后端无关的只读负载和格式描述,ClearBackgroundImage 移除背景图像
窗格选择与滚动
GetSelectedAreas 和窗格优先的 SelectAreas 重载使用共享的 TXLSPanePosition 类型,保留有序且可重叠的 A1 区域,并返回携带活动区域索引的调用方快照
整行和整列的结构性编辑会重新映射每个窗格选择,保留幸存区域的顺序和活动区域身份,并在活动区域被删除时使用确定性的后继、前驱或边界单元格回退
选择归一化、结构重映射和快照构造使用单趟构建器和几何式容量增长,可以摊销线性地处理大范围区域
TryGetWindowScroll 和 ScrollWindow 使用相同的逻辑窗格和 1 起始坐标,同时独立保留整体 sheetView 与下方或右侧 pane 的滚动位置
缺失的窗格和无效的更新不会改动工作表;参见 工作表窗格选择与滚动
分页保持在一起的区域
KeepRowsTogether、ClearKeepRowsTogether、KeepColumnsTogether、ClearKeepColumnsTogether 和 KeepTogetherCount 定义在几何条件允许时应留在同一页上的块
BreakSplitsKeepBlock、ColBreakSplitsKeepBlock、KeepBlockBreakRow 和 KeepColBlockBreakCol 检查拟议的分页符如何与这些块交互
工作表编辑辅助方法
AddImagePair 写入一个主图像外加一个 Fallback 伴生图(如 SVG 和 PNG),AddChartFromRanges 从类型化的类别和值区域构建图表,CheckDataValidations 返回所有违规单元格
CheckDataValidation 针对覆盖单元格的每一条有效性规则测试一个候选值,有效时返回 -1,否则返回第一条不满足规则的 1 起始索引,并可选择只在候选值有效时才提交
GetCellVisibleFormat 解析生效的工作表、行、列、区域覆盖和显式单元格格式,而不创建空单元格;Subtotal 按某一列的变化对已排序区域分组,插入分类小计公式、可选的总计公式、继承的格式和大纲级别
SortRangeInternal 是区域和报表操作使用的高级稳定排序入口;调用方通常应优先使用 SortRange 或 TXLSXRange.Sort
ClearColWidth 和 ClearRowHeight 移除一列或一行显式设置的尺寸,使其回退到工作表默认值,与 HasColWidth / HasRowHeight 探测互补
大纲节点控制
TryGetOutlineNode 按 1 起始的行或列索引返回方向感知的汇总节点、明细区域、大纲级别、隐藏状态和显式折叠标记
SetOutlineNodeCollapsed 幂等地折叠或展开一个汇总节点,SetOutlineDisplayLevel 把 1 起始的大纲按钮级别应用到每个已物化的分组;两者都接受 xocPreserve、xocCollapse 或 xocExpand 的子项处理方式
ToggleRowGrouped 和 ToggleColGrouped 仍是兼容包装,接受第一个明细索引,并根据 SummaryBelow 或 SummaryRight 解析出实际的汇总节点
OpenDocument 原生的行和列分组通过 table:display 映射,在直接的元数据和结构性编辑后依然存活,并转换为 XLSX 汇总节点标记,不保留成员级折叠标志;参见 稀疏大纲几何
命名样式与表样式解析
TXLSXRange.ApplyNamedStyle 把区域链接到命名单元格样式;TXLSXLinkedStyle.AutomaticChoose 从样式推导受影响的格式部分,而 LinkedParts 显式选择字体、填充、边框、数字格式、对齐或保护
编辑 TXLSXNamedStyle.Style 会更新链接的部分而不丢弃本地覆盖,GetCellVisibleFormat 在不物化空白单元格的前提下解析出结果,连同工作表覆盖和表样式一起
TXLSXNamedStyles.FindByName 按显示名称定位命名样式条目,无需手动扫描集合
全部 60 个内建浅色、中色和深色表样式名称都解析为完整的基于主题的分节格式,由 HTML、PDF、图像、预览和查看器输出共享
公式转换
TXLSXCell.ConvertFormulaToValue 用公式的缓存值替换该公式,TXLSXCells.ConvertFormulasToValues 对存储的单元格集合执行相同的操作
公式输入验证
TXLSXWorkbook.FormulaEntryPolicy 和 TXLSXWorksheet.ValidateFormulaEntry 暴露共享的无副作用公式输入约定,区分空文本、未知函数、未知名称、语法失败和无效目标,并识别已注册的用户函数但不调用它们;参见 公式输入验证策略
单元格存储诊断
TXLSXCells.PackedStorageEnabled 控制兼容的行主序类型化批量写入所使用的打包 RLE 后端,PackedCellCount 报告其中保留的单元格数量,直到对象级访问物化出稳定的单元格句柄
GetStorageStatistics 报告行块、已填充行、对象、文本、公式、富文本、估计打包、活动打包、已分配、已使用和打包字符串的字节数,为内存决策提供量化依据;样式负载数量和避免的样式空白负载字节直接体现写时复制共享
自动筛选细节
TXLSXAutoFilterColumn.ClearValueFilters 清除值和日期组筛选,同时保留列条目
HasCriteria2 和 AndConnector 描述双条件自定义筛选;颜色筛选使用 HasColorFilter、HasColorFilter_CellColor 和 HasColorFilter_DxfId;图标筛选使用 HasIconFilter、HasIconFilter_Set 和 HasIconFilter_Id
动态筛选使用 HasDynamicFilter、HasDynamicFilter_Type、HasDynamicFilter_Val、HasDynamicFilter_ValSet、HasDynamicFilter_MaxVal 和 HasDynamicFilter_MaxValSet;RawXml 保留不支持的筛选负载
渐变填充
TXLSXFill.AddGradientStop 追加一个颜色停止点。GradientKind、GradientDegree、GradientLeft、GradientTop、GradientRight、GradientBottom、GradientStopCount 和 GradientStops 暴露线性或路径几何
BackgroundColorTheme、BackgroundColorIndex 和 BackgroundTintAndShade 保留非 RGB 背景颜色,TXLSXFills.AddLinearGradient 创建并注册一个完整的线性渐变
TXLSXFill.ForegroundColorTheme、ForegroundColorIndex 和 ForegroundTintAndShade 是对应的前景色成员,在 RGB 值之外保留主题、调色板索引和色调明暗前景色
图表
TXLSXChart 暴露 PlotGroupCount、ChartStyle、DispBlanksAs、PlotVisibleOnly 和兼容用的 DataLabelsRange 门面:它的 setter 会广播到当前系列并为后续系列设默认值,getter 只返回各系列一致的公式
TXLSXChartPlotGroup.Assign 复制一个绘图组;ZOrder、BarGrouping、GapWidth 和 Overlap 控制其排序和条形几何
TXLSXChartSeries 暴露 SolidFillHex、SolidFillSet、MarkerSymbol、MarkerSize、MarkerSet、LabelNumFmt、LabelNumFmtSet、LabelPos 和 LabelPosSet
逐系列的单元格来源标签使用 DataLabelsRange、DataLabelsCache、ShowDataLabelsRange 和 ShowDataLabelsRangeSet;SetPointShowDataLabelsRange 和 TryGetPointShowDataLabelsRange 维护稀疏的 0 起始可见性覆盖,而 ResolveDataLabelsRange 每次工作簿生成刷新一次可访问的工作表文本,并在不打开数据源的情况下保留外部缓存
TXLSXChartSeries.CategoriesMultiLevel 为层级化轴标签发出 c:multiLvlStrRef 类别,默认仍发出扁平的 c:strRef / c:numRef
TXLSXChartTrendline 暴露 Intercept、InterceptSet、Forward 和 Backward 预测期数,而 TXLSXChartAxis.ShowDispUnitsLabel 控制显示单位标签
条件格式与有效性验证
TXLSXConditionalFormat.ContainsCellFast 执行索引化的成员资格检查,HasStyle 报告差异样式,StdDev、EqualAverage 和 IsPivot 暴露高级规则标志
TXLSXConditionalFormat.AcquireWriteGuard 返回工作簿的 IXLSWorkbookWriteGuard,批量规则编辑在完成时只推进一次工作簿生成号
TXLSXDataValidation.ContainsCellFast 执行等效的索引化有效性区域成员资格检查
表格、工作表、链接、批注和图形
TXLSXTable.TableType、ConnectionId、ColumnQueryTableFieldIds 和 HasHeaderRow 保留查询支撑和无表头表格的元数据
TXLSXTable.FindFirst 和 FindNext 在调用方提供的工作表中扫描命名列等于某值的行,返回 1 起始的行号或 0,支持不区分大小写的字符串、数值和布尔比较
TXLSXSheets.AddCopy 复制一个带依赖对象的工作表,ByPos 按当前标签位置访问集合
TXLSXExternalLink.AddDefinedName 和 DefinedNameCount 维护缓存的外部名称,FindDefinedName 按名称定位条目;只读的 RelationshipId、SourceSlot 和 LinkKind 属性分别暴露外部链接部件的关系 ID、外部公式使用的 1 起始 [N] 槽位,以及链接分类(工作簿、DDE、OLE 或未知);TXLSXHyperlink.TargetFrame 保留目标浏览上下文
TXLSXDefinedName.UnknownAttributes 保留已定义名称上未被识别的属性,让不支持的扩展在 Roundtrip 后依然存活
TXLSXComment.AutoSizeFromText 将批注形状调整为与文本匹配,ClearFont 移除显式的富文本字体段
TXLSXImage.SvgData 存储 SVG 伴生图,CameraRange 标识链接图片的源区域;TXLSXTextBox.PrstToken 保留 DrawingML 预设几何令牌
图像共享负载而不复制字节:给 TXLSXImage.Blob 赋值(即带 Data、SvgData、CacheKey、ContentDigest、SvgContentDigest 和 ByteSize 的 IXLSXImageBlob 接口)是重复报表图像的零拷贝路径,摘要只计算一次用于保存时的媒体驻留,只读的 TXLSXImage.CacheKey 和 ContentDigest 报告被赋予的身份;报表缓存会拒绝同一个缓存键配上不同的字节或格式
DrawingObjectCount 和 DrawingObject 为图像、图表、文本框、保留的原始锚点和组暴露一个稳定的混合顺序;每个 TXLSXDrawingObject 暴露 Kind、Parent、ChildCount 和 TextBox,并可用 BringToFront、SendToBack、BringForward 和 SendBackward 重新排序
GroupDrawingObjects 从选中的对象创建感知变换的 DrawingML 组,UngroupDrawingObject 按顺序恢复其子对象,包括从现有包加载的组
经典工作表对应成员
TXLSWorksheet.SetBackgroundImage、ClearBackgroundImage 和 BackgroundImageResource 用于编写、移除和检查 BIFF8 工作表背景;位图数据以标准 BMP 暴露,原生或未知格式保留原始负载和格式代码,已知的背景在 Classic 与 XLSX 引擎之间双向转换
TXLSWorksheet.ConvertFormulasToValues 用缓存结果替换公式,OpenRTF 重载在默认或调用方选择的目标导入 RTF 表格,WriteAutoValue 从变体中选择单元格类型,DefaultFormat 暴露工作表默认 XF