Membri API aggiuntivi della libreria

Questa pagina completa il riferimento dei tipi pubblici che supportano le API principali per workbook, foglio di lavoro, rendering, importazione, diagnostica e visualizzatore ma non richiedono una guida dedicata separata

Filtro e formattazione condizionale

TXLSCfValue, TXLSDataBarSpec, TXLSColorScaleSpec, TXLSIconSetSpece TXLSDxfStyle accettano AttachWriteGuardOwner, collegando l'oggetto regola al workbook proprietario così che le modifiche acquisiscano automaticamente un write guard; il proprietario implementa TXLSCondFormatWriteGuardOwner, il cui unico metodo AcquireWriteGuard consegna alla regola il write guard del workbook. TXLSDxfStyle aggiunge FontColorIndex con FontColorIsIndexed più le coppie FillFgColorIndex / FillFgColorIsIndexed e FillBgColorIndex / FillBgColorIsIndexed per i colori delle regole per indice di tavolozza, e gli override del font differenziale FontName, FontSizee FontScheme (stringa vuota, una dimensione in punti o uno slot di font del tema come major / minor) accanto ai membri esistenti bold, italic, underline e color; ogni assegnazione acquisisce il write guard e marca la regola come dirty per la ri-emissione

TXLSConnections, TXLSDataTablese TXLSQueryTables espongono OnAcquireWriteGuard (di tipo TXLSConnectionAcquireWriteGuard, TXLSDataTableAcquireWriteGuarde TXLSQueryTableAcquireWriteGuard), l'hook che i loro percorsi di modifica usano per ottenere il IXLSWorkbookWriteGuard del workbook proprietario prima di apportare modifiche e per far avanzare la generazione del workbook in seguito; il write guard registra StartGeneratione Complete contrassegna la scrittura come completata così che le cache dipendenti possano essere ricostruite

Le connessioni dati preservate portano una descrizione tipizzata: TXLSConnectionKind (xlckUnknown, xlckOdbc, xlckDao, xlckFile, xlckWeb, xlckOleDb, xlckText, xlckAdo) classifica la connessione, TXLSConnectionCredentials (xlccIntegrated, xlccNone, xlccStored, xlccPrompt) ne registra la modalità di autenticazione, e ogni valore di parametro della connessione è contrassegnato con TXLSConnectionParameterValueKind (xlcpvNone, xlcpvBoolean, xlcpvDouble, xlcpvInteger, xlcpvString, xlcpvCell). Le tabelle dati what-if riportano il tipo di definizione memorizzata tramite TXLSDataTableKind

Tabelle dati what-if e raggruppamento pivot

Le soglie degli insiemi di icone possono essere disegnate o validate via codice: XLSCfIconSetCount riporta quanti simboli definisce un TXLSIconSetType , e XLSBuildCfIconGeometry riempie un TXLSCfIconGeometry con le primitive (TXLSCfIconPrimitive, di tipo TXLSCfIconPrimitiveKind: cfipPolygon, cfipEllipse, cfipRect, cfipLine) e i punti (TXLSCfIconPoint) che disegnano un simbolo, così i renderer personalizzati replicano le forme delle icone incorporate di Excel

Diagnostica, tracciamento delle formule e convalida

Schemi di validazione dell'import

TXLSImportCheck da lxImportCheck valida una TXLSXWorksheet contro regole di proprietà dell'applicazione; esamina i valori scalari memorizzati e i risultati delle formule memorizzati, con coordinate del foglio di lavoro a base 1 e nessuna conversione implicita testo-numero, testo-data o testo-booleano

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 fa partire il controllo dalla riga successiva e ha precedenza su FirstRow; altrimenti FirstRow vale 1 per default; LastRow = 0 usa l'ultima riga usata del foglio di lavoro, mentre un LastRow positivo può includere celle assenti senza crearle; le colonne devono stare tra 1 e 16.384 e i limiti attivi delle righe di dati tra 1 e 1.048.576

Regole di colonna e tipi espliciti

AddRule(Column) sostituisce e libera ogni regola precedente per quella colonna; i predicati per valore, range, lunghezza e pattern saltano valori mancanti, null e stringhe vuote, mentre irRequired li segnala; l'unicità conserva le distinte politiche descritte di seguito; gli spazi non vuoti restano un valore; un numero non vale come Booleano, una data non vale come numero ordinario, e una stringa dall'aspetto numerico resta testo

Assegnare MinimumValue o MaximumValue abilita quel limite; HasMinimum o HasMaximum possono disabilitarlo di nuovo; entrambi gli interruttori di inclusività valgono True per default; i limiti devono essere numeri o date tipizzati finiti, e due limiti devono essere confrontabili e descrivere un intervallo non vuoto; limiti invertiti, mancanti, incompatibili o vuoti generano un'eccezione prima che la validazione del foglio di lavoro cominci

I limiti numerici confrontano valori numerici e i limiti di data confrontano date; i confronti intero-intero conservano tutti i bit di Int64 e UInt64; i valori di categoria incompatibile falliscono il controllo di range; i predicati di lunghezza del testo e di regex continuano a esaminare la rappresentazione testuale dello scalare, e i controlli regex conservano il comportamento IsMatch esistente, quindi usa ancoraggi come ^...$ quando deve corrispondere il testo completo; una regex non valida disabilita il controllo del pattern per compatibilità

Valori Excel formattati come data

Una cella importata da Excel può contenere un seriale numerico anche quando il suo formato numerico mostra una data; scegli esplicitamente una modalità seriale quando quello è lo schema di import accettato; la modalità incide solo sulla validazione e non cambia mai il valore memorizzato della cella

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 è dichiarato in Variants e EncodeDate in SysUtils; i serial numerici devono essere non negativi e risolversi prima del 1 gennaio 10000; i serial frazionari conservano la loro ora del giorno; il sistema 1900 rifiuta ogni serial da 60 incluso a 61 escluso perché quell'intervallo denota il fantomatico 29 febbraio; il sistema 1904 mappa il serial zero al 1 gennaio 1904

I limiti di data includono l'ora del giorno, quindi un massimo impostato alla mezzanotte del 31 dicembre esclude le ore successive di quel giorno; usa un limite superiore esclusivo al 1 gennaio dell'anno successivo quando l'intero ultimo giorno deve essere accettato; le date testuali come 10/08/2026 restano testo a prescindere dalla modalità seriale configurata

Unicità composita e confronti tra colonne

Le chiavi composite conservano il tipo Variant esatto e l'identità testuale di ogni membro; Integer(1), Double(1), la stringa '1', un Booleano e una data sono membri distinti; non c'è case folding, normalizzazione Unicode, parsing per locale né ambiguità di delimitatori; combinazioni come ('ab', 'c') e ('a', 'bc') restano diverse; ogni passaggio di validazione riparte da un indice di tupla fresco

Con SkipIncompleteRows = True, un membro mancante, null o stringa vuota esclude quella riga dall'unicità della tupla; impostandolo su False quei membri entrano con le loro identità Variant originali; un duplicato riporta la prima colonna della tupla come indirizzo della cella e la prima riga corrispondente tramite FirstDuplicateRow

Il irUnique esistente a colonna singola conserva il suo comportamento di matching testuale case-insensitive e salta valori mancanti o null; usa AddUniqueRule([Column]) quando serve identità tipizzata rigorosa per una colonna

I confronti tra colonne non coerciscono mai stringhe in numeri, numeri in Booleani o numeri ordinari in date; categorie miste incompatibili falliscono anche per icNotEqual; i confronti di stringhe distinguono Unicode composto e scomposto, conservano i caratteri null incorporati e usano l'ordinamento prefisso-più-corto-prima; con SkipBlankValues = False, uno dei due operandi vuoti produce una violazione cross-column

Risultati strutturati e workbook di correzione

Check(Sheet) restituisce il numero di violazioni, e ViolationCount più Violation(Index) a base zero enumerano il report; una regola di colonna riporta il suo primo predicato fallito, mentre regole di tupla e di confronto configurate indipendentemente possono aggiungere altre violazioni per la stessa cella; assegna valori Name significativi quando i chiamanti necessitano di identificatori di regola applicativi stabili

Le celle formula vengono validate usando i loro valori in cache memorizzati; una formula senza risultato in cache memorizzato riporta ivFormulaCacheMissing, e un risultato di errore riporta ivCellError; ricalcola esplicitamente prima del controllo quando servono risultati freschi delle formule; la validazione non accede a sorgenti esterne, non altera definizioni di formule e non valuta formule senza cache

OnVerifyCell conserva la firma del callback TlxImportVerifyCell e gira dopo i predicati di colonna applicabili riusciti e i controlli di unicità; restituisce un Booleano e può impostare un messaggio di errore applicativo; i callback devono lasciare invariati il workbook e lo schema di validazione, e le scritture sul workbook vengono rifiutate dal lease di lettura; le eccezioni dei callback si propagano e il lease viene rilasciato per le operazioni successive

Check non annota mai, non elimina righe e non materializza valori packed; usa Annotate dopo il controllo per applicare font rossi e accodare il testo di errore ai commenti esistenti, oppure chiama esplicitamente KeepOnlyViolations per rimuovere le righe senza violazioni e creare un workbook di correzione; questi metodi modificano il foglio di lavoro fornito, quindi chiamali sul workbook voluto dopo aver esaminato il report

La validazione prende in prestito il foglio di lavoro e il workbook per la chiamata sincrona; non adotta la proprietà degli oggetti del chiamante né richiede un workbook di proprietà di un'interfaccia; un lease di lettura protegge gli snapshot rilevanti delle celle memorizzate e l'accesso alle cache delle formule memorizzate per tutta la durata del controllo

Criteri di salvataggio dei collegamenti esterni

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

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

Audit del calcolo e hint del workbook

function TXLSWorkbook.RecalcAndVerify(MaxIssues: Integer = 10000): TXLSCalculationAuditReport;
function TXLSXWorkbook.RecalcAndVerify(MaxIssues: Integer = 10000): TXLSCalculationAuditReport;
function TXLSWorkbook.RecalcAndVerifyEx(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSXWorkbook.RecalcAndVerifyEx(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSWorkbook.RunCalculationAudit(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSWorkbook.FormulaIsVolatile(Formula: WideString): Boolean;

function TXLSWorkbook.AuditOverlayHash(SheetIndex, Row, Col: Integer): Integer;
function TXLSWorkbook.AuditOverlayRead(SheetIndex, Row, Col: Integer; var Value: Variant): Boolean;
procedure TXLSWorkbook.AuditOverlayWrite(SheetIndex, Row, Col: Integer; const Value: Variant);
procedure TXLSWorkbook.AuditOverlayClear;

TXLSCalculationAuditIssueKind = (xlcaiCacheMismatch, xlcaiParseFailure,
  xlcaiMissingFunction, xlcaiMissingName, xlcaiUnsupportedArguments,
  xlcaiCircularReference, xlcaiExternalReferenceDenied,
  xlcaiExternalReferenceMissing, xlcaiDataTableSkipped, xlcaiCancelled,
  xlcaiInternalFailure);

TXLSCalculationAuditIssue = record
  Kind: TXLSCalculationAuditIssueKind;
  SheetIndex: Integer;
  SheetName: WideString;
  Row: Integer;
  Col: Integer;
  Formula: WideString;
  Symbol: WideString;
  Expected: Variant;
  Actual: Variant;
  ResultCode: Integer;
  Stack: WideString;
  ExternalTarget: WideString;
end;
TXLSCalculationAuditIssues = array of TXLSCalculationAuditIssue;

TXLSRecalcAuditProgress = procedure(ASender: TObject;
  ACurrent, ATotal: Integer; var ACancel: Boolean) of object;

property WorkbookCodeName: WideString;
property CalculationThreadMode: TXLSCalculationThreadMode;
property ForceFullCalculationState: TXLSOptionalBooleanState;
property RefreshAllOnLoadState: TXLSOptionalBooleanState;
      

Formule delle tabelle e stato IME

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

Ispezione e rimozione dei riquadri attività dei componenti aggiuntivi web

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

Criteri di visualizzazione degli oggetti del workbook

TXLSObjectDisplayMode = (xlsodmShowAll, xlsodmShowPlaceholders,
  xlsodmHideAll);

property IXLSWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSXWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSPaginationModel.ExportObjectPlaceholders: Boolean;
property TXLSPDFExport.ExportObjectPlaceholders: Boolean;
property TXLSSvgExport.ExportObjectPlaceholders: Boolean;
property TXLSPageImageExporter.ExportObjectPlaceholders: Boolean;
property TXLSPrintDocument.ExportObjectPlaceholders: Boolean;
property TXLSXHtmlExportOptions.ExportObjectPlaceholders: Boolean;
      

Valori di calibrazione del rendering e snapshot

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;
      

Geometria di rendering e misurazione dei caratteri

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;
      

Importazione, generazione di codice, confronto e monitoraggio

Confronto dei workbook

TXLSXWorkbookCompare in lxCompare confronta due istanze TXLSXWorkbook senza ricalcolare le formule né modificare nessuno dei due workbook; i fogli sono accoppiati per nome case-insensitive, e cambiare solo l'ordine dei fogli non produce una differenza

Il valore predefinito di Options è vuoto e entrambe le tolleranze valgono zero per default; il confronto predefinito riporta fogli aggiunti o rimossi, celle memorizzate aggiunte o rimosse, valori letterali tipizzati cambiati, testo delle formule cambiato e intervalli uniti aggiunti o rimossi

Il confronto dei letterali distingue numeri, testo, valori Booleani, date, errori e vuoti: il numero 1 differisce dal testo '1', un Booleano differisce dalla sua grafia testuale, le date conservano il proprio tipo, e gli errori si confrontano per il loro codice di errore memorizzato; tipi di archiviazione numerici con valori uguali si confrontano come uguali, mentre valori Int64 distinti restano distinti nel confronto esatto

Options ha tipo TlxCompareOptions, un insieme di TlxCompareOption; abilitare un'opzione aggiunge le sue differenze al confronto predefinito

SetFeatureLimits(MaxBytes, MaxItems) valida entrambi i limiti positivi prima di cambiare una delle due impostazioni; MaxFeatureBytes vale 64 MiB per default e MaxFeatureItems 1.000.000, e i setter individuali conservano la stessa validazione atomica

I budget delle feature coprono i byte canonici scollegati aggregati e le voci contate di entrambi i workbook, inclusi run di rich text, nodi XML di filtri, campi pivot, membri di dominio e valori dei record, e connessioni slicer o timeline; i reader verificano conteggi e input testuali grandi prima di costruire l'XML nativo, impongono stream di output limitati, e generano EXLSXSemanticBudget quando un limite viene superato

SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) valida entrambi gli argomenti prima di cambiare una delle due impostazioni; entrambi devono essere finiti e non negativi, e i setter individuali AbsoluteTolerance e RelativeTolerance usano la stessa validazione

Valori letterali numerici e valori in cache numerici si confrontano come uguali quando la loro differenza assoluta è al più AbsoluteTolerance o la loro differenza relativa al valore assoluto maggiore è al più RelativeTolerance; una soglia di zero conserva l'uguaglianza esatta, il calcolo relativo evita l'overflow per valori opposti estremi, e la tolleranza non coercisce testo e non si applica a date, stili o geometria

LeftName e RightName impostano nomi visualizzati opzionali usati dalle righe di Report, con default left e right; i nomi incidono solo sul reporting, non sull'accoppiamento dei fogli né sul confronto

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 restituisce il conteggio delle differenze, Count legge quel conteggio in seguito, e Diff(Index) usa indicizzazione a base zero per restituire un TlxCompareDiff di proprietà del comparer; conserva il comparer mentre leggi le sue voci, e ri-acquisisci le voci dopo un altro confronto riuscito

Ogni voce fornisce Kind, Sheet, Row e Col a base 1 dove applicabile, Ref, LeftText, RightTexte valori tipizzati LeftKind / RightKind; TlxCompareValueKind contiene lcvNone, lcvBlank, lcvNumber, lcvText, lcvBoolean, lcvDateTime, lcvErrore lcvFormula, con lcvNone usato per un lato assente o una differenza non di valore

TlxCompareKind conserva lckSheetAdded, lckSheetRemoved, lckCellAdded, lckCellRemoved, lckValueChanged, lckFormulaChanged, lckMergeAddede lckMergeRemoved, e aggiunge lckFormulaCacheChanged, lckStyleChanged, lckRowGeometryChangede lckColumnGeometryChanged

Le differenze di stile portano fingerprint di stile canonici stabili in LeftText e RightText; le differenze di geometria portano lo stato confrontato di dimensione, nascosto, outline e collassato, con Ref che identifica l'intervallo contiguo dell'asse interessato, Row impostato alla sua prima riga e Col a zero per le righe, oppure Col impostato alla sua prima colonna e Row a zero per le colonne

Le differenze di feature usano lckDefinedNameChanged, lckDataValidationChanged, lckConditionalFormatChanged, lckTableChanged, lckDrawingChanged, lckPivotTableChanged, lckPivotCacheChanged, lckSlicerChangedo lckTimelineChanged; Change è lccChanged, lccAddedo lccRemoved, e ogni lato presente porta il fingerprint canonico della propria definizione mentre un lato assente porta una stringa vuota

lckRichTextChanged identifica una definizione di run cambiata alla coordinata della sua cella e porta fingerprint canonici dei run in LeftText e RightText; la tolleranza numerica si applica ai letterali delle celle e alle cache delle formule, mentre le definizioni tipizzate delle feature si confrontano esattamente

I riferimenti delle feature identificano nomi con scope o nomi di tabelle, oppure usano posizioni di sequenza a base 1 per definizioni di validazione, formattazione condizionale e disegni; inserire o spostare una feature ordinata può cambiare diverse posizioni, mentre le voci di nomi a livello di workbook hanno una Sheet vuota

lckBlankStyleRegionChanged identifica un rettangolo vuoto cambiato tramite Row, Col, LastRow e LastCol inclusivi e il suo Ref A1; le coordinate memorizzate sono gestite dal confronto ordinario delle celle e da lcoCellStyles, quindi abilita entrambe le opzioni di stile per ispezionare insieme celle memorizzate e aree vuote

Describe formatta una voce, mentre Report(List) accoda le voci formattate a un TStrings di proprietà del chiamante; un cambio di valore tipizzato include le etichette dei tipi quando i tipi differiscono, e i risultati ordinano per nome del foglio, riga, colonna, tipo di differenza e riferimento anziché per ordine di inserimento delle celle

Il confronto trattiene lease di lettura, attraversa le celle memorizzate tramite snapshot di cursori scollegati e conserva l'archiviazione packed; la geometria partiziona i confini dei metadati memorizzati e gli span compatti di righe ripetute, mentre il confronto degli stili vuoti percorre i confini del rettangolo attivo e delle celle memorizzate senza scandire una griglia rettangolare da un milione di righe; il lavoro cresce con le feature memorizzate, le intersezioni di regioni e le differenze riportate

Un confronto fallito conserva il precedente risultato riuscito; un'assegnazione di tolleranza non valida conserva anch'essa impostazioni e risultato esistenti, mentre passare un workbook nil azzera il risultato e restituisce zero

Questo confronto copre il contenuto delle celle memorizzate della facade XLSX e le definizioni tipizzate selezionate delle feature; l'ortografia delle formule di nomi, validazioni, formattazione condizionale, tabelle e grafici si normalizza attraverso il parser semantico delle formule, mentre le formule calcolate pivot conservano il loro testo di definizione memorizzato

I filtri delle tabelle accettano forme supportate di personalizzati, elenchi di valori, gruppi di date, colori, icone, dinamici e top-count e condizioni di ordinamento; le colonne di filtro indipendenti e le voci di insiemi di valori normalizzano il loro ordine, i default Booleani e le grafie numeriche si normalizzano, e l'ordine delle condizioni di ordinamento resta significativo

Il confronto tipizzato di pivot, slicer e timeline risolve sorgenti locali supportate del foglio di lavoro e binding non OLAP senza aggiornare né valutare la disponibilità; gli hint nativi di disponibilità degli slicer sono metadati di visualizzazione derivati, mentre le selezioni dei membri e i metadati nativi di ordinamento riconosciuti vengono confrontati

Proprietà native di disegno opache, modelli pivot binari incompleti, sorgenti pivot esterne o OLAP, record supplementari di PivotTable grezzi e XML di estensioni, XML di filtri sconosciuti, e attributi o figli di estensioni slicer o timeline non modellate generano EXLSSemanticSnapshot; la conservazione di tali dati non implica equivalenza semantica

Le feature importate selezionate di PivotTable e PivotCache validano anche l'XML nativo conservato prima di confrontare la proiezione tipizzata, includendo metadati annidati dei campi e record di cache; namespace, attributi, figli e payload di estensione sconosciuti falliscono esplicitamente negli stessi limiti cooperativi delle feature, mentre i binding di cache slicer modellate restano supportati

TSimpleDomNode.RawName espone il QName originale dell'elemento accanto alla Name normalizzata dal reader, permettendo l'ispezione sensibile ai namespace senza cambiare il matching esistente dei nomi del parser

Le impostazioni del workbook e i metadati opachi del package restano fuori dal confronto; il confronto degli stili base non valuta l'aspetto della formattazione condizionale o degli stili di tabella, e il confronto dei disegni conserva i confini supportati di immagini, caselle di testo, grafici e gruppi ordinati dello snapshot semantico

Proprietà rich-text effettive

TMsoFbtOpt.StoredPids restituisce gli identificatori di proprietà OfficeArt memorizzati in ordine ordinato, mentre TMsoFbtSp.PersistentFlags espone i flag nativi delle forme senza allocare proprietà o ancore

TMsoShapeContainer.HasPreservedObjectData identifica i byte finali OBJ trattenuti; HasOrdinaryEmbeddedPictureObjectData verifica che le code delle immagini contengano solo record riconosciuti di formato-clipboard e flag-immagine zero, e rifiuta record collegati o sconosciuti senza copiare il payload

TMSOShapeTextBox.HasValidTextRuns verifica i confini dei run TXO memorizzati e i campi riservati senza creare run; TMsoDrawing.HasUnmodeledAppearance identifica dati di disegno nativi saltati dal parser tipizzato, permettendo alla cattura di rifiutare esplicitamente un aspetto irrisolto

TXLSXRichTextRun.BoldSet, ItalicSet, StrikethroughSet, UnderlineSet, VertAlignSete ColorSet distinguono le proprietà del font ereditate dagli override espliciti, inclusi flag false, none, baseline e colori automatici; i setter marcano la proprietà come esplicita anche quando il suo valore coincide con il default iniziale del nuovo run

TXLSXRichText.HasUnsupportedAppearance riporta le proprietà rich native che il modello tipizzato dei run non può rappresentare; la cattura portabile e il confronto effective rich-text rifiutano esplicitamente tali run, mentre le proprietà di run condivise/inline supportate e gli spazi conservano la loro semantica importata

Il confronto effective rich-text applica gli override false espliciti prima di fondere run adiacenti uguali; le proprietà ereditate e quelle cancellate esplicitamente restano distinte durante la deduplicazione delle stringhe condivise e i roundtrip XML supportati

TXMLReader.ResolveNamespaceUri(Prefix, Uri) risolve il binding di namespace corrente in scope senza cambiare la posizione del reader, restituendo false quando non esiste alcun binding; un prefisso vuoto richiede il namespace predefinito, e i QName grezzi restano disponibili per l'ispezione sensibile ai namespace

I record immutabili rich/scene, l'estensione della sorgente di cattura e il contratto di trasferimento HXRSNP02 sono descritti in Output headless portabile

Ispezione staccata di stili e assi

TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) restituisce uno TXLSSemanticCellStyle staccato per coordinate valide a base 1, risolvendo stili memorizzati e packed, predefiniti del foglio di lavoro, overlay di stile applicabili, formati data impliciti, colori indicizzati e colori tema senza materializzare celle né cambiare i pool di stili; la chiamata pubblica acquisisce un lease di lettura ed esclude regole di formattazione condizionale e di stile tabella

TXLSXWorksheet.GetStoredAxisSpans(IsRow) restituisce TXLSXAxisSpans, un array di record TXLSXAxisSpan con FirstIndex e LastIndex inclusivi a base 1; riporta le impronte di metadati di dimensione, nascosto, outline e collassato, conserva gli span compatti di altezze di righe ripetute, e lascia il predefinito effettivo del foglio di lavoro disponibile attraverso le sue proprietà ordinarie

Gli span restituiti descrivono impronte di metadati memorizzati anziché una partizione normalizzata disjointa; le applicazioni che confrontano due assi possono combinare i loro confini iniziali e finali, poi esaminare lo stato effettivo una volta per l'intervallo risultante

TXLSXWorksheet.GetStoredStyleRegions restituisce TXLSXStyleRegions staccati contenenti i confini inclusivi FirstRow, FirstCol, LastRowe LastCol per le impronte di formattazione virtuale compatte; queste impronte possono sovrapporsi, e i chiamanti leggono il loro aspetto effettivo con ReadSemanticCellStyle

TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) restituisce voci TXLSXSemanticFeatures staccate con una Key stabile, byte canonici di Definition e ItemCount contato; i limiti positivi opzionali valgono 64 MiB e 1.000.000 voci per default

TXLSXSemanticFeatureKind contiene xlsxSemanticDefinedNames, xlsxSemanticDataValidations, xlsxSemanticConditionalFormats, xlsxSemanticTables, xlsxSemanticDrawings, xlsxSemanticPivotTables, xlsxSemanticPivotCaches, xlsxSemanticSlicers, xlsxSemanticSlicerCaches, xlsxSemanticTimelinese xlsxSemanticTimelineCaches

Nomi definiti e i tre tipi di cache usano scope a livello di workbook e ammettono un foglio nil; gli altri tipi richiedono un foglio di lavoro appartenente al workbook, regole e disegni conservano la loro sequenza memorizzata, e gli array e i buffer restituiti sono copie di proprietà del chiamante; questi reader acquisiscono lease di lettura ed ereditano la copertura tipizzata e il comportamento esplicito per dati non supportati descritti sopra

TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) restituisce byte canonici di run staccati per coordinate a base 1, oppure un buffer vuoto quando non esiste rich text e IncludePlainText è false; il ConsumedItems: PInteger opzionale riceve il conteggio dei run catturati, e la cattura in plain text conserva l'archiviazione packed

TXLSPivotCacheField.GroupItemTypes[Index] espone il tipo corrispondente a GroupItemLabels[Index] e rifiuta un indice fuori dal dominio delle etichette raggruppate memorizzate

Metadati delle formule e callback di query pivot

TXLSGetCellFormulaText e TXLSCalculator.OnGetCellFormulaText leggono il testo delle espressioni memorizzate usando una SheetIndex a base 1 e Row/Col a base zero, restituendo lxOk o un codice di errore tipizzato e rispettando la protezione formula-hidden; TXLSGetPivotTable e OnGetPivotTable individuano una tabella presa in prestito usando una SheetIndex a base 1 e coordinate di range a base zero

I motori del workbook collegano questi callback opzionali nei contesti di calcolo normale, read-only e isolato; i callback non ricalcolano i target, non aggiornano le sorgenti pivot e non trasferiscono proprietà

TXLSPivotDataConstraint memorizza una FieldName e un Item tipizzato, con TXLSPivotDataConstraints che raccoglie coppie campo/elemento; TXLSPivotTable.GetDataValue interroga un aggregato supportato visibile da uno snapshot scollegato di tabella/cache e IntersectsQueryRange usa limiti del foglio a base 1 incluse le celle dei filtri report modellate

TlxPivotQueryBudget riceve stime di lavoro e memoria in modo sincrono e restituisce se la valutazione può continuare; EXLSPivotQueryBudget e EXLSPivotQueryUnsupported distinguono limiti esauriti da modelli di cache o aggregato non supportati

TXLSPivotCache.QueryModelIsComplete registra la prontezza della query decodificata indipendentemente dalla completezza della riproduzione raw BIFF; QueryRecordsValid espone la validità dei record importati e SetQueryRecordValidity applica la precedenza del format-reader senza aggiornare i record

Byte di code page espliciti

Passa direttamente il RawByteString restituito a AddRawString o a un'operazione di stream orientata ai byte; convertirlo in un AnsiString predefinito può ricodificarne i byte sui sistemi FPC nativi

Nomi definiti Classic e blocchi di formule matrici

Pool Classic di font, formati e stili

Helper per pacchetti e archiviazione binaria

Aggiunte per disegni e visualizzatore di workbook

Impaginazione, output di immagini e stampa

Modelli di grafici classici e oggetti grafico del foglio di lavoro

Modello di decodifica tipizzato dei grafici

Lo stato decodificato del grafico è esposto come record ed enum semplici, così il codice di ispezione non deve mai percorrere i record BIFF grezzi: TXLSChartInfo porta il riepilogo decodificato del grafico con TXLSChartTypeFamily (cfBar, cfLine, cfPie, cfArea, cfScatter, cfRadar, cfDoughnut, cfSurface, cfBubble), ogni serie riporta il proprio TXLSChartSeriesType, e TXLSChart3DState più TXLSChart3DInfo descrivono le viste tridimensionali. TXLSChartAxisType (catCategory, catValue, catSeries, catDate) e TXLSChartLegendPosition classificano assi e legende, mentre il modello di asse data usa TXLSChartDateUnit (xcduDays, xcduMonths, xcduYears) e TXLSChartDateValues. TXLSCustomChart espone il modello decodificato tramite TXLSChartInfo; le annotazioni di linea di tendenza e barre di errore sono oggetti tipizzati (TXLSChartTrendline, TXLSChartErrorBars) raggiungibili da ogni serie

Record di creazione dei grafici

La creazione di fogli grafico e del builder accetta record semplici invece di grafi di oggetti: TXLSChartTrendlineInfo, TXLSChartErrorBarsInfo, TXLSChartDataLabelsInfoe TXLSChartSeriesStyleInfo riempiono le voci di serie passate a TXLSWorksheets.AddChartSheet e al builder condiviso dei grafici, e TXLSPivotChartInfo descrive l'incorniciatura del PivotChart usata quando un grafico è collegato a una tabella pivot

Ispezione dei riempimenti dei grafici Classic

TXLSCustomChart.GetChartModel decodifica le tabelle di proprietà OfficeArt native supportate e le tabelle di proprietà tertiary nei record GelFrame, incluse le proprietà che seguono voci di payload complesse; la rappresentazione del builder esistente resta supportata, e limiti di tabelle malformati lasciano invariato il riempimento tipizzato precedente e riportano il record non supportato

L'ispezione dei grafici valida l'intero payload memorizzato di testo e annotazioni prima di aggiungere lo stato tipizzato: nomi di trendline troncati o separatori di etichette dati riportano il proprio ID di record tramite _UnsupportedSemanticRecordID, mentre intestazioni SeriesText nil o undersized riportano quel record come non supportato sia per BIFF5 sia per BIFF8; un'estensione di series-text dichiarata che supera il proprio payload genera EReadError, libera il modello parziale e lascia invariati i record del grafico memorizzati

Il getter dei marker e l'ispezione dei riempimenti conservano lo storage grezzo dei grafici; il percorso di cattura dell'aspetto dichiarato valida separatamente i grafici core supportati, mentre checksum di estensioni rich di titoli o forme non verificati restano non supportati

Reader limitati di grafici, stringhe e font memorizzati

TXLSChartStoredBytes è un array di byte staccato e TXLSChartStoredRecord contiene RecordId e Data; questi reader esaminano lo storage sorgente trattenuto senza creare un modello di grafico decodificato né valutare formule

Manutenzione della tabella delle stringhe condivise ed emissione SST

TXLSStringTable in lxStringTable supporta le stringhe condivise del workbook classico; i membri seguenti coprono la registrazione lato reader, la manutenzione degli slot e l'emissione raw dell'SST per i salvataggi round-trip

Allegati PDF, firme ed esportazione HTML

Audit del calcolo e controlli del workbook

Compatibilità del framing legacy del PivotCache

StreamId viene scritto come record SXStreamID ([MS-XLS] §2.4.303) e ripetuto come campo SXDB dell'intestazione idstm , che deve coincidere; SourceDataType viene scritto come record SXVS ([MS-XLS] §2.4.317: $0001 foglio di lavoro, $0002 esterno, $0004 consolidamento, $0010 scenario) e ripetuto come campo SXDB dell'intestazione vsType , che deve coincidere. Le cache costruite da un intervallo del foglio di lavoro partono dal tipo foglio di lavoro, mentre le cache rilette da un file conservano il valore che il loro substream portava, così il writer BIFF non lascia mai in un campo SXDB il nome di un record che non ha emesso; RawHasStorageStream contrassegna una cache caricata dal proprio stream di archiviazione il cui descrittore globale del workbook precede i record in cache

Integrazione con gli appunti e opzioni di incolla

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;
      

Risoluzione del testo visualizzato della cella

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;
      

Oggetti di convalida dati classici

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 }
      

Scansione e risoluzione dei colori indicizzati

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

Helper per i riferimenti A1

function XLSA1CellRef(ARow, ACol: Integer): WideString;
function XLSTryParseA1CellRef(const ARef: WideString;
  out ARow, ACol: Integer): Boolean;
function XLSTryParseA1RangeRef(const ARef: WideString;
  out ARow1, ACol1, ARow2, ACol2: Integer): Boolean;
      

Vedere anche

• Membri API aggiuntivi XLS classici
• Membri avanzati dell'API XLSX
• Geometria di struttura sparsa
• Tracciamento e auditing delle formule
• Visualizzatore di workbook