ライブラリの追加 API メンバー

このページでは、主要なワークブック、ワークシート、描画、インポート、診断、ビューアーの各 API をサポートしながら、個別のタスク指向ガイドを必要としないパブリック型のリファレンスを補完します

フィルターと条件付き書式

TXLSCfValue、 TXLSDataBarSpec、 TXLSColorScaleSpec、 TXLSIconSetSpec、および TXLSDxfStyle は AttachWriteGuardOwnerを受け入れ、ルール オブジェクトをその所有ワークブックにリンクさせることで、編集時に書き込みガードが自動的に取得されるようにします。所有側は TXLSCondFormatWriteGuardOwnerを実装し、その唯一の AcquireWriteGuard メソッドがルールにワークブックの書き込みガードを渡します。 TXLSDxfStyle は、パレット インデックスのルール カラーのために FontColorIndex を伴う FontColorIsIndexed と、 FillFgColorIndex / FillFgColorIsIndexed および FillBgColorIndex / FillBgColorIsIndexed の各ペアに加え、差分フォントのオーバーライドである FontName、 FontSize、 FontScheme (空文字列、ポイント サイズ、または major / minorのようなテーマ フォント スロット) を、既存の太字・斜体・下線・色の各メンバーと併せて追加します。これらの代入はそれぞれ書き込みガードを取得し、再出力に備えてルールを dirty としてマークします

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

What-If データ テーブルとピボット グループ化

アイコン セットのしきい値は、プログラムから描画または検証できます。 XLSCfIconSetCount は TXLSIconSetType が定義するアイコンの数を報告し、 XLSBuildCfIconGeometry は 1 つのアイコンを描画するプリミティブ ( 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 です。境界は有限の型付き数値または日付でなければならず、2 つの境界は比較可能で空でない区間を記述しなければなりません。逆順、欠落、互換性がない、または空の境界は、ワークシート検証の開始前に発生します

数値境界は数値を比較し、日付境界は日付を比較します。整数対整数の比較は 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 の値をスキップします。1 つの列に対して厳密な型付き識別が必要な場合は AddUniqueRule([Column]) を使用してください

列間比較は、文字列から数値、数値からブール、通常の数値から日付への型強制を決して行いません。混在する互換性のないカテゴリは icNotEqual でも失敗します。文字列比較は、結合と分解された Unicode を区別し、埋め込み null 文字を保持し、短い前置詞優先の順序を使用します。SkipBlankValues = False のとき、どちらかの空白オペランドが列間違反を生みます

構造化された結果と修正ワークブック

Check(Sheet) は違反数を返し、ViolationCount と 0 始まりの Violation(Index) がレポートを列挙します。1 つの列ルールは最初に失敗した述語を報告し、独立して構成されたタプルと比較ルールは同じセルに対してさらに違反を追加できます。呼び出し側が安定したアプリケーション ルール識別子を必要とする場合は、意味のある 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 は、数式を再計算せず、どちらのワークブックも変更せずに 2 つの TXLSXWorkbook インスタンスを比較します。シートは大文字小文字を区別しない名前でペアリングされ、シート順序だけの変更は差分を生みません

既定の Options 値は空で、両方のトレランスの既定はゼロです。既定の比較は、追加または削除されたシート、追加または削除された保存セル、変更された型付きリテラル値、変更された数式テキスト、追加または削除された結合範囲を報告します

リテラル比較は、数値、テキスト、ブール値、日付、エラー、空白を区別します。数値 1 とテキスト '1' は異なり、ブールはそのテキスト表記と異なり、日付は独自の型を保持し、エラーは保存されたエラー コードで比較されます。値が等しい数値ストレージ型は等しく比較され、正確な比較では異なる Int64 値は異なるままです

Options の型は TlxCompareOption の集合である TlxCompareOptions です。オプションを有効化すると、その差分が既定の比較に追加されます

SetFeatureLimits(MaxBytes, MaxItems) は、どちらの設定も変更する前に両方の正の上限を検証します。MaxFeatureBytes の既定は 64 MiB、MaxFeatureItems の既定は 1,000,000 で、個別のセッターは同じ原子的検証を保持します

機能予算は、両ワークブックからの集約された独立した正準バイト数と数えられたエントリを対象とします。リッチテキスト run、フィルター XML ノード、ピボット フィールド、ドメイン メンバーとレコード値、スライサーまたはタイムライン接続が含まれます。リーダーは、ネイティブ XML を構築する前にカウントと大きなテキスト入力をチェックし、有界な出力ストリームを強制し、上限を超えると EXLSXSemanticBudget を発生させます

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) は、どちらの設定も変更する前に両方の引数を検証します。両方とも有限かつ非負でなければならず、個別の AbsoluteTolerance と RelativeTolerance のセッターは同じ検証を使用します

数値リテラルと数値キャッシュ値は、その絶対差が 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 は 1 つのエントリを書式化し、Report(List) は書式化されたエントリを呼び出し側所有の TStrings に追加します。型付き値の変更には、型が異なる場合に型ラベルが含まれます。結果はセルの挿入順序ではなく、シート名、行、列、差分の種類、参照で並べ替えられます

比較は読み取りリースを保持し、独立したカーソル スナップショットを通じて保存セルを走査し、パック済みストレージを保持します。ジオメトリは保存されたメタデータ境界とコンパクトな繰り返し行スパンを分割し、空白スタイル比較は、矩形の百万行グリッドを走査せずにアクティブな矩形と保存セルの境界をなぞります。ワークは保存された機能、リージョンの交差、報告された差分に応じて増加します

失敗した比較は、以前の成功した結果を保持します。無効なトレランス代入も既存の設定と結果を保持しますが、nil ワークブックを渡すと結果をクリアしてゼロを返します

この比較は、XLSX ファサードの保存セル コンテンツと選択された型付き機能定義をカバーします。名前、検証、条件付き書式、テーブル、グラフの数式表記はセマンティック数式パーサーを通じて正規化され、ピボット計算数式は保存された定義テキストを保持します

テーブル フィルターは、サポートされるカスタム、値リスト、日付グループ、色、アイコン、動的、上位カウントの各形状と並べ替え条件を受け付けます。独立したフィルター列と値セット エントリは順序を正規化し、ブールの既定値と数値表記は正規化されますが、並べ替え条件の順序は意味を持ったままです

型付きピボット、スライサー、タイムラインの比較は、更新や可用性の評価を行わずに、サポートされるローカル ワークシート ソースと非 OLAP バインディングを解決します。ネイティブ スライサー可用性ヒントは派生した表示メタデータであり、メンバー選択と認識されたネイティブ並べ替えメタデータは比較されます

不透明なネイティブ描画プロパティ、不完全なバイナリ ピボット モデル、外部または OLAP ピボット ソース、生のピボットテーブル補助レコードと拡張 XML、未知のフィルター XML、モデル化されていないスライサーやタイムラインの拡張属性または子は EXLSSemanticSnapshot を発生させます。そのようなデータの保持はセマンティック等価性を意味しません

選択されたインポート済みピボットテーブルとピボットキャッシュの機能は、型付き射影を比較する前に、ネストしたフィールド メタデータとキャッシュ レコードを含めて、保持されたネイティブ XML も検証します。未知の名前空間、属性、子、拡張ペイロードは、同じ協調的機能上限の中で明示的に失敗します。一方、モデル化されたスライサー キャッシュ バインディングはサポートされたままです

TSimpleDomNode.RawName は、リーダー正規化された Name と並んで元の要素 QName を公開するため、既存のパーサー名照合を変更せずに名前空間を考慮した検査ができます

ワークブック設定と不透明なパッケージ メタデータは比較の対象外です。基本スタイル比較は条件付き書式やテーブル スタイルの外観を評価せず、描画比較はセマンティック スナップショットのサポートされる画像、テキスト ボックス、グラフ、順序付きグループ境界を保持します

実効的なリッチテキスト プロパティ

TMsoFbtOpt.StoredPids はソート順で保存された OfficeArt プロパティ識別子を返し、TMsoFbtSp.PersistentFlags はプロパティやアンカーを割り当てずにネイティブ シェイプ フラグを公開します

TMsoShapeContainer.HasPreservedObjectData は保持された OBJ 末尾バイトを識別します。HasOrdinaryEmbeddedPictureObjectData は、画像末尾が認識されたクリップボード形式とゼロの画像フラグ レコードのみを含むことをチェックし、リンクまたは未知のレコードをペイロードをコピーせずに拒否します

TMSOShapeTextBox.HasValidTextRuns は run を作成せずに保存された TXO run 境界と予約フィールドをチェックします。TMsoDrawing.HasUnmodeledAppearance は型付きパーサーがスキップしたネイティブ描画データを識別するため、キャプチャは未解決の外観を明示的に拒否できます

TXLSXRichTextRun.BoldSet、 ItalicSet、 StrikethroughSet、 UnderlineSet、 VertAlignSet、 ColorSet は、false フラグ、none、ベースライン、自動色を含めて、継承されたフォント プロパティと明示的なオーバーライドを区別します。セッターは、その値が新しい run の初期既定と等しい場合でも、プロパティを明示としてマークします

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 を返します。これは、包含的な 1 始まりの FirstIndex と LastIndex を持つ TXLSXAxisSpan レコードの配列です。サイズ、非表示、アウトライン、折りたたみメタデータのフットプリントを報告し、コンパクトな繰り返し行高スパンを保持し、ワークシートの実効的な既定値は通常のプロパティを通じて利用可能なままです

返されるスパンは、互いに素な正規化された分割ではなく、保存されたメタデータのフットプリントを記述します。2 つの軸を比較するアプリケーションは、最初と最後の境界を組み合わせてから、結果として得られる各区間について実効的な状態を 1 回検査できます

TXLSXWorksheet.GetStoredStyleRegions は、コンパクトな仮想書式フットプリントのための包含的な FirstRow、 FirstCol、 LastRow、 LastCol 境界を含む独立した TXLSXStyleRegions を返します。これらのフットプリントは重なり得るため、呼び出し側は ReadSemanticCellStyle で実効的な外観を読み取ります

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) は、安定した Key、正準な Definition バイト、数えられた ItemCount を持つ独立した TXLSXSemanticFeatures エントリを返します。オプションの正の上限の既定は 64 MiB と 1,000,000 エントリです

TXLSXSemanticFeatureKind は xlsxSemanticDefinedNames、 xlsxSemanticDataValidations、 xlsxSemanticConditionalFormats、 xlsxSemanticTables、 xlsxSemanticDrawings、 xlsxSemanticPivotTables、 xlsxSemanticPivotCaches、 xlsxSemanticSlicers、 xlsxSemanticSlicerCaches、 xlsxSemanticTimelines、 xlsxSemanticTimelineCaches を含みます

定義名と 3 種類のキャッシュはワークブック全体のスコープを持ち、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 が field/item ペアを収集します。TXLSPivotTable.GetDataValue は独立したローカル テーブル/キャッシュ スナップショットから、可視のサポートされる集計を 1 つ照会し、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 が 3D 表示を記述します。 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 プロパティ テーブルと第 3 プロパティ テーブルをデコードします。既存のビルダー表現は引き続きサポートされ、不正なテーブル境界は以前の型付き塗りつぶしを変更せずに残し、未サポート レコードを報告します

グラフ検査は、型付き状態を追加する前に、保存された完全なテキストと注釈ペイロードを検証します。切り詰められた近似曲線名やデータラベル区切り文字は _UnsupportedSemanticRecordID を通じてそのレコード ID を報告し、nil または過小な SeriesText ヘッダーは BIFF5 と BIFF8 の両方でそのレコードを未サポートとして報告します。ペイロードを超える宣言済み series-text 寸法は EReadError を発生させ、部分的なモデルを解放し、保存されたグラフ レコードは変更しません

マーカー ゲッターと塗りつぶし検査は生のグラフ ストレージを保持します。宣言済み外観のキャプチャパスはサポートされるコア グラフを個別に検証しますが、未検証のリッチ タイトルやシェイプ拡張チェックサムは未サポートのままです

境界付き保存グラフ、文字列、フォント リーダー

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 メンバー
• スパース アウトライン ジオメトリ
• 数式のトレースと監査
• ワークブック ビューアー