Weitere Bibliotheks-API-Elemente

Diese Seite vervollständigt die Referenz für öffentliche Typen, die die primären Arbeitsmappen-, Arbeitsblatt-, Rendering-, Import-, Diagnose- und Viewer-APIs unterstützen, aber keinen separaten aufgabenorientierten Leitfaden erfordern

Filterung und bedingte Formatierung

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpecund TXLSDxfStyle akzeptieren AttachWriteGuardOwnerund verknüpfen das Regelobjekt mit seiner besitzenden Arbeitsmappe, sodass Bearbeitungen automatisch einen Schreibguard anfordern; der Besitzer implementiert TXLSCondFormatWriteGuardOwner, dessen einzige Methode AcquireWriteGuard der Regel den Schreibguard der Arbeitsmappe übergibt. TXLSDxfStyle ergänzt FontColorIndex mit FontColorIsIndexed sowie die Paare FillFgColorIndex / FillFgColorIsIndexed und FillBgColorIndex / FillBgColorIsIndexed für palettenindizierte Regelfarben, dazu die differenziellen Schriftart-Overrides FontName, FontSizeund FontScheme (leere Zeichenfolge, ein Punktwert oder ein Design-Schriftart-Slot wie major / minor) neben den vorhandenen Membern für Fett, Kursiv, Unterstreichung und Farbe; jede Zuweisung fordert den Schreibguard an und markiert die Regel für die erneute Ausgabe als geändert

TXLSConnections, TXLSDataTables, and TXLSQueryTables expose OnAcquireWriteGuard , TXLSConnectionAcquireWriteGuardund TXLSDataTableAcquireWriteGuardlegen TXLSQueryTableAcquireWriteGuardoffen, den Hook, den ihre Bearbeitungspfade verwenden, um vor der Änderung den IXLSWorkbookWriteGuard der besitzenden Arbeitsmappe zu erhalten und danach die Arbeitsmappen-Generation voranzustellen; der Guard zeichnet StartGenerationauf, und Complete markiert den Schreibvorgang als abgeschlossen, sodass abhängige Caches neu aufgebaut werden können

Bewahrte Datenverbindungen tragen eine typisierte Beschreibung: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) klassifiziert die Verbindung, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) hält ihren Authentifizierungsmodus fest, und jeder Parameterwert einer Verbindung ist mit TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell) markiert. Was-wäre-wenn-Datentabellen melden ihre gespeicherte Definitionsart über TXLSDataTableKind

Was-wäre-wenn-Datentabellen und Pivotgruppierung

Symbolschwellen lassen sich programmgesteuert rendern oder validieren: XLSCfIconSetCount meldet, wie viele Symbole ein TXLSIconSetType definiert, und XLSBuildCfIconGeometry füllt eine TXLSCfIconGeometry mit den Primitiven (TXLSCfIconPrimitive, Art TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) und Punkten (TXLSCfIconPoint), die ein Symbol zeichnen, sodass eigene Renderer Excels eingebaute Symbolformen treffen

Diagnose, Formelverfolgung und Validierung

Importvalidierungs-Schemata

TXLSImportCheck aus lxImportCheck validiert ein TXLSXWorksheet gegen Regeln der Anwendung; es untersucht gespeicherte Skalarwerte und gespeicherte Formelergebnisse, mit 1-basierten Arbeitsblattkoordinaten und ohne implizite Konvertierung von Text zu Zahl, Text zu Datum oder Text zu Boolean

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 startet die Prüfung in der nächsten Zeile und hat Vorrang vor FirstRow; sonst ist FirstRow standardmäßig 1; LastRow = 0 verwendet die letzte genutzte Zeile des Arbeitsblatts, während ein positives LastRow abwesende Zellen einschließen kann, ohne sie zu erzeugen; Spalten müssen innerhalb von 1 bis 16.384 liegen und aktive Datenzeilen-Grenzen innerhalb von 1 bis 1.048.576

Spaltenregeln und explizite Typen

AddRule(Column) ersetzt jede frühere Regel für diese Spalte und gibt sie frei; die Prädikate für Wertetyp, Bereich, Länge und Muster pro Wert überspringen fehlende Werte, Nullen und leere Strings, während irRequired sie meldet; Eindeutigkeit behält die unten beschriebenen getrennten Politiken; nichtleeres Whitespace bleibt ein Wert; eine Zahl gilt nicht als Boolean, ein Datum nicht als gewöhnliche Zahl, und eine numerisch aussehende Zeichenfolge bleibt Text

Die Zuweisung von MinimumValue oder MaximumValue aktiviert die jeweilige Grenze; HasMinimum oder HasMaximum kann sie wieder deaktivieren; beide Inklusiv-Schalter stehen standardmäßig auf True; Grenzen müssen endliche typisierte Zahlen oder Datumswerte sein, und zwei Grenzen müssen vergleichbar sein und ein nichtleeres Intervall beschreiben; umgekehrte, fehlende, inkompatible oder leere Grenzen lösen eine Ausnahme aus, bevor die Arbeitsblattvalidierung beginnt

Zahlen-Grenzen vergleichen numerische Werte, Datums-Grenzen vergleichen Datumswerte; Ganzzahl-zu-Ganzzahl-Vergleiche bewahren alle Int64- und UInt64-Bits; Werte einer inkompatiblen Kategorie bestehen die Bereichsprüfung nicht; Textlängen- und Regex-Prädikate untersuchen weiterhin die Textrepräsentation des Skalars, und Regex-Prüfungen behalten das vorhandene IsMatch-Verhalten — verwenden Sie also Anker wie ^...$, wenn der komplette Text matchen muss; ein invalides Regex deaktiviert seine Musterprüfung aus Kompatibilitätsgründen

Datumsformatierte Excel-Werte

Eine aus Excel importierte Zelle kann eine numerische Serial enthalten, selbst wenn ihr Zahlenformat ein Datum anzeigt; wählen Sie einen Serial-Modus explizit, wenn genau das das akzeptierte Import-Schema ist; der Modus wirkt nur auf die Validierung und ändert niemals den gespeicherten Zellwert

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 ist in Variants deklariert, EncodeDate in SysUtils; numerische Serials müssen nichtnegativ sein und vor dem 1. Januar 10000 auflösen; fraktionale Serials behalten ihre Tageszeit; das 1900-System weist jede Serial von 60 inklusive bis 61 exklusiv zurück, weil dieses Intervall den fiktiven Schalttag bezeichnet; das 1904-System mappt Serial null auf den 1. Januar 1904

Datums-Grenzen schließen die Tageszeit ein — ein auf Mitternacht des 31. Dezember gesetztes Maximum schließt spätere Zeiten an diesem Tag aus; verwenden Sie eine exklusive Obergrenze am 1. Januar des Folgejahres, wenn der gesamte letzte Tag akzeptiert werden soll; Textdaten wie 10/08/2026 bleiben Text, unabhängig vom konfigurierten Serial-Modus

Zusammengesetzte Eindeutigkeit und spaltenübergreifende Vergleiche

Zusammengesetzte Schlüssel behalten den exakten Variant-Typ und die Textidentität jedes Mitglieds; Integer(1), Double(1), der String '1', ein Boolean und ein Datum sind unterschiedliche Mitglieder; es gibt kein Case Folding, keine Unicode-Normalisierung, kein Locale-Parsing und keine Trennzeichen-Mehrdeutigkeit; Kombinationen wie ('ab', 'c') und ('a', 'bc') bleiben verschieden; jeder Validierungsdurchlauf startet einen frischen Tupel-Index

Bei SkipIncompleteRows = True schließt ein fehlendes, Null- oder Leerstring-Mitglied diese Zeile aus der Tupel-Eindeutigkeit aus; bei False werden diese Mitglieder mit ihren ursprünglichen Variant-Identitäten einbezogen; ein Duplikat meldet die erste Tupelspalte als Zelladresse und die erste passende Zeile über FirstDuplicateRow

Das vorhandene einspaltige irUnique behält sein textbasiertes, Case-insensitives Matchverhalten und überspringt fehlende oder Null-Werte; verwenden Sie AddUniqueRule([Column]), wenn für eine Spalte strenge typisierte Identität nötig ist

Spaltenübergreifende Vergleiche koerzieren niemals Strings zu Zahlen, Zahlen zu Booleans oder gewöhnliche Zahlen zu Datumswerten; gemischte inkompatible Kategorien scheitern auch bei icNotEqual; Stringvergleiche unterscheiden komponierte und dekomponierte Unicode-Formen, bewahren eingebettete Null-Zeichen und verwenden kürzere-Präfix-zuerst-Ordnung; bei SkipBlankValues = False erzeugt jeder leere Operand eine spaltenübergreifende Verletzung

Strukturierte Ergebnisse und Korrektur-Arbeitsmappen

Check(Sheet) liefert die Anzahl der Verletzungen, und ViolationCount plus nullbasiertes Violation(Index) zählen den Bericht auf; eine Spaltenregel meldet ihr erstes fehlgeschlagenes Prädikat, während unabhängig konfigurierte Tupel- und Vergleichsregeln weitere Verletzungen für dieselbe Zelle hinzufügen können; weisen Sie aussagekräftige Name-Werte zu, wenn Aufrufer stabile anwendungsseitige Regel-Identifikatoren brauchen

Formelzellen werden anhand ihrer gespeicherten Cache-Werte validiert; eine Formel ohne gespeichertes Cache-Ergebnis meldet ivFormulaCacheMissing, ein Fehlerergebnis meldet ivCellError; berechnen Sie vor der Prüfung explizit neu, wenn frische Formelergebnisse nötig sind; die Validierung greift nicht auf externe Quellen zu, ändert keine Formeldefinitionen und wertet nicht gecachte Formeln nicht aus

OnVerifyCell behält die TlxImportVerifyCell-Callback-Signatur und läuft nach erfolgreichen anwendbaren Spaltenprädikaten und Eindeutigkeitsprüfungen; er liefert ein Boolean und kann eine anwendungsseitige Fehlermeldung setzen; Callbacks müssen Arbeitsmappe und Validierungsschema unverändert lassen, und Arbeitsmappen-Schreibvorgänge werden von der Leselease zurückgewiesen; Callback-Ausnahmen propagieren, und die Lease wird für nachfolgende Operationen freigegeben

Check annotiert nie, löscht keine Zeilen und materialisiert keine gepackten Werte; verwenden Sie Annotate nach der Prüfung, um rote Schrift anzuwenden und Fehlermeldungstext an vorhandene Kommentare anzuhängen, oder rufen Sie explizit KeepOnlyViolations auf, um nicht verletzende Zeilen zu entfernen und eine Korrektur-Arbeitsmappe zu erzeugen; diese Methoden ändern das gelieferte Arbeitsblatt — rufen Sie sie also nach Durchsicht des Berichts an der beabsichtigten Arbeitsmappe auf

Die Validierung leiht sich Arbeitsblatt und Arbeitsmappe für den synchronen Aufruf; sie übernimmt weder das Objekteigentum des Aufrufers noch verlangt sie eine interface-gehaltene Arbeitsmappe; eine Leselease schützt relevante gespeicherte Zell-Snapshots und den Zugriff auf gespeicherte Formel-Caches während der gesamten Prüfung

Speicherrichtlinien für externe Links

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Berechnungsaudit und Arbeitsmappenhinweise

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;
      

Tabellenformel- und IME-Zustand

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

Untersuchung und Entfernung von Web-Add-In-Aufgabenbereichen

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

Anzeigerichtlinie für Arbeitsmappenobjekte

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;
      

Renderkalibrierungswerte und Momentaufnahmen

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;
      

Rendergeometrie und Schriftmessung

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;
      

Import, Codegenerierung, Vergleich und Überwachung

Arbeitsmappenvergleich

TXLSXWorkbookCompare in lxCompare vergleicht zwei TXLSXWorkbook-Instanzen, ohne Formeln neu zu berechnen oder eine der Arbeitsmappen zu ändern; Blätter werden über Case-insensitive Namen gepaart, und eine alleinige Änderung der Blattreihenfolge erzeugt keinen Unterschied

Der Standardwert von Options ist leer, und beide Toleranzen stehen standardmäßig auf null; der Standardvergleich meldet hinzugefügte oder entfernte Blätter, hinzugefügte oder entfernte gespeicherte Zellen, geänderte typisierte Literalwerte, geänderten Formeltext sowie hinzugefügte oder entfernte Verbundbereiche

Der Literalvergleich unterscheidet Zahlen, Text, Boolean-Werte, Datumswerte, Fehler und Leerzellen: die Zahl 1 unterscheidet sich vom Text '1', ein Boolean unterscheidet sich von seiner Textschreibweise, Datumswerte behalten ihren eigenen Typ, und Fehler werden anhand ihres gespeicherten Fehlercodes verglichen; numerische Speichertypen mit gleichen Werten vergleichen gleich, während unterschiedliche Int64-Werte im exakten Vergleich unterschiedlich bleiben

Options hat den Typ TlxCompareOptions, eine Menge von TlxCompareOption; das Aktivieren einer Option ergänzt ihre Unterschiede zum Standardvergleich

SetFeatureLimits(MaxBytes, MaxItems) validiert beide positiven Limits, bevor eine der Einstellungen geändert wird; MaxFeatureBytes steht standardmäßig auf 64 MiB und MaxFeatureItems auf 1.000.000, und die einzelnen Setter wenden dieselbe atomare Validierung an

Feature-Budgets decken die aggregierten entkoppelten kanonischen Bytes und gezählten Einträge aus beiden Arbeitsmappen ab, einschließlich Rich-Text-Runs, Filter-XML-Knoten, Pivot-Feldern, Domänenmembern und Datensatzwerten sowie Slicer- oder Timeline-Verbindungen; Reader prüfen Zähler und große Texteingaben, bevor sie natives XML konstruieren, erzwingen begrenzte Ausgabeströme und lösen EXLSXSemanticBudget aus, wenn ein Limit überschritten wird

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) validiert beide Argumente, bevor eine der Einstellungen geändert wird; beide müssen endlich und nichtnegativ sein, und die einzelnen Setter für AbsoluteTolerance und RelativeTolerance verwenden dieselbe Validierung

Numerische Literal- und Cache-Werte vergleichen gleich, wenn ihre absolute Differenz höchstens AbsoluteTolerance beträgt oder ihre Differenz relativ zum größeren Absolutbetrag höchstens RelativeTolerance ist; eine Schwelle von null behält exakte Gleichheit bei, die relative Berechnung vermeidet Overflow bei extremen Gegenwerten, und Toleranz koerziert keinen Text und gilt nicht für Datumswerte, Stile oder Geometrie

LeftName und RightName setzen optionale Anzeigenamen, die Report-Zeilen verwenden, standardmäßig left und right; die Namen wirken nur auf die Berichterstattung, nicht auf Blattpaarung oder Vergleich

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 liefert die Differenzanzahl, Count liest diese Zahl danach, und Diff(Index) verwendet nullbasierte Indizierung und liefert einen Comparer-eigenen TlxCompareDiff; behalten Sie den Comparer beim Lesen seiner Einträge, und holen Sie Einträge nach einem weiteren erfolgreichen Vergleich neu

Jeder Eintrag bietet Kind, Sheet, 1-basierte Row und Col wo anwendbar, Ref, LeftText, RightText sowie typisierte LeftKind-/ RightKind-Werte; TlxCompareValueKind enthält lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvError und lcvFormula, wobei lcvNone für eine abwesende Seite oder einen Nicht-Wert-Unterschied steht

TlxCompareKind behält lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAdded und lckMergeRemoved und ergänzt lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChanged und lckColumnGeometryChanged

Stilunterschiede tragen stabile kanonische Stil-Fingerprints in LeftText und RightText; Geometrieunterschiede tragen den verglichenen Zustand von Größe, Ausgeblendet, Gliederung und Zusammengeklappt, wobei Ref das betroffene zusammenhängende Achsintervall identifiziert, bei Zeilen Row auf dessen erste Zeile und Col auf null gesetzt ist, bzw. bei Spalten Col auf dessen erste Spalte und Row auf null

Feature-Unterschiede verwenden lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChanged oder lckTimelineChanged; Change ist lccChanged, lccAdded oder lccRemoved, und jede vorhandene Seite trägt ihren kanonischen Definitions-Fingerprint, während eine abwesende Seite einen leeren String trägt

lckRichTextChanged identifiziert eine geänderte Run-Definition an ihrer Zellkoordinate und trägt kanonische Run-Fingerprints in LeftText und RightText; numerische Toleranz gilt für Zellliterale und Formel-Caches, während typisierte Feature-Definitionen exakt verglichen werden

Feature-Referenzen identifizieren Namen mit Geltungsbereich oder Tabellennamen oder verwenden 1-basierte Sequenzpositionen für Validierungs-, bedingte Format- und Zeichnungsdefinitionen; das Einfügen oder Verschieben eines geordneten Features kann mehrere Positionen ändern, während Arbeitsmappen-Nameseinträge ein leeres Sheet haben

lckBlankStyleRegionChanged identifiziert ein geändertes leeres Rechteck über Row, Col, inklusive LastRow und LastCol sowie seine A1-Ref; gespeicherte Koordinaten behandeln der gewöhnliche Zellvergleich und lcoCellStyles — aktivieren Sie also beide Stiloptionen, um gespeicherte Zellen und leere Bereiche gemeinsam zu inspizieren

Describe formatiert einen Eintrag, während Report(List) die formatierten Einträge an eine aufrufereigene TStrings-Liste anhängt; eine typisierte Wertänderung schließt Typbezeichnungen ein, wenn sich die Typen unterscheiden, und Ergebnisse sortieren nach Blattname, Zeile, Spalte, Unterschiedsart und Referenz statt nach Zelleinfügungsreihenfolge

Der Vergleich hält Leseleases, durchläuft gespeicherte Zellen über entkoppelte Cursor-Snapshots und behält gepackten Speicher; Geometrie partitioniert gespeicherte Metadatengrenzen und kompakte wiederholte Zeilenspannen, während der Leerstil-Vergleich aktive Rechteck- und gespeicherte Zellgrenzen abtastet, ohne ein rechteckiges Millionenzeilen-Raster zu scannen; der Aufwand wächst mit gespeicherten Features, Regionsschnittmengen und gemeldeten Unterschieden

Ein fehlgeschlagener Vergleich bewahrt das vorherige erfolgreiche Ergebnis; eine invalide Toleranzzuweisung bewahrt ebenfalls die vorhandenen Einstellungen und das Ergebnis, während die Übergabe einer nil-Arbeitsmappe das Ergebnis leert und null zurückgibt

Dieser Vergleich deckt den gespeicherten Zellinhalt der XLSX-Fassade und ausgewählte typisierte Feature-Definitionen ab; die Schreibweise von Namen, Validierungs-, bedingten Format-, Tabellen- und Diagrammformeln normalisiert über den semantischen Formelparser, während Pivot-berechnete Formeln ihren gespeicherten Definitionstext behalten

Tabellenfilter akzeptieren unterstützte benutzerdefinierte, Wertlisten-, Datumsgruppen-, Farb-, Symbol-, dynamische und Top-Count-Formen sowie Sortierbedingungen; unabhängige Filterspalten und Wertmengen-Einträge normalisieren ihre Reihenfolge, Boolean-Defaults und numerische Schreibweisen normalisieren, und die Reihenfolge von Sortierbedingungen bleibt signifikant

Typisierter Pivot-, Slicer- und Timeline-Vergleich löst unterstützte lokale Arbeitsblattquellen und Non-OLAP-Bindungen auf, ohne Verfügbarkeit zu aktualisieren oder auszuwerten; native Slicer-Verfügbarkeitshinweise sind abgeleitete Anzeigemetadaten, während Member-Auswahlen und erkannte native Sortiermetadaten verglichen werden

Opake native Zeichnungseigenschaften, unvollständige binäre Pivot-Modelle, externe oder OLAP-Pivot-Quellen, rohe PivotTable-Ergänzungsdatensätze und -Erweiterungs-XML, unbekanntes Filter-XML sowie nicht modellierte Slicer- oder Timeline-Erweiterungsattribute oder -Kinder lösen EXLSSemanticSnapshot aus; die Bewahrung solcher Daten impliziert keine semantische Äquivalenz

Ausgewählte importierte PivotTable- und PivotCache-Features validieren zusätzlich bewahrtes natives XML, bevor die typisierte Projektion verglichen wird, einschließlich verschachtelter Feldmetadaten und Cache-Datensätze; unbekannte Namespaces, Attribute, Kinder und Erweiterungs-Payloads schlagen innerhalb derselben kooperativen Feature-Limits explizit fehl, während modellierte Slicer-Cache-Bindungen unterstützt bleiben

TSimpleDomNode.RawName legt den ursprünglichen Element-QName neben dem lesernormalisierten Name offen und ermöglicht so namespace-sensible Inspektion, ohne das vorhandene Parser-Namen-Matching zu ändern

Arbeitsmappeneinstellungen und opake Paketmetadaten bleiben außerhalb des Vergleichs; der Basisstilvergleich wertet weder das Erscheinungsbild bedingter Formate noch das von Tabellenstilen aus, und der Zeichnungsvergleich bewahrt die unterstützten Bild-, Textfeld-, Diagramm- und geordneten-Gruppen-Grenzen des semantischen Snapshots

Effektive Rich-Text-Eigenschaften

TMsoFbtOpt.StoredPids liefert gespeicherte OfficeArt-Eigenschaftsbezeichner in sortierter Reihenfolge, während TMsoFbtSp.PersistentFlags native Shape-Flags offenlegt, ohne Eigenschaften oder Anker zu allokieren

TMsoShapeContainer.HasPreservedObjectData identifiziert bewahrte OBJ-Schwanz-Bytes; HasOrdinaryEmbeddedPictureObjectData prüft, dass Bildschwänze nur erkannte Clipboard-Format- und Null-Bildflag-Datensätze enthalten, und weist verlinkte oder unbekannte Datensätze ohne Kopieren der Payload zurück

TMSOShapeTextBox.HasValidTextRuns prüft gespeicherte TXO-Run-Grenzen und reservierte Felder, ohne Runs zu erzeugen; TMsoDrawing.HasUnmodeledAppearance identifiziert native Zeichnungsdaten, die der typisierte Parser überspringt, sodass die Erfassung ungelöste Darstellung explizit zurückweisen kann

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSet und ColorSet unterscheiden geerbte Schrift-Eigenschaften von expliziten Overrides, einschließlich false-Flags, none, Baseline und automatischer Farben; Setter markieren die Eigenschaft als explizit, selbst wenn ihr Wert dem anfänglichen Default des neuen Runs entspricht

TXLSXRichText.HasUnsupportedAppearance meldet native Rich-Eigenschaften, die das typisierte Run-Modell nicht darstellen kann; portable Erfassung und effektiver Rich-Text-Vergleich weisen solche Runs explizit zurück, während unterstützte Shared-/Inline-Run-Eigenschaften und Whitespace ihre importierte Semantik behalten

Der effektive Rich-Text-Vergleich wendet explizite false-Overrides an, bevor benachbarte gleiche Runs verdichtet werden; geerbte und explizit gelöschte Eigenschaften bleiben bei der Shared-String-Deduplizierung und unterstützten XML-Roundtrips unterschieden

TXMLReader.ResolveNamespaceUri(Prefix, Uri) löst die aktuell im Geltungsbereich liegende Namespace-Bindung auf, ohne die Leserposition zu ändern, und liefert false, wenn keine Bindung existiert; ein leerer Präfix fragt den Standard-Namespace an, und rohe QNames bleiben für namespace-sensible Inspektion verfügbar

Die unveränderlichen Rich-/Scene-Datensätze, die Capture-Source-Erweiterung und der HXRSNP02-Übertragungsvertrag sind in Portable Headless-Ausgabe beschrieben

Entkoppelte Stil- und Achseninspektion

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) liefert einen entkoppelten TXLSSemanticCellStyle für gültige 1-basierte Koordinaten und löst gespeicherte und gepackte Stile, Arbeitsblatt-Defaults, anwendbare Stil-Overlays, implizite Datumsformate, Indexpalettenfarben und Designfarben auf, ohne Zellen zu materialisieren oder Stilpools zu ändern; der öffentliche Aufruf erwirbt eine Leselease und schließt Regeln bedingter Formate und Tabellenstile aus

TXLSXWorksheet.GetStoredAxisSpans(IsRow) liefert TXLSXAxisSpans, ein Array aus TXLSXAxisSpan-Datensätzen mit inklusiven 1-basierten FirstIndex und LastIndex; er meldet Metadaten-Fußabdrücke für Größe, Ausgeblendet, Gliederung und Zusammengeklappt, bewahrt kompakte wiederholte Zeilenhöhen-Spannen und hält den effektiven Standard des Arbeitsblatts über dessen gewöhnliche Eigenschaften verfügbar

Die zurückgegebenen Spannen beschreiben gespeicherte Metadaten-Fußabdrücke statt einer disjunkten normalisierten Partition; Anwendungen, die zwei Achsen vergleichen, können deren erste und letzte Grenzen kombinieren und dann den effektiven Zustand einmal pro resultierendem Intervall inspizieren

TXLSXWorksheet.GetStoredStyleRegions liefert entkoppelte TXLSXStyleRegions mit inklusiven FirstRow, FirstCol, LastRow- und LastCol-Grenzen für kompakte Fußabdrücke virtueller Formatierung; diese Fußabdrücke können sich überlappen, und Aufrufer lesen ihr effektives Erscheinungsbild mit ReadSemanticCellStyle

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) liefert entkoppelte TXLSXSemanticFeatures-Einträge mit stabilem Key, kanonischen Definition-Bytes und gezähltem ItemCount; optionale positive Limits stehen standardmäßig bei 64 MiB und 1.000.000 Einträgen

TXLSXSemanticFeatureKind enthält xlsxSemanticDefinedNames, xlsxSemanticDataValidations, xlsxSemanticConditionalFormats, xlsxSemanticTables, xlsxSemanticDrawings, xlsxSemanticPivotTables, xlsxSemanticPivotCaches, xlsxSemanticSlicers, xlsxSemanticSlicerCaches, xlsxSemanticTimelines und xlsxSemanticTimelineCaches

Definierte Namen und die drei Cache-Arten verwenden arbeitsmappenweiten Geltungsbereich und erlauben ein nil-Blatt; die anderen Arten verlangen ein zur Arbeitsmappe gehörendes Arbeitsblatt, Regeln und Zeichnungen behalten ihre gespeicherte Sequenz, und zurückgegebene Arrays und Puffer sind Kopien im Eigentum des Aufrufers; diese Reader erwerben Leseleases und erben die typisierte Abdeckung und das explizite Verhalten bei nicht unterstützten Daten wie oben beschrieben

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) liefert entkoppelte kanonische Run-Bytes für 1-basierte Koordinaten oder einen leeren Puffer, wenn kein Rich-Text existiert und IncludePlainText false ist; das optionale ConsumedItems: PInteger empfängt die erfasste Run-Anzahl, und Plain-Text-Erfassung behält gepackten Speicher

TXLSPivotCacheField.GroupItemTypes[Index] legt die typisierte Art offen, die GroupItemLabels[Index] entspricht, und weist einen Index außerhalb der gespeicherten gruppierten Bezeichnungsdomäne zurück

Formelmetadaten- und Pivot-Abfrage-Callbacks

TXLSGetCellFormulaText und TXLSCalculator.OnGetCellFormulaText lesen gespeicherten Ausdruckstext mit einem 1-basierten SheetIndex und nullbasierten Row/Col, liefern lxOk oder einen typisierten Fehlercode und beachten formelverborgenen Schutz; TXLSGetPivotTable und OnGetPivotTable lokalisieren eine geliehene Tabelle über 1-basierten SheetIndex und nullbasierte Bereichskoordinaten

Die Arbeitsmappen-Engines verdrahten diese optionalen Callbacks in normalen, schreibgeschützten und isolierten Berechnungskontexten; Callbacks berechnen keine Ziele neu, aktualisieren keine Pivot-Quellen und übertragen kein Eigentum

TXLSPivotDataConstraint speichert einen FieldName und ein typisiertes Item, wobei TXLSPivotDataConstraints Feld-/Element-Paare sammelt; TXLSPivotTable.GetDataValue fragt ein sichtbares unterstütztes Aggregat aus einem entkoppelten lokalen Tabellen-/Cache-Snapshot ab, und IntersectsQueryRange verwendet 1-basierte Arbeitsblattgrenzen einschließlich modellierter Berichtsfilter-Zellen

TlxPivotQueryBudget empfängt Work- und Speicherschätzungen synchron und liefert, ob die Auswertung fortgesetzt werden kann; EXLSPivotQueryBudget und EXLSPivotQueryUnsupported unterscheiden erschöpfte Limits von nicht unterstützten Cache- oder Aggregatmodellen

TXLSPivotCache.QueryModelIsComplete zeichnet die Dekodier-Bereitschaft der Abfrage unabhängig von der Vollständigkeit der BIFF-Rohwiedergabe auf; QueryRecordsValid legt die Gültigkeit importierter Datensätze offen, und SetQueryRecordValidity wendet die Format-Reader-Präzedenz an, ohne Datensätze zu aktualisieren

Explizite Codepage-Bytes

Übergeben Sie den zurückgegebenen RawByteString direkt an AddRawString oder eine byteorientierte Stream-Operation; die Konvertierung in einen Default-AnsiString kann seine Bytes auf nativen FPC-Systemen umkodieren

Klassische definierte Namen und Array-Formelblöcke

Klassische Schrift-, Format- und Stilpools

Paket- und Binärspeicher-Hilfsfunktionen

Zeichnungs- und Arbeitsmappen-Viewer-Ergänzungen

Paginierung, Bildausgabe und Drucken

Classic-Diagrammmodelle und Diagrammobjekte im Arbeitsblatt

Typisiertes Diagramm-Dekodiermodell

Der dekodierte Diagrammzustand liegt als schlichte Datensätze und Enums vor, sodass Inspizierungscode nie rohe BIFF-Datensätze durchlaufen muss: TXLSChartInfo trägt die dekodierte Diagrammzusammenfassung mit TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), jede Reihe meldet TXLSChartSeriesType, und TXLSChart3DState zusammen mit TXLSChart3DInfo beschreibt dreidimensionale Ansichten. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) und TXLSChartLegendPosition klassifizieren Achsen und Legenden, während das Datumsachsenmodell TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) und TXLSChartDateValuesverwendet. TXLSCustomChart legt das dekodierte Modell über TXLSChartInfooffen; Trendlinien- und Fehlerindikator-Anmerkungen sind typisierte Objekte (TXLSChartTrendline, TXLSChartErrorBars), die von jeder Reihe aus erreichbar sind

Diagramm-Authoring-Datensätze

Das Authoring von Diagrammblättern und über den Builder akzeptiert schlichte Datensätze statt Objektgraphen: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfound TXLSChartSeriesStyleInfo füllen die Reiheneinträge, die an TXLSWorksheets.AddChartSheet und den gemeinsamen Diagrammbuilder übergehen, und TXLSPivotChartInfo beschreibt das Pivot-Chart-Framing, das beim Anhängen eines Diagramms an eine PivotTable verwendet wird

Classic-Inspektion von Diagrammfüllungen

TXLSCustomChart.GetChartModel dekodiert unterstützte native OfficeArt-Eigenschaftstabellen und tertiäre Eigenschaftstabellen in GelFrame-Datensätzen, einschließlich Eigenschaften nach Einträgen mit komplexer Payload; die vorhandene Builder-Repräsentation bleibt unterstützt, und fehlerhafte Tabellengrenzen lassen die vorherige typisierte Füllung unverändert und melden den nicht unterstützten Datensatz

Die Diagramminspektion validiert die vollständige gespeicherte Text- und Annotations-Payload, bevor typisierter Zustand ergänzt wird: abgeschnittene Trendlinien-Namen oder Datenbeschriftungs-Trenner melden ihre Datensatz-ID über _UnsupportedSemanticRecordID, während nil oder unterdimensionierte SeriesText-Header diesen Datensatz für BIFF5 und BIFF8 als nicht unterstützt melden; eine deklarierte SeriesText-Ausdehnung, die ihre Payload überschreitet, löst EReadError aus, gibt das Teilmodell frei und lässt die gespeicherten Diagrammdatensätze unverändert

Der Marker-Getter und die Füllungsinspektion bewahren die rohe Diagrammspeicherung; der Pfad der deklarierten Darstellungserfassung validiert unterstützte Kern-Diagramme separat, während nicht verifizierte Prüfsummen reicher Titel oder Shape-Erweiterungen nicht unterstützt bleiben

Begrenzte Reader für gespeicherte Diagramme, Strings und Schriftarten

TXLSChartStoredBytes ist ein entkoppeltes Byte-Array, und TXLSChartStoredRecord enthält RecordId und Data; diese Reader inspizieren zurückgehaltenen Quellspeicher, ohne ein dekodiertes Diagrammmodell zu erzeugen oder Formeln auszuwerten

Wartung der Shared-String-Tabelle und SST-Ausgabe

TXLSStringTable in lxStringTable trägt die Shared Strings der klassischen Arbeitsmappe; die folgenden Member decken die Reader-seitige Registrierung, die Slot-Wartung und die rohe SST-Ausgabe für Roundtrip-Speicherungen ab

PDF-Anhänge, Signaturen und HTML-Export

Berechnungsaudit und Arbeitsmappensteuerung

Kompatibilität mit altem PivotCache-Framing

StreamId wird als SXStreamID -Datensatz geschrieben ([MS-XLS] §2.4.303) und als SXDB -Feld des idstm -Headers wiederholt, wo es gleich sein muss; SourceDataType wird als SXVS -Datensatz geschrieben ([MS-XLS] §2.4.317: $0001 Arbeitsblatt, $0002 extern, $0004 Konsolidierung, $0010 Szenario) und als SXDB -Feld des vsType -Headers wiederholt, wo es gleich sein muss. Caches aus einem Arbeitsblattbereich starten mit dem Arbeitsblatt-Typ, während aus einer Datei zurückgelesene Caches den Wert behalten, den ihr Substream mitbrachte — der BIFF-Writer hinterlässt also nie ein SXDB -Feld, das einen nicht ausgegebenen Datensatz benennt; RawHasStorageStream markiert einen Cache, der aus seinem eigenen Speicherstream geladen wurde, dessen arbeitsmappenweiter Deskriptor den Cachedatensätzen vorangeht

Clipboard-Integration und Einfügeoptionen

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;
      

Auflösung des Zellanzeigetexts

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;
      

Klassische Datenvalidierungsobjekte

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 }
      

Indizierte Farben scannen und auflösen

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-Referenzhelfer

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;
      

Siehe auch

• Weitere klassische XLS-API-Elemente
• Erweiterte XLSX-API-Elemente
• Dünn besetzte Gliederungsgeometrie
• Formelverfolgung und -prüfung
• Arbeitsmappen-Viewer