Extra bibliotheek-API-leden

Deze pagina voltooit de referentie voor openbare typen die de primaire werkmap-, werkblad-, rendering-, import-, diagnostiek- en viewer-API's ondersteunen maar geen aparte taakgerichte handleiding vereisen

Filtering en voorwaardelijke opmaak

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpec en TXLSDxfStyle accepteren AttachWriteGuardOwneren koppelen het regelobject aan de bijbehorende werkmap, zodat bewerkingen automatisch een schrijfguard verkrijgen; de eigenaar implementeert TXLSCondFormatWriteGuardOwner, wiens enige methode AcquireWriteGuard de regel de schrijfguard van de werkmap geeft. TXLSDxfStyle voegt FontColorIndex met FontColorIsIndexed toe plus de paren FillFgColorIndex / FillFgColorIsIndexed en FillBgColorIndex / FillBgColorIsIndexed voor regelkleuren via de paletindex, plus de differential-font-overrides FontName, FontSizeen FontScheme (een lege tekenreeks, een puntgrootte of een thema-fontslot zoals major / minor) naast de bestaande leden voor bold, italic, underline en kleur; elke toewijzing verkrijgt de schrijfguard en markeert de regel als dirty voor heruitgifte

TXLSConnections, TXLSDataTablesen TXLSQueryTables leggen OnAcquireWriteGuard bloot (type TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuarden TXLSQueryTableAcquireWriteGuard), de hook die hun bewerkingspaden gebruiken om vóór de mutatie de IXLSWorkbookWriteGuard van de eigenende werkmap te verkrijgen en daarna de werkmapgeneratie op te schuiven; de guard registreert StartGeneration, en Complete markeert de schrijfbewerking als voltooid zodat afhankelijke caches opnieuw kunnen worden opgebouwd

Behouden gegevensverbindingen dragen een getypeerde beschrijving: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) classificeert de verbinding, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) legt de authenticatiemodus vast, en elke parameterwaarde van een verbinding is gelabeld met een TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). What-if-datatabellen melden hun opgeslagen definitietype via TXLSDataTableKind

Wat-als-datatabellen en draaitabelgroepering

Iconset-drempels kunnen programmatisch worden gerenderd of gevalideerd: XLSCfIconSetCount meldt hoeveel iconen een TXLSIconSetType definieert, en XLSBuildCfIconGeometry vult een TXLSCfIconGeometry met de primitieven (TXLSCfIconPrimitive, soort TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) en punten (TXLSCfIconPoint) waarmee één icoon wordt getekend, zodat aangepaste renderers aansluiten op de ingebouwde icoonvormen van Excel

Diagnostiek, formuletracering en validatie

Schema's voor importvalidatie

TXLSImportCheck uit lxImportCheck valideert een TXLSXWorksheet tegen regels in beheer van de toepassing; hij inspecteert opgeslagen scalaire waarden en opgeslagen formulieresultaten, met 1-based werkbladcoördinaten en zonder impliciete conversie van tekst naar getal, datum of 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 begint de controle bij de volgende rij en gaat vóór FirstRow; anders is de standaard van FirstRow 1; LastRow = 0 gebruikt de laatst gebruikte rij van het werkblad, terwijl een positieve LastRow afwezige cellen kan meenemen zonder ze aan te maken; kolommen moeten binnen 1 tot en met 16.384 vallen en actieve datarijgrenzen binnen 1 tot en met 1.048.576

Kolomregels en expliciete typen

AddRule(Column) vervangt elke eerdere regel voor die kolom en geeft die vrij; de predicaten per waardetype, bereik, lengte en patroon slaan ontbrekende waarden, nulls en lege strings over, terwijl irRequired ze meldt; uniekheid behoudt de hieronder beschreven aparte beleidsregels; niet-lege witruimte blijft een waarde; een getal geldt niet als Boolean, een datum geldt niet als gewoon getal en een getalachtige string blijft tekst

Het toewijzen van MinimumValue of MaximumValue schakelt die grens in; HasMinimum of HasMaximum kan die weer uitschakelen; beide inclusiviteitsschakelaars staan standaard op True; grenzen moeten eindige getypeerde getallen of datums zijn, en twee grenzen moeten vergelijkbaar zijn en een niet-leeg interval beschrijven; omgekeerde, ontbrekende, incompatibele of lege grenzen geven een fout voordat de werkbladvalidatie begint

Getalgrenzen vergelijken numerieke waarden en datumgrenzen vergelijken datums; integer-naar-integer-vergelijkingen behouden alle Int64- en UInt64-bits; waarden van een incompatibele categorie laten de bereikcontrole falen; tekstlengte- en regexpredicaten blijven de tekstrepresentatie van de scalair inspecteren, en regexcontroles behouden het bestaande IsMatch-gedrag, dus gebruik ankers zoals ^...$ wanneer de volledige tekst moet matchen; een ongeldige regex schakelt zijn patrooncontrole uit voor compatibiliteit

Datumgeformatteerde Excel-waarden

Een vanuit Excel geïmporteerde cel kan een numerieke serial bevatten ook wanneer zijn getalnotatie een datum toont; kies expliciet een serialmodus wanneer dat het geaccepteerde importschema is; de modus raakt alleen de validatie en verandert nooit de opgeslagen celwaarde

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 is gedeclareerd in Variants en EncodeDate in SysUtils; numerieke serials moeten niet-negatief zijn en vóór 1 januari 10000 oplossen; fractionele serials behouden hun dagdeel; het 1900-stelsel wijst elke serial van 60 inclusief tot en met 61 exclusief af, omdat dat interval de fictieve schrikkeldag aanduidt; het 1904-stelsel mapt serial nul op 1 januari 1904

Datumgrenzen omvatten het dagdeel, dus een maximum dat is ingesteld op middernacht van 31 december sluit latere tijdstippen op die dag uit; gebruik een exclusieve bovengrens op 1 januari van het volgende jaar wanneer de hele laatste dag geaccepteerd moet worden; tekstuele datums zoals 10/08/2026 blijven tekst, ongeacht de geconfigureerde serialmodus

Samengestelde uniekheid en vergelijkingen tussen kolommen

Samengestelde sleutels behouden het exacte Variant-type en de tekstidentiteit van elk lid; Integer(1), Double(1), de string '1', een Boolean en een datum zijn verschillende leden; er is geen case folding, Unicode-normalisatie, localeparsing of scheidingstekenambiguïteit; combinaties zoals ('ab', 'c') en ('a', 'bc') blijven verschillend; elke validatiepass start een verse tuple-index

Wanneer SkipIncompleteRows = True, sluit een ontbrekend, null of leeg-string-lid die rij uit van tuple-uniekheid; zet het op False om die leden op te nemen met hun oorspronkelijke Variant-identiteiten; een duplicaat meldt de eerste tuplekolom als celadres en de eerste matchende rij via FirstDuplicateRow

De bestaande irUnique voor één kolom behoudt zijn tekstgebaseerde, hoofdletterongevoelige matchgedrag en slaat ontbrekende of null-waarden over; gebruik AddUniqueRule([Column]) wanneer strikte getypeerde identiteit voor één kolom vereist is

Vergelijkingen tussen kolommen coerceren nooit strings naar getallen, getallen naar Booleans of gewone getallen naar datums; gemengde incompatibele categorieën falen, ook voor icNotEqual; stringvergelijkingen onderscheiden samengestelde en ontbonden Unicode, behouden ingebedde null-tekens en gebruiken kortere-prefix-eerst-volgorde; wanneer SkipBlankValues = False, levert elke lege operand een overtreding tussen kolommen op

Gestructureerde resultaten en correctiewerkmappen

Check(Sheet) geeft het aantal overtredingen terug, en ViolationCount plus nulgebaseerde Violation(Index) sommeren het rapport op; één kolomregel meldt zijn eerste falende predicaat, terwijl onafhankelijk geconfigureerde tuple- en vergelijkingsregels extra overtredingen voor dezelfde cel kunnen toevoegen; wijs betekenisvolle Name-waarden toe wanneer aanroepers stabiele toepassingsregel-ID's nodig hebben

Formulecellen worden gevalideerd met hun opgeslagen gecachte waarden; een formule zonder opgeslagen cacheresultaat meldt ivFormulaCacheMissing, en een foutresultaat meldt ivCellError; herbereken expliciet vóór de controle wanneer verse formuleresultaten vereist zijn; validatie benadert geen externe bronnen, wijzigt geen formuledefinities en evalueert geen ongecachte formules

OnVerifyCell behoudt de callbacksignatuur TlxImportVerifyCell en draait na geslaagde toepasselijke kolompredicaten en uniciteitscontroles; hij geeft een Boolean terug en kan een toepassingsfoutmelding zetten; callbacks moeten de werkmap en het validatieschema ongewijzigd laten, en werkmaphandelingen worden geweigerd door de leeslease; callback-exceptions planten zich voort en de lease wordt vrijgegeven voor volgende operaties

Check annoteert nooit, verwijdert geen rijen en materialiseert geen gepakte waarden; gebruik Annotate na de controle om rode fonts toe te passen en fouttekst aan bestaande opmerkingen toe te voegen, of roep expliciet KeepOnlyViolations aan om niet-overtredende rijen te verwijderen en een correctiewerkmap te maken; deze methoden wijzigen het meegeleverde werkblad, dus roep ze aan op de bedoelde werkmap nadat je het rapport hebt bekeken

Validatie leent het werkblad en de werkmap voor de synchrone aanroep; hij neemt het objecteigendom van de aanroeper niet over en vereist geen interface-beheerde werkmap; een leeslease beschermt relevante opgeslagen cel-snapshots en toegang tot opgeslagen formulecaches gedurende de hele controle

Opslagbeleid voor externe koppelingen

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Berekeningsaudit en werkmap-hints

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;
      

Tabelformules en IME-status

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

Inspectie en verwijdering van taakvensters van web-invoegtoepassingen

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

Weergavebeleid voor werkmapobjecten

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;
      

Renderkalibratiewaarden en momentopnames

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 en lettertypemeting

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, codegeneratie, vergelijking en bewaking

Werkmapvergelijking

TXLSXWorkbookCompare in lxCompare vergelijkt twee TXLSXWorkbook-instanties zonder formules te herberekenen of één van beide werkmappen te wijzigen; bladen worden gekoppeld op hoofdletterongevoelige naam, en het alleen wijzigen van de bladvolgorde levert geen verschil op

De standaardwaarde van Options is leeg en beide toleranties staan standaard op nul; standaardvergelijking meldt toegevoegde of verwijderde bladen, toegevoegde of verwijderde opgeslagen cellen, gewijzigde getypeerde literalwaarden, gewijzigde formulietekst en toegevoegde of verwijderde samengevoegde bereiken

Literaalvergelijking onderscheidt getallen, tekst, Booleans, datums, fouten en lege cellen: het getal 1 verschilt van de tekst '1', een Boolean verschilt van zijn tekstspelling, datums behouden hun eigen type, en fouten worden vergeleken op hun opgeslagen foutcode; numerieke opslagsorten met gelijke waarden vergelijken gelijk, terwijl verschillende Int64-waarden bij exacte vergelijking verschillend blijven

Options heeft type TlxCompareOptions, een verzameling van TlxCompareOption; het inschakelen van een optie voegt zijn verschillen toe aan de standaardvergelijking

SetFeatureLimits(MaxBytes, MaxItems) valideert beide positieve limieten vóór het wijzigen van een van beide instellingen; MaxFeatureBytes staat standaard op 64 MiB en MaxFeatureItems op 1.000.000, en de individuele setters behouden dezelfde atomische validatie

Featurebudgetten dekken de geaggregeerde losse canonieke bytes en getelde entries uit beide werkmappen, inclusief rich-textruns, XML-knooppunten van filters, Pivot-velden, domeinleden en recordwaarden, en slicer- of timeline-verbindingen; readers controleren aantallen en grote tekstinvoer vóór het bouwen van native XML, dwingen begrensde uitvoerstromen af en geven EXLSXSemanticBudget wanneer een limiet wordt overschreden

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) valideert beide argumenten vóór het wijzigen van een van beide instellingen; beide moeten eindig en niet-negatief zijn, en de individuele setters AbsoluteTolerance en RelativeTolerance gebruiken dezelfde validatie

Numerieke literaalwaarden en numerieke cachewaarden vergelijken gelijk wanneer hun absolute verschil hooguit AbsoluteTolerance is, of wanneer hun verschil ten opzichte van de grotere absolute waarde hooguit RelativeTolerance is; een drempel van nul behoudt exacte gelijkheid, de relatieve berekening voorkomt overflow bij extreme tegengestelde waarden, en tolerantie coerceert geen tekst en past niet toe op datums, stijlen of geometrie

LeftName en RightName zetten optionele weergavenamen die door Report-regels worden gebruikt, met standaard left en right; de namen raken alleen de rapportage, niet de bladkoppeling of de vergelijking

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 geeft het aantal verschillen terug, Count leest dat aantal daarna, en Diff(Index) gebruikt nulgebaseerde indexering om een door de comparer beheerde TlxCompareDiff terug te geven; houd de comparer vast tijdens het lezen van zijn entries en verkrijg de entries opnieuw na een andere geslaagde vergelijking

Elke entry biedt Kind, Sheet, 1-based Row en Col waar van toepassing, Ref, LeftText, RightText en getypeerde LeftKind- / RightKind-waarden; TlxCompareValueKind bevat lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvError en lcvFormula, waarbij lcvNone wordt gebruikt voor een afwezige kant of een niet-waarde-verschil

TlxCompareKind behoudt lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAdded en lckMergeRemoved, en voegt lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChanged en lckColumnGeometryChanged toe

Stijlverschillen dragen stabiele canonieke stijlvingertypen in LeftText en RightText; geometrieverschillen dragen de vergeleken grootte, verborgen-, outline- en samengevouwde status, met Ref die het betrokken aaneengesloten asinterval identificeert, Row gezet op zijn eerste rij en Col op nul voor rijen, of Col gezet op zijn eerste kolom en Row op nul voor kolommen

Featureverschillen gebruiken lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChanged of lckTimelineChanged; Change is lccChanged, lccAdded of lccRemoved, en elke aanwezige kant draagt zijn canonieke definitievingerprint terwijl een afwezige kant een lege string draagt

lckRichTextChanged identificeert een gewijzigde rundefinitie op zijn celcoördinaat en draagt canonieke runvingertypen in LeftText en RightText; numerieke tolerantie geldt voor celliterals en formulecaches, terwijl getypeerde featuredefinities exact worden vergeleken

Featureverwijzingen identificeren scoped namen of tabelnamen, of gebruiken 1-based sequentieposities voor validatie-, voorwaardelijke-opmaak- en tekeningdefinities; het invoegen of verplaatsen van een geordende feature kan meerdere posities wijzigen, terwijl naamentries op werkmapniveau een lege Sheet hebben

lckBlankStyleRegionChanged identificeert een gewijzigde lege rechthoek via Row, Col, inclusieve LastRow en LastCol en zijn A1-Ref; opgeslagen coördinaten worden afgehandeld door gewone celvergelijking en lcoCellStyles, dus schakel beide stijlopties in om opgeslagen cellen en lege gebieden samen te inspecteren

Describe formatteert één entry, terwijl Report(List) de geformatteerde entries toevoegt aan een door de aanroeper beheerde TStrings; een getypeerde waardewijziging bevat typelabels wanneer de typen verschillen, en resultaten sorteren op bladnaam, rij, kolom, verschilsoort en verwijzing in plaats van op celinvoegvolgorde

Vergelijking houdt leesleases vast, loopt over opgeslagen cellen via losse cursorsnapshots en behoudt gepakte opslag; geometrie partitioneert grenzen van opgeslagen metadata en compacte herhaalde-rij-spans, terwijl vergelijking van lege-stijlen actieve rechthoek- en opgeslagen celgrenzen doorzoekt zonder een rechthoekig raster van een miljoen rijen te scannen; het werk groeit met opgeslagen features, regiointersecties en gerapporteerde verschillen

Een mislukte vergelijking behoudt het vorige geslaagde resultaat; ongeldige tolerantietoewijzing behoudt ook de bestaande instellingen en het resultaat, terwijl het doorgeven van een nil-werkmap het resultaat wist en nul teruggeeft

Deze vergelijking dekt de opgeslagen celinhoud van de XLSX-facade en geselecteerde getypeerde featuredefinities; spelling van naam-, validatie-, voorwaardelijke-opmaak-, tabel- en grafiekformules normaliseert via de semantische formulieparser, terwijl Pivot-berekende formules hun opgeslagen definitietekst behouden

Tabelfilters accepteren ondersteunde custom-, waarde lijst-, datumgroep-, kleur-, icoon-, dynamische- en top-count-vormen plus sorteercondities; onafhankelijke filterkolommen en waardeset-entries normaliseren hun volgorde, Booleaanse standaarden en numerieke spellingsvormen normaliseren, en sorteerconditievolgorde blijft significant

Getypeerde Pivot-, slicer- en timelinevergelijking herleidt ondersteunde lokale werkbladbronnen en niet-OLAP-bindingen zonder te verversen of beschikbaarheid te evalueren; native slicer-beschikbaarheidshints zijn afgeleide weergavemetadata, terwijl ledenselecties en herkende native sorteer-metadata worden vergeleken

Ondoorzichtige native tekeningeigenschappen, onvolledige binaire Pivot-modellen, externe of OLAP-Pivot-bronnen, rauwe PivotTable-supplementrecords en extensie-XML, onbekende filter-XML en niet-gemodeleerde slicer- of timeline-extensieattributen of -kinderen geven EXLSSemanticSnapshot; behoud van dergelijke gegevens impliceert geen semantische gelijkheid

Geselecteerde geïmporteerde PivotTable- en PivotCache-features valideren behouden native XML ook vóór het vergelijken van de getypeerde projectie, inclusief geneste veldmetadata en cacherecords; onbekende namespaces, attributen, kinderen en extensiepayloads falen expliciet binnen dezelfde coöperatieve featurelimieten, terwijl gemodelleerde slicercache-bindingen ondersteund blijven

TSimpleDomNode.RawName legt de oorspronkelijke element-QName bloot naast de door de reader genormaliseerde Name, zodat namespacegevoelige inspectie mogelijk is zonder de bestaande naammatching van de parser te wijzigen

Werkmapinstellingen en ondoorzichtige pakketmetadata blijven buiten de vergelijking; basisstijlvergelijking evalueert geen uitstraling van voorwaardelijke opmaak of tabelstijlen, en tekeningvergelijking behoudt de ondersteunde afbeeldings-, tekstvak-, grafiek- en geordende-groepsgrenzen van de semantische momentopname

Effectieve rich-text-eigenschappen

TMsoFbtOpt.StoredPids geeft opgeslagen OfficeArt-propertyidentificatoren terug in gesorteerde volgorde, terwijl TMsoFbtSp.PersistentFlags native shapevlaggen blootlegt zonder properties of ankers toe te wijzen

TMsoShapeContainer.HasPreservedObjectData identificeert bewaarde OBJ-staartbytes; HasOrdinaryEmbeddedPictureObjectData controleert dat afbeeldingsstaarten alleen herkende clipboardformat- en nul-afbeeldingsvlagrecords bevatten, en wijst gekoppelde of onbekende records af zonder de payload te kopiëren

TMSOShapeTextBox.HasValidTextRuns controleert opgeslagen TXO-rungrenzen en gereserveerde velden zonder runs te maken; TMsoDrawing.HasUnmodeledAppearance identificeert native tekeninggegevens die de getypeerde parser overslaat, zodat capture onopgeloste uitstraling expliciet kan afwijzen

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSet en ColorSet onderscheiden overgeërfde fonteigenschappen van expliciete overrides, inclusief false-vlaggen, none, baseline en automatische kleuren; setters markeren de eigenschap als expliciet, ook wanneer zijn waarde gelijk is aan de initiële standaard van de nieuwe run

TXLSXRichText.HasUnsupportedAppearance meldt native rich-eigenschappen die het getypeerde runmodel niet kan representeren; draagbare capture en effectieve rich-text-vergelijking wijzen dergelijke runs expliciet af, terwijl ondersteunde shared/inline run-eigenschappen en witruimte hun geïmporteerde semantiek behouden

Effectieve rich-text-vergelijking past expliciete false-overrides toe vóór het samenvoegen van aangrenzende gelijke runs; overgeërfde en expliciet gewiste eigenschappen blijven onderscheiden tijdens deduplicatie van shared strings en ondersteunde XML-roundtrips

TXMLReader.ResolveNamespaceUri(Prefix, Uri) herleidt de huidige in-scope namespacebinding zonder de lezerpositie te wijzigen en geeft false terug wanneer er geen binding bestaat; een leeg prefix vraagt de standaardnamespace, en rauwe QNames blijven beschikbaar voor namespacegevoelige inspectie

De onveranderlijke rich/scene-records, de capture-source-extensie en het HXRSNP02-overdrachtcontract worden beschreven in Draagbare headless uitvoer

Losse stijl- en asinspectie

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) geeft een losse TXLSSemanticCellStyle terug voor geldige 1-based coördinaten, met herleiding van opgeslagen en gepakte stijlen, werkbladstandaarden, toepasselijke stijloverlays, impliciete datumnotaties, geïndexeerde kleuren en themakleuren zonder cellen te materialiseren of stijlpools te wijzigen; de publieke aanroep verkrijgt een leeslease en sluit regels voor voorwaardelijke opmaak en tabelstijlen uit

TXLSXWorksheet.GetStoredAxisSpans(IsRow) geeft TXLSXAxisSpans terug, een array van TXLSXAxisSpan-records met inclusieve 1-based FirstIndex en LastIndex; hij rapporteert de metadata-voetafdruk van grootte, verborgen, outline en samengevouwen, behoudt compacte herhaalde-rij-hoogtespans en laat de effectieve standaard van het werkblad beschikbaar via zijn gewone eigenschappen

De teruggegeven spans beschrijven opgeslagen metadata-voetafdrukken in plaats van een disjuncte genormaliseerde partitie; toepassingen die twee assen vergelijken kunnen hun eerste en laatste grenzen combineren en daarna de effectieve status één keer per resulterend interval inspecteren

TXLSXWorksheet.GetStoredStyleRegions geeft losse TXLSXStyleRegions terug met inclusieve FirstRow-, FirstCol-, LastRow- en LastCol-grenzen voor compacte virtuele opmaakvoetafdrukken; deze voetafdrukken kunnen overlappen, en aanroepers lezen hun effectieve uitstraling met ReadSemanticCellStyle

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) geeft losse TXLSXSemanticFeatures-entries terug met een stabiele Key, canonieke Definition-bytes en getelde ItemCount; optionele positieve limieten staan standaard op 64 MiB en 1.000.000 entries

TXLSXSemanticFeatureKind bevat xlsxSemanticDefinedNames, xlsxSemanticDataValidations, xlsxSemanticConditionalFormats, xlsxSemanticTables, xlsxSemanticDrawings, xlsxSemanticPivotTables, xlsxSemanticPivotCaches, xlsxSemanticSlicers, xlsxSemanticSlicerCaches, xlsxSemanticTimelines en xlsxSemanticTimelineCaches

Gedefinieerde namen en de drie cachersoorten gebruiken werkmapbrede scope en staan een nil-werkblad toe; de andere soorten vereisen een werkblad dat bij de werkmap hoort, regels en tekeningen behouden hun opgeslagen volgorde, en teruggegeven arrays en buffers zijn kopieën in beheer van de aanroeper; deze readers verkrijgen leesleases en erven de getypeerde dekking en het expliciete gedrag voor niet-ondersteunde gegevens zoals hierboven beschreven

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) geeft losse canonieke runbytes terug voor 1-based coördinaten, of een lege buffer wanneer er geen rich text bestaat en IncludePlainText false is; de optionele ConsumedItems: PInteger ontvangt het aantal vastgelegde runs, en platte tekstcapture behoudt gepakte opslag

TXLSPivotCacheField.GroupItemTypes[Index] legt de getypeerde soort bloot die hoort bij GroupItemLabels[Index] en wijst een index buiten het opgeslagen gegroepeerde-labeldomein af

Formulemetadata en Pivot-query-callbacks

TXLSGetCellFormulaText en TXLSCalculator.OnGetCellFormulaText lezen opgeslagen expressietekst met een 1-based SheetIndex en nulgebaseerde Row/Col, geven lxOk of een getypeerde foutcode terug en respecteren formuleverborgen-bescherming; TXLSGetPivotTable en OnGetPivotTable lokaliseren een geleende tabel met 1-based SheetIndex en nulgebaseerde bereikcoördinaten

De werkmap-engines koppelen deze optionele callbacks aan in normale, alleen-lezen en geïsoleerde berekeningscontexten; callbacks herberekenen geen doelen, verversen geen Pivot-bronnen en dragen geen eigendom over

TXLSPivotDataConstraint slaat een FieldName en getypeerde Item op, met TXLSPivotDataConstraints die veld-/itemparen verzamelt; TXLSPivotTable.GetDataValue bevraagt één zichtbaar ondersteund aggregaat uit een losse lokale tabel-/cache-snapshot en IntersectsQueryRange gebruikt 1-based werkbladen grenzen inclusief gemodelleerde rapportfiltercellen

TlxPivotQueryBudget ontvangt werk- en geheugenschattingen synchroon en geeft terug of evaluatie kan doorgaan; EXLSPivotQueryBudget en EXLSPivotQueryUnsupported onderscheiden uitgeputte limieten van niet-ondersteunde cache- of aggregaatomodellen

TXLSPivotCache.QueryModelIsComplete registreert de gereedheid van gedecodeerde query's los van de volledigheid van rauwe BIFF-replay; QueryRecordsValid legt de geldigheid van geïmporteerde records bloot en SetQueryRecordValidity past de precedentie van de formatreader toe zonder records te verversen

Expliciete codepagina-bytes

Geef de teruggegeven RawByteString rechtstreeks door aan AddRawString of een bytegeoriënteerde streamoperatie; het converteren naar een standaard AnsiString kan zijn bytes op native FPC-systemen hercoderen

Classic gedefinieerde namen en matrixformuleblokken

Classic font-, formaat- en stijlpools

Helpers voor pakket- en binaire opslag

Toevoegingen voor tekeningen en werkmapviewer

Paginering, beelduitvoer en afdrukken

Klassieke grafiekmodellen en grafiekobjecten op werkbladen

Getypeerd grafiek-decodemodel

De gedecodeerde grafiekstatus wordt als gewone records en enums blootgelegd, zodat inspectiecode nooit door ruwe BIFF-records hoeft te lopen: TXLSChartInfo draagt de gedecodeerde grafieksamenvatting met TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), elke serie meldt een TXLSChartSeriesType, en TXLSChart3DState samen met TXLSChart3DInfo beschrijven driedimensionale weergaven. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) en TXLSChartLegendPosition classificeren assen en legenda's, terwijl het datumasmodel TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) en TXLSChartDateValuesgebruikt. TXLSCustomChart legt het gedecodeerde model via TXLSChartInfobloot; trendlijn- en foutbalkannotaties zijn getypeerde objecten (TXLSChartTrendline, TXLSChartErrorBars) die vanaf elke serie bereikbaar zijn

Grafiek-authoringrecords

Authoring van grafiekbladen en via de bouwer accepteert gewone records in plaats van objectgrafen: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfoen TXLSChartSeriesStyleInfo vullen de serie-items die naar TXLSWorksheets.AddChartSheet en de gedeelde grafiekbouwer gaan, en TXLSPivotChartInfo beschrijft de pivot-chart-framing die wordt gebruikt wanneer een grafiek aan een draaitabel wordt gekoppeld

Inspectie van classic grafiekvullingen

TXLSCustomChart.GetChartModel decodeert ondersteunde native OfficeArt-propertytabellen en tertiaire propertytabellen in GelFrame-records, inclusief eigenschappen die volgen op complexe payloadentries; de bestaande bouwerrepresentatie blijft ondersteund, en misvormde tabelgrenzen laten de eerdere getypeerde vulling ongewijzigd en melden het niet-ondersteunde record

Grafiekinspectie valideert de volledige opgeslagen tekst- en annotatiepayload vóór het toevoegen van getypeerde status: afgekapte trendlinenamen of scheidingstekens van datalabels melden hun record-ID via _UnsupportedSemanticRecordID, terwijl nil of te kleine SeriesText-headers dat record als niet-ondersteund melden voor zowel BIFF5 als BIFF8; een gedeclareerde series-text-omvang die zijn payload overschrijdt geeft EReadError, geeft het partieele model vrij en laat de opgeslagen grafiekrecords ongewijzigd

De marker-getter en de vullinginspectie behouden rauwe grafiekopslag; het pad voor vastgelegde uitstraling-capture valideert apart ondersteunde core-grafieken, terwijl ongeverifieerde checksums van uitgebreide titel- of shape-extensies niet-ondersteund blijven

Begrensde readers voor opgeslagen grafieken, strings en fonts

TXLSChartStoredBytes is een losse byte-array en TXLSChartStoredRecord bevat RecordId en Data; deze readers inspecteren bewaarde bronopslag zonder een gedecodeerd grafiekmodel te maken of formules te evalueren

Onderhoud van de shared string-tabel en SST-emissie

TXLSStringTable in lxStringTable ondersteunt de shared strings van de classic-werkmap; de leden hieronder dekken registratie aan de lezerskant, slotonderhoud en rauwe SST-emissie voor roundtrip-saves

PDF-bijlagen, handtekeningen en HTML-export

Berekeningsaudit en werkmapbesturing

Compatibiliteit van verouderde PivotCache-framing

StreamId wordt geschreven als het SXStreamID -record ([MS-XLS] §2.4.303) en herhaald als het veld SXDB in de idstm -header, dat eraan gelijk moet zijn; SourceDataType wordt geschreven als het SXVS -record ([MS-XLS] §2.4.317: $0001 werkblad, $0002 extern, $0004 consolidatie, $0010 scenario) en herhaald als het veld SXDB in de vsType -header, dat eraan gelijk moet zijn. Caches die uit een werkbladbereik zijn opgebouwd beginnen bij het werkbladtype, terwijl caches die uit een bestand worden teruggelezen de waarde houden die hun substream droeg, zodat de BIFF-writer nooit een SXDB -veld achterlaat dat naar een record verwijst dat hij niet heeft uitgeschreven; RawHasStorageStream markeert een cache die uit zijn eigen opslagstream is geladen en waarvan de werkmapglobale descriptor aan de gecachte records voorafgaat

Klembordintegratie en plakopties

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;
      

Bepalen van de celweergavetekst

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;
      

Klassieke gegevensvalidatieobjecten

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 }
      

Geïndexeerde kleuren scannen en oplossen

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);
      

Helpers voor A1-verwijzingen

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;
      

Zie ook

• Extra klassieke XLS-API-leden
• Geavanceerde XLSX-API-leden
• Sparse-outlinegeometrie
• Formuletracering en -controle
• Werkmapviewer