其他函式庫 API 成員

本頁補足支援主要 Workbook、工作表、轉譯、匯入、診斷及檢視器 API 的公開型別參考，這些型別不需要另設工作導向指南

篩選與條件式格式

TXLSCfValue、 TXLSDataBarSpec、 TXLSColorScaleSpec、 TXLSIconSetSpec與 TXLSDxfStyle 都接受 AttachWriteGuardOwner，可將規則物件連結到其擁有的 Workbook，讓編輯自動取得寫入保護；擁有者需實作 TXLSCondFormatWriteGuardOwner，其唯一的 AcquireWriteGuard 方法會把 Workbook 的寫入保護交給規則。 TXLSDxfStyle 新增 FontColorIndex 與 FontColorIsIndexed ，以及用於調色盤索引規則色彩的 FillFgColorIndex / FillFgColorIsIndexed 與 FillBgColorIndex / FillBgColorIsIndexed 成對成員，再加上差異字型覆寫 FontName、 FontSize與 FontScheme （空字串、點數大小，或 major / minor這類佈景主題字型槽位），與既有的粗體、斜體、底線及色彩成員並列；每次指派都會取得寫入保護，並將規則標記為 dirty 以便重新輸出

TXLSConnections、 TXLSDataTables與 TXLSQueryTables 公開 OnAcquireWriteGuard （型別分別為 TXLSConnectionAcquireWriteGuard、 TXLSDataTableAcquireWriteGuard與 TXLSQueryTableAcquireWriteGuard），其編輯路徑會在變更前透過這個掛鉤取得擁有 Workbook 的 IXLSWorkbookWriteGuard ，並在之後推進 Workbook 世代；保護會記錄 StartGeneration， Complete 則標記寫入已完成，讓相依快取得以重建

保留下來的資料連線帶有具型別的描述： TXLSConnectionKind （xlckUnknown、 xlckOdbc、 xlckDao、 xlckFile、 xlckWeb、 xlckOleDb、 xlckText、 xlckAdo）為連線分類， TXLSConnectionCredentials （xlccIntegrated、 xlccNone、 xlccStored、 xlccPrompt）記錄其驗證模式，每個連線參數值則以 TXLSConnectionParameterValueKind （xlcpvNone、 xlcpvBoolean、 xlcpvDouble、 xlcpvInteger、 xlcpvString、 xlcpvCell）標記。模擬分析資料表透過 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 則回報它們；唯一性保留下面描述的各種原則；非空白的空白字元仍視為一個值；數字不算 Boolean，日期不算一般數字，而看似數字的字串仍是文字

指派 MinimumValue 或 MaximumValue 會啟用對應界限； HasMinimum 或 HasMaximum 任一可以再次停用它；兩個包含性開關預設都是 True；界限必須是有限的具型別數字或日期，兩個界限必須可比較且描述非空區間；反轉、缺漏、不相容或空白的界限會在工作表驗證開始前就引發例外

數字界限比較數值，日期界限比較日期；整數對整數的比較保留 Int64 與 UInt64 的全部位元；不相容類別的值會讓範圍檢查失敗；文字長度與 regex 述詞仍檢查純量的文字表示，regex 檢查也保留既有的 IsMatch 行為，因此當必須比對完整文字時請使用 ^...$ 這類錨點；無效的 regex 會停用其模式檢查以維持相容性

格式化為日期的 Excel 值

從 Excel 匯入的儲存格即使數字格式顯示日期，內容仍可能是數值 serial；當接受的匯入結構描述如此時，請明確選擇 serial 模式；該模式只影響驗證，絕不變更已儲存的儲存格值

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；數值 serial 必須為非負，且必須在西元 10000 年 1 月 1 日之前解析；帶小數的 serial 保留其時刻；1900 系統拒絕 60（含）到 61（不含）之間的每一個 serial，因為該區間表示虛構的閏日；1904 系統把 serial 0 對應到 1904 年 1 月 1 日

日期界限包含時刻，因此最大值設為 12 月 31 日午夜會排除當天更晚的時間；當必須接受整個最後一天時，請用隔年 1 月 1 日的排除式上界； 10/08/2026 這類文字日期無論設定的 serial 模式為何都保持為文字

複合唯一性與跨欄比較

複合鍵保留每個成員確切的 Variant 型別與文字身分； Integer(1)、 Double(1)、字串 '1'、Boolean 與日期是彼此不同的成員；沒有大小寫摺疊、Unicode 正規化、地區解析或分隔符號歧義； ('ab', 'c') 與 ('a', 'bc') 這類組合仍是不同的；每次驗證都從全新的元組索引開始

當 SkipIncompleteRows = True ，缺漏、null 或空字串成員會把該列排除在元組唯一性之外；設為 False 則以原始 Variant 身分納入這些成員；重複項會以第一個元組欄位作為儲存格位址，並透過 FirstDuplicateRow 回報第一個符合的列

既有的單欄 irUnique 保留其以文字為基礎、不分大小寫的比對行為，並略過缺漏或 null 值；當單一欄位需要嚴格的具型別身分時，請使用 AddUniqueRule([Column])

跨欄比較絕不把字串強制轉為數字、數字轉為 Boolean 或一般數字轉為日期；混合不相容類別即使對 icNotEqual 也會失敗；字串比較區分組合與分解的 Unicode、保留內嵌的 null 字元，並採用較短前綴優先的排序；當 SkipBlankValues = False ，任一空白運算元都會產生跨欄違規

結構化結果與修正活頁簿

Check(Sheet) 回傳違規數， ViolationCount 加上以 0 為基數的 Violation(Index) 列舉報告；單一欄位規則回報其第一個失敗的述詞，而獨立設定的元組與比較規則可以為同一儲存格追加更多違規；當呼叫端需要穩定的應用程式規則識別時，請指派有意義的 Name

公式儲存格以已儲存的快取值驗證；沒有已儲存快取結果的公式回報 ivFormulaCacheMissing ，錯誤結果則回報 ivCellError；需要最新的公式結果時，請在檢查前明確重新計算；驗證不存取外部來源、不變更公式定義，也不計算未快取的公式

OnVerifyCell 保留 TlxImportVerifyCell 回呼簽章，並在適用的欄位述詞與唯一性檢查成功後執行；它回傳 Boolean 且可以設定應用程式錯誤訊息；回呼必須保持活頁簿與驗證結構描述不變，活頁簿寫入會被讀取租約拒絕；回呼例外會向外傳播，租約則釋放給後續操作

Check 絕不註記、刪除列或具現化壓縮值；請在檢查後使用 Annotate 套用紅色字型並把錯誤文字附加到既有註解，或明確呼叫 KeepOnlyViolations 移除未違規的列以建立修正活頁簿；這些方法會修改傳入的工作表，因此請在審閱報告後於目標活頁簿上呼叫

驗證會在同步呼叫期間借用工作表與活頁簿；它不採用呼叫端的物件所有權，也不要求介面持有的活頁簿；讀取租約會在整個檢查期間保護相關的已儲存儲存格快照與已儲存公式快取存取

外部連結儲存原則

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

計算稽核與 Workbook 提示

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 Add-in 工作窗格檢查與移除

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

Workbook 物件顯示原則

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 是空集合，兩個容許誤差預設為零；預設比較回報新增或移除的工作表、新增或移除的已儲存儲存格、變更的具型別常值、變更的公式文字，以及新增或移除的合併範圍

常值比較區分數字、文字、Boolean、日期、錯誤與空白：數字 1 與文字 '1' 不同，Boolean 與其文字拼寫不同，日期保留自己的型別，錯誤則以已儲存的錯誤碼比較；值相等的數字儲存型別視為相等，而相異的 Int64 值在精確比較下仍相異

Options 的型別是 TlxCompareOptions ，即 TlxCompareOption 的集合；啟用某個選項會把其差異加到預設比較中

SetFeatureLimits(MaxBytes, MaxItems) 會在變更任一設定前驗證兩個正值限制； MaxFeatureBytes 預設 64 MiB， MaxFeatureItems 預設 1,000,000，個別 setter 保留相同的原子驗證

功能預算涵蓋來自兩份活頁簿的彙總分離標準位元組與計數項目，包括 rich-text 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) 以 0 為基數索引回傳比較器自有的 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 門面的已儲存儲存格內容與選定的具型別功能定義；名稱、驗證、條件式格式、資料表與圖表公式的拼寫會透過語意公式剖析器正規化，樞紐計算公式則保留其已儲存的定義文字

資料表篩選接受支援的自訂、值清單、日期群組、色彩、圖示、動態與前 N 名形狀及排序條件；獨立的篩選欄與值集項目會正規化其順序，Boolean 預設值與數字拼寫會正規化，排序條件的順序仍然重要

具型別的樞紐、Slicer 與 Timeline 比較會解析支援的本機工作表來源與非 OLAP 繫結，不重新整理也不評估可用性；原生 Slicer 可用性提示是衍生的顯示中繼資料，而成員選取與可辨識的原生排序中繼資料會被比較

不透明的原生繪圖屬性、不完整的二進位樞紐模型、外部或 OLAP 樞紐來源、原始 PivotTable 補充記錄與延伸 XML、未知篩選 XML，以及未建模的 Slicer 或 Timeline 延伸屬性或子節點會引發 EXLSSemanticSnapshot；保留這類資料並不代表語意等效

選定的已匯入 PivotTable 與 PivotCache 功能也會在比較具型別投影前驗證保留的原生 XML，包括巢狀欄位中繼資料與快取記錄；未知的命名空間、屬性、子節點與延伸承載會在同樣的合作式功能限制內明確失敗，而已建模的 Slicer 快取繫結仍受支援

TSimpleDomNode.RawName 在讀取器正規化的 Name 之外公開原始元素 QName，允許對命名空間敏感的檢查而不改變既有的剖析器名稱比對

活頁簿設定與不透明的套件中繼資料不在比較範圍內；基礎樣式比較不評估條件式格式或表格樣式外觀，繪圖比較則保留語意快照支援的圖片、文字方塊、圖表與有序群組界限

有效的 Rich Text 屬性

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、baseline 與自動色彩；即使值等於新 run 的初始預設，setter 仍會把該屬性標記為明確

TXLSXRichText.HasUnsupportedAppearance 回報具型別 run 模型無法表示的原生 rich 屬性；可攜式擷取與有效 rich-text 比較會明確拒絕這類 run，而受支援的共用／內嵌 run 屬性與空白字元保留其匯入語意

有效 rich-text 比較會在合併相鄰相等 run 之前先套用明確的 false 覆寫；在共用字串去重與受支援的 XML 往返中，繼承與明確清除的屬性保持區別

TXMLReader.ResolveNamespaceUri(Prefix, Uri) 解析目前範圍內的命名空間繫結而不改變讀取器位置，無繫結時回傳 false；空前綴請求預設命名空間，原始 QName 仍可用於對命名空間敏感的檢查

不可變的 rich/scene 記錄、擷取來源延伸與 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 位元組，當無 rich text 且 IncludePlainText 為 false 時回傳空緩衝區；選用的 ConsumedItems: PInteger 接收擷取的 run 數，純文字擷取保留壓縮儲存體

TXLSPivotCacheField.GroupItemTypes[Index] 公開對應 GroupItemLabels[Index] 的具型別種類，並拒絕超出已儲存群組標籤定義域的索引

公式中繼資料與 Pivot 查詢回呼

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 或位元組導向的串流操作；在原生 FPC 系統上把它轉成預設 AnsiString 可能重新編碼其位元組

Classic 定義名稱與陣列公式區塊

Classic 字型、格式與樣式集區

套件與二進位儲存輔助工具

繪圖與 Workbook 檢視器增補功能

分頁、影像輸出與列印

Classic 圖表模型與工作表圖表物件

具型別的圖表解碼模型

解碼後的圖表狀態以純記錄與列舉公開，檢查程式碼完全不必自己走訪原始 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 則描述圖表附加到樞紐分析表時所用的樞紐圖表框架

Classic 圖表填滿檢查

TXLSCustomChart.GetChartModel 解碼 GelFrame 記錄中受支援的原生 OfficeArt 屬性表與第三層屬性表，包括複雜承載項目之後的屬性；既有的建構器表示法仍受支援，格式錯誤的資料表界限會讓先前的具型別填滿保持不變並回報不受支援的記錄

圖表檢查會在加入具型別狀態前驗證完整的已儲存文字與註釋承載：被截斷的趨勢線名稱或資料標籤分隔符號會透過 _UnsupportedSemanticRecordID 回報其記錄 ID，nil 或尺寸不足的 SeriesText 標頭則把該記錄回報為 BIFF5 與 BIFF8 皆不支援；宣告的數列文字範圍超出其承載時引發 EReadError ，釋放部分模型並讓已儲存的圖表記錄保持不變

標記 getter 與填滿檢查保留原始圖表儲存；宣告外觀擷取路徑另行驗證受支援的核心圖表，未驗證的 rich title 或圖形延伸檢查碼仍不受支援

有界的已儲存圖表、字串與字型讀取器

TXLSChartStoredBytes 是分離的位元組陣列， TXLSChartStoredRecord 包含 RecordId 與 Data；這些讀取器檢查保留的來源儲存體，不建立已解碼的圖表模型也不計算公式

共用字串資料表維護與 SST 輸出

lxStringTable 中的 TXLSStringTable 支撐傳統活頁簿的共用字串；以下成員涵蓋讀取端註冊、槽位維護，以及供往返儲存使用的原始 SST 輸出

PDF 附件、簽章與 HTML 匯出

計算稽核與 Workbook 控制項

舊版 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 標記的則是從自有儲存資料流載入的快取，其 Workbook 全域描述符位於快取記錄之前

剪貼簿整合與貼上選項

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;
      

Classic 資料驗證物件

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;
      

另請參閱

• 其他 Classic XLS API 成員
• 進階 XLSX API 成員
• 稀疏大綱幾何
• 公式追蹤與稽核
• Workbook 檢視器