Ytterligare biblioteks-API-medlemmar

Denna sida kompletterar referensen för offentliga typer som stöder de primära API:erna för arbetsbok, kalkylblad, rendering, import, diagnostik och visare men som inte kräver en egen uppgiftsorienterad guide

Filtrering och villkorsstyrd formatering

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpecoch TXLSDxfStyle accepterar AttachWriteGuardOwner, som knyter regelobjektet till dess ägande arbetsbok så att redigeringar automatiskt förvärvar ett skrivskyddslås; ägaren implementerar TXLSCondFormatWriteGuardOwner, vars enda metod AcquireWriteGuard räcker över arbetsbokens skrivskyddslås till regeln. TXLSDxfStyle lägger till FontColorIndex med FontColorIsIndexed plus paren FillFgColorIndex / FillFgColorIsIndexed och FillBgColorIndex / FillBgColorIsIndexed för regelfärger med palettindex, samt åsidosättningar av differentiellt typsnitt via FontName, FontSizeoch FontScheme (tom sträng, en storlek i punkter eller en tematypsnittsplats som major / minor) vid sidan av de befintliga medlemmarna för fet, kursiv, understrykning och färg; varje tilldelning förvärvar skrivskyddslåset och markerar regeln som dirty för ny utmatning

TXLSConnections, TXLSDataTablesoch TXLSQueryTables exponerar OnAcquireWriteGuard (typ TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuardrespektive TXLSQueryTableAcquireWriteGuard), kroken som deras redigeringsvägar använder för att hämta ägararbetsbokens IXLSWorkbookWriteGuard före mutation och för att avancera arbetsbokens generation efteråt; låset registrerar StartGeneration, och Complete markerar skrivningen som färdig så att beroende cachar kan byggas om

Bevarade dataanslutningar bär på en typad beskrivning: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) klassificerar anslutningen, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) registrerar dess autentiseringsläge, och varje anslutningsparametervärde taggas med TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). What-if-datatabeller rapporterar sin lagrade definitionstyp via TXLSDataTableKind

What-if-datatabeller och pivotgruppering

Ikontrösklar kan renderas eller valideras programmatiskt: XLSCfIconSetCount rapporterar hur många ikoner en TXLSIconSetType definierar, och XLSBuildCfIconGeometry fyller en TXLSCfIconGeometry med primitiverna (TXLSCfIconPrimitive, av typen TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) och punkterna (TXLSCfIconPoint) som ritar en ikon, så att egna renderare matchar Excels inbyggda ikonformer

Diagnostik, formelspårning och validering

Importvalideringsscheman

TXLSImportCheck från lxImportCheck validerar en TXLSXWorksheet mot programägda regler; den granskar lagrade skalärvärden och lagrade formelresultat, med ettbaserade kalkylbladskoordinater och ingen implicit konvertering från text till tal, text till datum eller text till booleskt

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 startar kontrollen på nästa rad och har företräde framför FirstRow; annars är standardvärdet för FirstRow 1; LastRow = 0 använder kalkylbladets senast använda rad, medan en positiv LastRow kan inkludera frånvarande celler utan att skapa dem; kolumner måste ligga inom 1–16 384 och aktiva dataradsgränser inom 1–1 048 576

Kolumnregler och explicita typer

AddRule(Column) ersätter och frigör eventuell tidigare regel för kolumnen; predikaten för värdetyp, område, längd och mönster hoppar över saknade värden, null och tomma strängar, medan irRequired rapporterar dem; uniciteten behåller de distinkta policyer som beskrivs nedan; icke-tomt blanksteg räknas fortfarande som ett värde; ett tal kvalificerar inte som booleskt, ett datum kvalificerar inte som ett vanligt tal, och en talaktig sträng förblir text

Tilldelning av MinimumValue eller MaximumValue aktiverar den gränsen; HasMinimum eller HasMaximum kan stänga av den igen; båda inklusivitetsomkopplarna har True som standard; gränser måste vara ändliga typade tal eller datum, och två gränser måste vara jämförbara och beskriva ett icke-tomt intervall; omvända, saknade, inkompatibla eller tomma gränser utlöser fel innan kalkylbladsvalideringen börjar

Talgränser jämför numeriska värden och datumgränser jämför datum; heltals-till-heltals-jämförelser bevarar alla Int64- och UInt64-bitar; värden av en inkompatibel kategori klarar inte områdeskontrollen; predikaten för textlängd och reguljära uttryck fortsätter granska skalärens textrepresentation, och regex-kontrollerna behåller det befintliga IsMatch-beteendet, så använd förankringar som ^...$ när hela texten måste matcha; ett ogiltigt reguljärt uttryck stänger av sin mönsterkontroll för kompatibilitet

Datumformaterade Excel-värden

En cell som importerats från Excel kan innehålla ett numeriskt serienummer även när dess talformat visar ett datum; välj ett serienummerläge explicit när det är det accepterade importschemat; läget påverkar bara valideringen och ändrar aldrig det lagrade cellvärdet

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 är deklarerad i Variants och EncodeDate i SysUtils; numeriska serienummer måste vara icke-negativa och lösas upp före den 1 januari 10 000; fraktionerade serienummer behåller sin tid på dygnet; 1900-systemet avvisar alla serienummer från 60 inklusive till 61 exklusivt eftersom det intervallet betecknar den fiktiva skottdagen; 1904-systemet mappar serienummer noll till den 1 januari 1904

Datumgränser inkluderar tid på dygnet, så ett maximum satt till midnatt den 31 december exkluderar senare tidpunkter den dagen; använd en exklusiv övre gräns vid den 1 januari följande år när hela den sista dagen måste accepteras; textuella datum som 10/08/2026 förblir text oavsett konfigurerat serienummerläge

Sammansatt unicitet och kolumnöverskridande jämförelser

Sammansatta nycklar behåller varje medlems exakta Variant-typ och textidentitet; Integer(1), Double(1), strängen '1', en boolesk och ett datum är distinkta medlemmar; det finns ingen skiftlägesvikning, Unicode-normalisering, locale-parsning eller avgränsartvetydighet; kombinationer som ('ab', 'c') och ('a', 'bc') förblir olika; varje valideringsomgång startar ett friskt tupelindex

När SkipIncompleteRows = True utesluter ett saknat, null- eller tomsträngsmedlem den raden från tupeluniciteten; att sätta det till False inkluderar dessa medlemmar med sina ursprungliga Variant-identiteter; en dubblett rapporterar den första tupelkolumnen som sin celladress och den första matchande raden via FirstDuplicateRow

Det befintliga kolumnvisa irUnique behåller sitt textbaserade, skiftlägesokänsliga matchningsbeteende och hoppar över saknade eller null-värden; använd AddUniqueRule([Column]) när strikt typad identitet krävs för en kolumn

Kolumnöverskridande jämförelser tvingar aldrig strängar till tal, tal till booleska eller vanliga tal till datum; blanda inkompatibla kategorier misslyckas även för icNotEqual; strängjämförelser skiljer sammansatt och uppdelad Unicode, bevarar inbäddade nulltecken och använder kortare-prefix-först-ordning; när SkipBlankValues = False ger någon av de tomma operanderna en kolumnöverskridande överträdelse

Strukturerade resultat och korrigeringsarbetsböcker

Check(Sheet) returnerar antalet överträdelser, och ViolationCount plus nollbaserad Violation(Index) räknar upp rapporten; en kolumnregel rapporterar sitt första underkända predikat, medan oberoende konfigurerade tupel- och jämförelseregler kan lägga till ytterligare överträdelser för samma cell; tilldela meningsfulla Name-värden när anropare behöver stabila regelidentifierare

Formelceller valideras med sina lagrade cachade värden; en formel utan lagrat cachat resultat rapporterar ivFormulaCacheMissing, och ett felresultat rapporterar ivCellError; räkna om explicit före kontrollen när färska formelresultat krävs; valideringen kommer inte åt externa källor, ändrar inte formeldefinitioner eller utvärderar icke-cachade formler

OnVerifyCell behåller signaturen för återanropet TlxImportVerifyCell och körs efter genomförda tillämpliga kolumnpredikat och unicitetskontroller; den returnerar en boolesk och kan sätta ett programfelmeddelande; återanrop måste hålla arbetsboken och valideringsschemat oförändrade, och skrivningar till arbetsboken avvisas av läslåset; återanropsundantag propagerar och låset släpps för efterföljande operationer

Check antecknar aldrig, tar inte bort rader och materialiserar inte packade värden; använd Annotate efter kontrollen för att tillämpa röda teckensnitt och lägga till feltext i befintliga kommentarer, eller anropa explicit KeepOnlyViolations för att ta bort icke-överträdande rader och skapa en korrigeringsarbetsbok; dessa metoder ändrar det tillhandahållna kalkylbladet, så anropa dem på den avsedda arbetsboken efter att ha granskat rapporten

Valideringen lånar kalkylbladet och arbetsboken för det synkrona anropet; den övertar inte anroparens objektägande och kräver ingen gränssnittsägd arbetsbok; ett läslås skyddar relevanta lagrade cellogonblicksbilder och åtkomst till lagrad formelcache under hela kontrollen

Sparpolicyer för externa länkar

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Beräkningsgranskning och arbetsbokstips

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;
      

Tabellformler och IME-tillstånd

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

Inspektion och borttagning av Web Add-in-uppgiftsrutor

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

Visningspolicy för arbetsboksobjekt

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;
      

Renderingskalibreringsvärden och ögonblicksbilder

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;
      

Renderingsgeometri och teckenmätning

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, kodgenerering, jämförelse och övervakning

Arbetsboksjämförelse

TXLSXWorkbookCompare i lxCompare jämför två TXLSXWorkbook -instanser utan att räkna om formler eller ändra någon av arbetsböckerna; blad paras ihop efter skiftlägesokänsligt namn, och att enbart ändra bladordningen ger ingen skillnad

Standardvärdet för Options är tomt och båda toleranserna är noll som standard; standardjämförelsen rapporterar tillagda eller borttagna blad, tillagda eller borttagna lagrade celler, ändrade typade literala värden, ändrad formeltext samt tillagda eller borttagna sammanslagna områden

Literaljämförelsen skiljer tal, text, booleska värden, datum, fel och tomma celler: talet 1 skiljer sig från texten '1', en boolesk skiljer sig från sin textsättning, datum behåller sin egen typ, och fel jämförs via sin lagrade felkod; numeriska lagringstyper med lika värden jämförs lika, medan distinkta Int64-värden förblir distinkta vid exakt jämförelse

Options har typen TlxCompareOptions, en mängd av TlxCompareOption; att aktivera ett alternativ lägger till dess skillnader i standardjämförelsen

SetFeatureLimits(MaxBytes, MaxItems) validerar båda positiva gränserna innan någon inställning ändras; MaxFeatureBytes är 64 MiB som standard och MaxFeatureItems 1 000 000, och de individuella sättarna behåller samma atomära validering

Funktionsbudgetar täcker aggregerade fristående kanoniska byte och räknade poster från båda arbetsböckerna, inklusive rik-text-runs, filter-XML-noder, pivotfält, domänmedlemmar och postvärden samt slicer- eller tidslinjeanslutningar; läsarna kontrollerar antal och stora textindata innan inbyggd XML byggs, tvingar fram avgränsade utdataströmmar och utlöser EXLSXSemanticBudget när en gräns överskrids

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) validerar båda argumenten innan någon inställning ändras; båda måste vara ändliga och icke-negativa, och de individuella sättarna för AbsoluteTolerance och RelativeTolerance använder samma validering

Numeriska literala värden och numeriska cachevärden jämförs lika när deras absoluta skillnad är högst AbsoluteTolerance eller när deras skillnad i förhållande till det större absoluta värdet är högst RelativeTolerance; en tröskel på noll behåller exakt likhet, den relativa beräkningen undviker överlopp för extrema motsatta värden, och toleransen tvingar inte text och tillämpas inte på datum, stilar eller geometri

LeftName och RightName sätter valfria visningsnamn som används av Report -rader, med left och right som standard; namnen påverkar bara rapporteringen, inte bladparning eller jämförelse

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 returnerar skillnadsantalet, Count läser det antalet efteråt, och Diff(Index) använder nollbaserad indexering för att returnera en jämförelseägd TlxCompareDiff; behåll jämförelseobjektet medan du läser dess poster, och hämta posterna på nytt efter en ny lyckad jämförelse

Varje post tillhandahåller Kind, Sheet, ettbaserade Row och Col där tillämpligt, Ref, LeftText, RightText samt typade LeftKind / RightKind -värden; TlxCompareValueKind innehåller lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvErroroch lcvFormula, där lcvNone används för en frånvarande sida eller en icke-värde-skillnad

TlxCompareKind behåller lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAddedoch lckMergeRemoved, och lägger till lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChangedoch lckColumnGeometryChanged

Stilskillnader bär stabila kanoniska stilfingeravtryck i LeftText och RightText; geometriskillnader bär den jämförda storleken samt dold-, dispositions- och komprimerat tillstånd, med Ref som identifierar det berörda sammanhängande axelintervallet, Row satt till dess första rad och Col till noll för rader, eller Col satt till dess första kolumn och Row till noll för kolumner

Funktionsskillnader använder lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChangedeller lckTimelineChanged; Change är lccChanged, lccAdded eller lccRemoved, och varje närvarande sida bär sitt kanoniska definitionsfingeravtryck medan en frånvarande sida bär en tom sträng

lckRichTextChanged identifierar en ändrad runddefinition vid sin cellkoordinat och bär kanoniska runfingeravtryck i LeftText och RightText; numerisk tolerans gäller cellliteraler och formelcache:er, medan typade funktionsdefinitioner jämförs exakt

Funktionsreferenser identifierar omfångsberoende namn eller tabellnamn, eller använder ettbaserade sekvenspositioner för validerings-, villkorsformat- och ritningsdefinitioner; att infoga eller flytta en ordnad funktion kan ändra flera positioner, medan arbetsboksnivå-namnposter har ett tomt Sheet

lckBlankStyleRegionChanged identifierar en ändrad tom rektangel via Row, Col, inkluderande LastRow och LastCol samt dess A1-Ref; lagrade koordinater hanteras av den vanliga celljämförelsen och lcoCellStyles, så aktivera båda stilalternativen för att granska lagrade celler och tomma områden tillsammans

Describe formaterar en post, medan Report(List) lägger till de formaterade posterna i en anroparägd TStrings; en typad värdeändring inkluderar typetiketter när typerna skiljer sig, och resultaten sorteras efter bladnamn, rad, kolumn, skillnadstyp och referens snarare än cellinsättningsordning

Jämförelsen håller läslån, går igenom lagrade celler via fristående cursor-ögonblicksbilder och behåller packad lagring; geometrin partitionerar lagrade metadatagränser och kompakta spann av upprepade rader, medan jämförelse av tomma stilar sveper över aktiva rektangel- och lagrade-cell-gränser utan att skanna ett rektangulärt miljonradsrutnät; arbetet växer med lagrade funktioner, regionsnitt och rapporterade skillnader

En misslyckad jämförelse bevarar det tidigare lyckade resultatet; ogiltig toleranstilldelning bevarar också de befintliga inställningarna och resultatet, medan en nil-arbetsbok rensar resultatet och returnerar noll

Denna jämförelse täcker XLSX-fasadens lagrade cellinnehåll och utvalda typade funktionsdefinitioner; namn-, validerings-, villkorsformat-, tabell- och diagramformelsättning normaliseras genom den semantiska formelparsaren, medan pivotberäknade formler behåller sin lagrade definitionstext

Tabellfilter accepterar stödda former för anpassade, värdelista-, datumgrupp-, färg-, ikon-, dynamiska och top-antal-filter samt sorteringsvillkor; oberoende filterkolumner och värdeuppsättningsposter normaliserar sin ordning, booleska standardvärden och numeriska textsättningar normaliseras, och sorteringsvillkorens ordning förblir betydelsefull

Typad pivot-, slicer- och tidslinjejämförelse löser stödda lokala kalkylbladskällor och icke-OLAP-bindningar utan att uppdatera eller utvärdera tillgänglighet; inbyggda slicer-tillgänglighetstips är härledda visningsmetadata, medan medlemsselektioner och igenkänd inbyggd sorteringsmetadata jämförs

Opaka inbyggda ritningsegenskaper, ofullständiga binära pivotmodeller, externa eller OLAP-pivotkällor, råa pivottabell-supplementposter och tilläggs-XML, okänd filter-XML samt omodellerade slicer- eller tidslinje-tilläggsattribut eller underordnade utlöser EXLSSemanticSnapshot; bevarande av sådan data innebär inte semantisk likvärdighet

Utvalda importerade pivottabell- och pivotcachefunktioner validerar också bevarad inbyggd XML innan den typade projektionen jämförs, inklusive nästlad fältmetadata och cacheposter; okända namnrymder, attribut, underordnade och tilläggsnyttolaster misslyckas explicit inom samma samverkande funktionsgränser, medan modellerade slicercache-bindningar förblir stödda

TSimpleDomNode.RawName exponerar elementets ursprungliga QName bredvid den läsarnormaliserade Name, vilket tillåter namnrymdskänslig granskning utan att ändra befintlig parsarnamnsmatchning

Arbetsboksinställningar och opak paketmetadata ligger utanför jämförelsen; basstiljämförelsen utvärderar inte utseendet på villkorsstyrd formatering eller tabellstilar, och ritningsjämförelsen bevarar den semantiska ögonblicksbildens gränser för stödda bilder, textrutor, diagram och ordnade grupper

Effektiva egenskaper för rik text

TMsoFbtOpt.StoredPids returnerar lagrade OfficeArt-egenskapsidentifierare i sorterad ordning, medan TMsoFbtSp.PersistentFlags exponerar inbyggda shape-flaggor utan att allokera egenskaper eller ankare

TMsoShapeContainer.HasPreservedObjectData identifierar kvarhållna OBJ-svansbyte; HasOrdinaryEmbeddedPictureObjectData kontrollerar att bildsvansar bara innehåller igenkända urklippsformat- och nollbildsflaggposter, och avvisar länkade eller okända poster utan att kopiera nyttolasten

TMSOShapeTextBox.HasValidTextRuns kontrollerar lagrade TXO-rungränser och reserverade fält utan att skapa runs; TMsoDrawing.HasUnmodeledAppearance identifierar inbyggd ritningsdata som den typade parsaren hoppar över, så att fångst explicit kan avvisa ouppklarad utseendedata

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSet och ColorSet skiljer ärvda fontegenskaper från explicita åsidosättningar, inklusive falska flaggor, none, baslinje- och automatiska färger; sättarna markerar egenskapen som explicit även när dess värde motsvarar den nya runens initiala standard

TXLSXRichText.HasUnsupportedAppearance rapporterar inbyggda rika egenskaper som den typade runmodellen inte kan representera; portabel fångst och effektiv rik-text-jämförelse avvisar sådana runs explicit, medan stödda delade/inline-runegenskaper och blanksteg behåller sin importerade semantik

Effektiv rik-text-jämförelse tillämpar explicita falska åsidosättningar innan intilliggande lika runs slås samman; ärvda och explicit rensade egenskaper förblir distinkta under deduplicering av delade strängar och stödda XML-roundtrips

TXMLReader.ResolveNamespaceUri(Prefix, Uri) löser den aktuella namnrymdsbindningen i omfånget utan att ändra läsarens position, och returnerar false när ingen bindning finns; ett tomt prefix begär standardnamnrymden, och råa QNames förblir tillgängliga för namnrymdskänslig granskning

De oföränderliga rich-/scenposterna, fångstkällans utökning och HXRSNP02 -överföringskontraktet beskrivs i Portabel headless-utmatning

Fristående stil- och axelinspektion

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) returnerar en fristående TXLSSemanticCellStyle för giltiga ettbaserade koordinater, och löser lagrade och packade stilar, kalkylbladsstandarder, tillämpliga stilöverlägg, implicita datumformat, indexerade färger och temafärger utan att materialisera celler eller ändra stilpooler; det publika anropet förvärvar ett läslås och utesluter regler för villkorsstyrd formatering och tabellstilar

TXLSXWorksheet.GetStoredAxisSpans(IsRow) returnerar TXLSXAxisSpans, en matris av TXLSXAxisSpan -poster med inkluderande ettbaserade FirstIndex och LastIndex; den rapporterar metadataavtryck för storlek, dold, dispositions- och komprimerat tillstånd, bevarar kompakta spann för upprepade radhöjder och lämnar kalkylbladets effektiva standard tillgänglig via sina vanliga egenskaper

De returnerade spannen beskriver lagrade metadataavtryck snarare än en disjunkt normaliserad partition; applikationer som jämför två axlar kan kombinera deras första- och sista-gränser och därefter granska det effektiva tillståndet en gång per resulterande intervall

TXLSXWorksheet.GetStoredStyleRegions returnerar fristående TXLSXStyleRegions som innehåller inkluderande FirstRow, FirstCol, LastRowoch LastCol -gränser för kompakta virtuella formateringsavtryck; dessa avtryck kan överlappa, och anropare läser sitt effektiva utseende med ReadSemanticCellStyle

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) returnerar fristående TXLSXSemanticFeatures -poster med en stabil Key, kanoniska Definition -byte och räknat ItemCount; valfria positiva gränser har 64 MiB och 1 000 000 poster som standard

TXLSXSemanticFeatureKind innehåller xlsxSemanticDefinedNames, xlsxSemanticDataValidations, xlsxSemanticConditionalFormats, xlsxSemanticTables, xlsxSemanticDrawings, xlsxSemanticPivotTables, xlsxSemanticPivotCaches, xlsxSemanticSlicers, xlsxSemanticSlicerCaches, xlsxSemanticTimelinesoch xlsxSemanticTimelineCaches

Definierade namn och de tre cache-varianterna använder arbetsboksvid omfång och tillåter ett nil-blad; de andra varianterna kräver ett kalkylblad som tillhör arbetsboken, regler och ritningar behåller sin lagrade sekvens, och returnerade matriser och buffertar är anroparägda kopior; dessa läsare förvärvar läslån och ärver den typade täckningen och det explicita beteendet för ostödd data som beskrivs ovan

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) returnerar fristående kanoniska runbyte för ettbaserade koordinater, eller en tom buffert när ingen rik text finns och IncludePlainText är false; valfri ConsumedItems: PInteger tar emot antalet fångade runs, och fångst av vanlig text behåller packad lagring

TXLSPivotCacheField.GroupItemTypes[Index] exponerar den typade sorten som motsvarar GroupItemLabels[Index] och avvisar ett index utanför den lagrade domänen av grupperade etiketter

Formelmetadata och återanrop för pivotfrågor

TXLSGetCellFormulaText och TXLSCalculator.OnGetCellFormulaText läser lagrad uttryckstext med ettbaserat SheetIndex och nollbaserad rad/kolumn, returnerar lxOk eller en typad felkod och respekterar formeldolt-skydd; TXLSGetPivotTable och OnGetPivotTable lokaliserar en lånad tabell med ettbaserat SheetIndex och nollbaserade områdeskoordinater

Arbetsboksmotorerna kopplar dessa valfria återanrop i normala, skrivskyddade och isolerade beräkningskontexter; återanropen räknar inte om mål, uppdaterar inte pivotkällor eller överför ägarskap

TXLSPivotDataConstraint lagrar en FieldName och typat Item, med TXLSPivotDataConstraints som samlar fält-/objektpar; TXLSPivotTable.GetDataValue frågar ett synligt stödt aggregat från en fristående lokal tabell-/cache-ögonblicksbild, och IntersectsQueryRange använder ettbaserade kalkylbladsgränser inklusive modellerade rapportfilterceller

TlxPivotQueryBudget tar emot arbets- och minnesuppskattningar synkront och returnerar huruvida utvärderingen kan fortsätta; EXLSPivotQueryBudget och EXLSPivotQueryUnsupported skiljer uttömda gränser från cache- eller aggregatmodeller som inte stöds

TXLSPivotCache.QueryModelIsComplete registrerar uppklarad frågeberedskap oberoende av BIFF-råreplay-kompletthet; QueryRecordsValid exponerar importerad postvaliditet, och SetQueryRecordValidity tillämpar formatläsares prioritet utan att uppdatera poster

Explicita kodsid-byte

Skicka den returnerade RawByteString direkt till AddRawString eller en byteorienterad strömoperation; att konvertera den till en standard-AnsiString kan koda om dess byte på inbyggda FPC-system

Klassiska definierade namn och matrisformelblock

Klassiska font-, format- och stilpooler

Hjälpmedel för paket- och binärlagring

Tillägg för ritning och arbetsboksvisare

Paginering, bildutdata och utskrift

Klassiska diagrammodeller och kalkylbladsdiagramobjekt

Typad diagramavkodningsmodell

Det avkodade diagramtillståndet exponeras som enkla poster och enum så att inspektionskod aldrig behöver gå igenom råa BIFF-poster: TXLSChartInfo bär den avkodade diagramsammanfattningen med TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), varje serie rapporterar TXLSChartSeriesType, och TXLSChart3DState tillsammans med TXLSChart3DInfo beskriver tredimensionella vyer. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) och TXLSChartLegendPosition klassificerar axlar och legends, medan datumaxelmodellen använder TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) och TXLSChartDateValues. TXLSCustomChart exponerar den avkodade modellen via TXLSChartInfo; trendlinje- och error bar-anteckningar är typade objekt (TXLSChartTrendline, TXLSChartErrorBars) som nås från varje serie

Poster för diagramskapande

Vid skapande via diagramblad och byggare accepteras enkla poster i stället för objektgrafer: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfooch TXLSChartSeriesStyleInfo fyller serieposterna som skickas till TXLSWorksheets.AddChartSheet och den gemensamma diagrambyggaren, och TXLSPivotChartInfo beskriver pivotediagram-inkapslingen som används när ett diagram kopplas till en pivottabell

Inspektion av klassisk diagramfyllnad

TXLSCustomChart.GetChartModel avkodar stödda inbyggda OfficeArt-egenskapstabeller och tertiära egenskapstabeller i GelFrame -poster, inklusive egenskaper som följer komplexa nyttolastposter; den befintliga byggardrepresentationen förblir stödd, och felformade tabellgränser lämnar den tidigare typade fyllnaden oförändrad och rapporterar posten som ostödd

Diagraminspektionen validerar hela den lagrade text- och anteckningsnyttolasten innan typat tillstånd läggs till: trunkerade trendlinjenamn eller dataetikettseparatorer rapporterar sitt post-ID via _UnsupportedSemanticRecordID, medan nil- eller undersized SeriesText -huvuden rapporterar posten som ostödd för både BIFF5 och BIFF8; en deklarerad serietext-utsträckning som överstiger nyttolasten utlöser EReadError, frigör den partiella modellen och lämnar de lagrade diagramposterna oförändrade

Markörgettern och fyllnadsinspektionen bevarar rå diagramlagring; den deklarerade utseendefångst-vägen validerar separat de kärndiagram som stöds, medan overifierade checksummor för rik-titel- eller shape-tillägg förblir ostödda

Avgränsade läsare för lagrat diagram, strängar och typsnitt

TXLSChartStoredBytes är en fristående bytematris och TXLSChartStoredRecord innehåller RecordId och Data; dessa läsare granskar kvarhållen källagring utan att skapa en avkodad diagrammodell eller utvärdera formler

Underhåll av delad strängtabell och SST-utmatning

TXLSStringTable i lxStringTable bär den klassiska arbetsbokens delade strängar; medlemmarna nedan täcker läsarsideregistrering, slot-underhåll och rå SST-utmatning för roundtrip-sparningar

PDF-bilagor, signaturer och HTML-export

Beräkningsgranskning och arbetsbokskontroller

Kompatibilitet med äldre PivotCache-struktur

StreamId skrivs som posten SXStreamID ([MS-XLS] §2.4.303) och upprepas som SXDB -huvudets fält idstm , som måste vara detsamma; SourceDataType skrivs som posten SXVS ([MS-XLS] §2.4.317: $0001 kalkylblad, $0002 extern, $0004 konsolidering, $0010 scenario) och upprepas som SXDB -huvudets fält vsType , som måste vara detsamma. Cachar byggda från ett kalkylbladsområde börjar vid kalkylbladstypen, medan cachar som lästs tillbaka från en fil behåller det värde deras underström bar, så att BIFF-skrivaren aldrig lämnar ett SXDB -fält som namnger en post den inte skrev; RawHasStorageStream markerar en cache som lästs från sin egen lagringsström och vars arbetsboksglobala beskrivare föregår de cachade posterna

Urklippsintegrering och klistringsalternativ

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;
      

Upplösning av cellvisningstext

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;
      

Klassiska datavalideringsobjekt

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 }
      

Skanning och upplösning av indexerade färger

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

Hjälpfunktioner för A1-referenser

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;
      

Se även

• Ytterligare klassiska XLS-API-medlemmar
• Avancerade XLSX-API-medlemmar
• Gles dispositionsgeometri
• Formelspårning och granskning
• Arbetsboksvisare