.xlsx). Dichiarato in
lxHandleX. Contiene una raccolta TXLSXSheets
e fornisce i punti di ingresso SaveAs / Open per cartelle di lavoro OOXML, importazione
CSV / TSV e flussi di lettura/scrittura OpenDocument Spreadsheet
(.ods)
type
TXLSXFileFormat = (xlsxOpenXMLWorkbook, xlsxOpenDocumentSpreadsheet,
xlsxOpenXMLTemplate, xlsxOpenXMLMacroEnabledTemplate, xlsxExcelBinaryWorkbook);
TODSExportOptions = class
constructor Create;
property Generator: WideString;
property IncludeCharts: Boolean;
property IncludeImages: Boolean;
end;
TXLSXWorkbook = class
constructor Create;
destructor Destroy; override;
function CreateLoadedCellCursor: IXLSLoadedCellCursor; overload;
function CreateLoadedCellCursor(AIncludeStoredBlanks: Boolean): IXLSLoadedCellCursor; overload;
function CreateReadOnlyView: IXLSReadOnlyWorkbookView;
property RenderCalibration: TXLSRenderCalibration;
function CaptureRenderCalibration: TXLSRenderCalibration;
procedure ResetRenderCalibration;
function CreateRenderGeometry(ABackend: TXLSRenderGeometryBackend;
ACacheCapacity: Integer = 4096): IXLSRenderGeometry;
function SaveAs(const FileName: WideString): Integer; overload;
function SaveAs(const FileName: WideString; FileFormat: TXLSXFileFormat): Integer; overload;
function SaveAs(Stream: TStream): Integer; overload;
function SaveAs(Stream: TStream; FileFormat: TXLSXFileFormat): Integer; overload;
function GetConversionReport(ATarget: TXLSConversionTarget): TXLSConversionReport;
function SaveAsChecked(Stream: TStream; FileFormat: TXLSXFileFormat;
AllowLossy: Boolean = False): Integer; overload;
function SaveAsChecked(const FileName: WideString; FileFormat: TXLSXFileFormat;
AllowLossy: Boolean = False): Integer; overload;
function Open(const FileName: WideString): Integer; overload;
function Open(const FileName: WideString; const Password: WideString): Integer; overload;
function Open(Stream: TStream): Integer; overload;
function OpenCSV(const FileName: WideString): Integer; overload;
function OpenCSV(const FileName: WideString; ASeparator: WideChar;
ADetectTypes: Boolean): Integer; overload;
function OpenCSV(Stream: TStream): Integer; overload;
function OpenCSV(Stream: TStream; ASeparator: WideChar;
ADetectTypes: Boolean): Integer; overload;
function OpenODS(const FileName: WideString): Integer; overload;
function OpenODS(Stream: TStream): Integer; overload;
function SaveAsODS(const FileName: WideString): Integer; overload;
function SaveAsODS(Stream: TStream): Integer; overload;
function SaveAsODS(const FileName: WideString; Options: TODSExportOptions): Integer; overload;
function SaveAsODS(Stream: TStream; Options: TODSExportOptions): Integer; overload;
function GetODSSheetNames(const FileName: WideString; AList: TStrings): Integer; overload;
function GetODSSheetNames(Stream: TStream; AList: TStrings): Integer; overload;
function GetSheetNames(const FileName: WideString; AList: TStrings): Integer; overload;
function GetSheetNames(Stream: TStream; AList: TStrings): Integer; overload;
function SaveAsCSV(const FileName: WideString): Integer; overload;
function SaveAsCSV(const FileName: WideString; SheetIndex: Integer; Delimiter: WideChar): Integer; overload;
function SaveAsCSV(Stream: TStream): Integer; overload;
function SaveAsCSV(Stream: TStream; SheetIndex: Integer; Delimiter: WideChar): Integer; overload;
function SaveAsHTML(const FileName: WideString): Integer; overload;
function SaveAsHTML(const FileName: WideString; Options: TXLSXHtmlExportOptions): Integer; overload;
function SaveAsHTML(const FileName: WideString; SheetIndex: Integer): Integer; overload;
function SaveAsHTML(const FileName: WideString; SheetIndex: Integer; Options: TXLSXHtmlExportOptions): Integer; overload;
function SaveAsHTML(Stream: TStream): Integer; overload;
function SaveAsHTML(Stream: TStream; Options: TXLSXHtmlExportOptions): Integer; overload;
function SaveAsHTML(Stream: TStream; SheetIndex: Integer): Integer; overload;
function SaveAsHTML(Stream: TStream; SheetIndex: Integer; Options: TXLSXHtmlExportOptions): Integer; overload;
function SaveAsRTF(const FileName: WideString): Integer; overload;
function SaveAsRTF(const FileName: WideString; SheetIndex: Integer): Integer; overload;
function SaveAsRTF(Stream: TStream): Integer; overload;
function SaveAsRTF(Stream: TStream; SheetIndex: Integer): Integer; overload;
// AES encryption (ECMA-376 Standard Encryption) write path.
// OpenEncrypted still raises for encrypted packages.
function SaveAsEncrypted(const FileName, APassword: WideString): Integer;
function OpenEncrypted(const FileName, APassword: WideString): Integer;
function CanReadEncrypted(const FileName: WideString): Boolean;
function Calculate(const Formula: WideString): Variant;
function CalculateAndVerify: Integer; overload;
function CalculateAndVerify(out AMismatches: TArray<TXLSVerifyMismatch>): Integer; overload;
property OnUserFunction: TXLSUserFunctionEvent;
property OnUserFunctionEx: TXLSUserFunctionExEvent;
property AllowUnsafeFormulaCallbacks: Boolean;
// Document properties (docProps/core.xml + docProps/app.xml).
property Title, Author, Subject, Keywords, Description,
Category, LastModifiedBy, Company,
Application, AppVersion: WideString;
property Created, Modified: TDateTime;
// Workbook protection (16-bit legacy hash).
procedure ProtectWorkbook; overload;
procedure ProtectWorkbook(const APassword: WideString); overload;
procedure ProtectWorkbook(const APassword: WideString; ALockStructure, ALockWindows: Boolean); overload;
procedure UnProtectWorkbook;
property IsWorkbookProtected: Boolean;
property LockStructure, LockWindows: Boolean;
// VBA project payload (round-trips byte-for-byte). Workbook is saved
// with macro-enabled content type when HasVbaProject is True.
procedure LoadVbaProjectFromFile(const AFileName: WideString);
procedure ClearVbaProject;
function HasVbaProject: Boolean;
property VbaProjectDefined: Boolean;
property VbaProject: AnsiString;
property ParsedVBAProject: TXLSVBAProject;
// Unknown package and workbook extension preservation
procedure ClearUnsupportedParts;
function UnsupportedPartCount: Integer;
function UnsupportedPartBytes: Int64;
property PreserveUnsupportedParts: Boolean;
// Chart sheet helper — creates a sheet flagged IsChartSheet and
// seeds Charts[0] with a default full-page anchor.
function AddChartSheet(const AName: WideString;
AChartType: TXLSXChartType; const ATitle: WideString): TXLSXWorksheet;
// Streaming SaveAs path (TXLSWideStringBuilder + one sheet at a time).
property StreamingWrite: Boolean;
// Streaming parallel Open path
property ParallelParse: Boolean;
property ParallelParseThreads: Integer;
// Workbook-level collections.
property ActiveSheet: Integer;
property Minimized: Boolean;
property WindowHidden: Boolean;
property ShowHorizontalScroll: Boolean;
property ShowVerticalScroll: Boolean;
property ShowSheetTabs: Boolean;
property XWindow: Integer;
property YWindow: Integer;
property WindowWidth: Integer;
property WindowHeight: Integer;
property TabRatio: Integer;
property FirstSheet: Integer;
property AutoFilterDateGrouping: Boolean;
property Date1904: Boolean;
// Workbook calculation policy
property Iterate: Boolean;
property IterateCount: Integer;
property IterateDelta: Double;
property CalcId: Integer;
property FullCalcOnLoad: Boolean;
property CalcMode: WideString;
property RefMode: WideString;
property ForceFullCalc: Boolean;
property CalcCompleted: Boolean;
property CalcOnSave: Boolean;
property FullPrecision: Boolean;
property ConcurrentCalc: Boolean;
property ConcurrentManualCount: Integer;
function CreateWorkspaceWorkbook: IXLSWorkspaceWorkbook;
procedure RegisterExternalWorkbook(const AWorkbookName: WideString;
AWorkbook: TXLSXWorkbook);
procedure UnregisterExternalWorkbook(const AWorkbookName: WideString);
property SourceFormat: TXLSXFileFormat;
property IndexedColor[Index: Integer]: LongWord;
function NearestIndexedColor(AArgb: LongWord;
out AMatch: TXLSNearestIndexedColorMatch): Boolean;
function ScanIndexedColorUsage: TXLSIndexedColorUsageArray;
function BuildBiffPalettePlan: TXLSBiffPalettePlan;
function ApplyBiffPalettePlan(
const APlan: TXLSBiffPalettePlan): Boolean;
function HasCustomIndexedColor(Index: Integer): Boolean;
function CustomIndexedColorCount: Integer;
procedure ResetIndexedColors;
property Sheets: TXLSXSheets;
property Fonts: TXLSXFonts;
property Fills: TXLSXFills;
property Borders: TXLSXBorders;
property NumberFormats: TXLSXNumberFormats;
property Alignments: TXLSXAlignments;
property DefinedNames: TXLSXDefinedNames;
property ExternalLinks: TXLSXExternalLinks;
property ExternalWorkspace: TXLSWorkbookWorkspace;
end;
| Sheets | Raccolta di fogli di lavoro. Vedere TXLSXSheets |
| Fonts | Palette dei font a livello di cartella di lavoro. Le celle scelgono un font
impostando TXLSXCell.FontIndex su un indice a partire da 1 in questa
raccolta. Vedere TXLSXFont / TXLSXFonts |
| Fills | Palette dei riempimenti a livello di cartella di lavoro. Le celle scelgono un riempimento
impostando TXLSXCell.FillIndex su un indice a partire da 1 in questa
raccolta. Vedere TXLSXFill / TXLSXFills |
| Borders | Palette dei bordi a livello di cartella di lavoro. Le celle scelgono un bordo
impostando TXLSXCell.BorderIndex su un indice a partire da 1 in
questa raccolta. Vedere TXLSXBorder / TXLSXBorders |
| NumberFormats | Palette dei formati numerici personalizzati a livello di cartella di lavoro. Le celle
scelgono un formato impostando TXLSXCell.NumberFormatIndex su
un indice a partire da 1 in questa raccolta. Vedere
TXLSXNumberFormat / TXLSXNumberFormats |
| DefinedNames | Intervalli denominati a livello di cartella di lavoro (con ambito cartella di lavoro o foglio). Vedere TXLSXDefinedName / TXLSXDefinedNames |
| Calculate | Compila e valuta una stringa formula di Excel sul foglio attivo, accettando anche un = iniziale
Riferimenti a celle, intervalli, formule memorizzate nelle celle referenziate, riferimenti tra fogli, intervalli con nome definiti e le funzioni supportate per testo, data, giorno lavorativo, ingegneria/conversione di base, operazioni bitwise, statistiche, aggregazione e matematica vengono valutati tramite il motore di formule condiviso di HotXLS
Vedere OnUserFunction per gestire funzioni personalizzate o non supportate |
| CreateLoadedCellCursor | Callback usato da xlckBlankquando una
formula chiama una funzione personalizzata o non supportata. Vedere callback OnUserFunction / OnUserFunctionEx |
| CreateReadOnlyView | Legge IXLSXWorkbookOwnere aggiunge
i nomi dei fogli di lavoro a IXLSReadOnlyWorkbookView nell'ordine della cartella di lavoro, senza
caricare l'XML dei fogli. L'overload con stream si aspetta uno stream completo del
package XLSX. Restituisce il numero di nomi letti, oppure SheetCount quando il package non può essere aperto CreateReadOnlyView method |
| SaveSemanticSnapshot, ComputeSemanticHash | Esegue lo streaming di una rappresentazione semantica canonica e versionata della cartella di lavoro oppure calcola il relativo SHA-256 in minuscolo, senza materializzare lo snapshot completo. Vedere semantic snapshot and hash methods |
| RenderCalibration, CaptureRenderCalibration, ResetRenderCalibration | Assegna atomicamente una calibrazione di rendering validata, cattura uno snapshot di valori indipendente per una singola operazione oppure ripristina i valori predefiniti; la configurazione runtime non viene serializzata e di per sé non ridimensiona righe o colonne del foglio. Vedere render calibration values and snapshots |
| CreateRenderGeometry | Crea un servizio di geometria e misurazione dei font di proprietà dell'operazione, con calibrazione immutabile, identità di generazione della cartella di lavoro e del backend, più una cache locale limitata; AutoFit cattura un servizio per operazione e la paginazione uno per build, senza scrivere le dimensioni del foglio. Vedere render geometry and font measurement |
| OnUserFunction, OnUserFunctionEx | Callback used by Calculate quando una
formula chiama una funzione personalizzata o non supportata. Vedere
callback OnUserFunction / OnUserFunctionEx |
| AllowUnsafeFormulaCallbacks | Il valore predefinito è false e impedisce che nomi di funzione esterni o in stile macro pericolosi raggiungano i gestori delle funzioni utente prima della valutazione degli argomenti. Vedere callback safety policy |
| GetSheetNames(FileName, AList), GetSheetNames(Stream, AList) | Reads xl/workbook.xml e aggiunge
i nomi dei fogli a AList in ordine di cartella di lavoro senza
caricare l'XML dei fogli. L'overload con stream attende uno stream del
pacchetto XLSX completo. Restituisce il numero di nomi letti, oppure
-1 when the package cannot be opened |
| Alignments | Palette di allineamento delle celle a livello di cartella di lavoro. Le celle scelgono
una voce impostando TXLSXCell.AlignmentIndex su un
indice a partire da 1 in questa raccolta. Vedere
TXLSXAlignment |
| Document properties | Title, Author, Subject, Keywords, Description,
Category, LastModifiedBy, Company, Application, AppVersion,
Created, Modified. L'impostazione di uno qualsiasi di essi popola
docProps/core.xml + docProps/app.xml durante
SaveAs (altrimenti la cartella di lavoro mantiene l'insieme minimo di parti) |
| ProtectWorkbook / UnProtectWorkbook | Interruttore della protezione della cartella di lavoro, con hash
della password legacy a 16 bit opzionale e flag LockStructure /
LockWindows . Riflesso come
<workbookProtection> in xl/workbook.xml |
| LoadVbaProjectFromFile / VbaProject / HasVbaProject / VbaProjectDefined | LoadVbaProjectFromFile importa un payload non elaborato di vbaProject.bin ; VbaProject espone i byte; HasVbaProject e VbaProjectDefined in sola lettura riportano entrambi se un payload è presente. Salvare con estensione .xlsm quando le macro devono risultare abilitate in Excel |
| ParsedVBAProject | Vista analizzata di sola lettura del payload
vbaProject.bin corrente. Quando il payload è un archivio OLE
VBA valido, restituisce un TXLSVBAProject che espone i nomi dei moduli
e il testo sorgente; altrimenti restituisce nil. Il payload non elaborato di
VbaProject resta i byte autorevoli usati
per il round-trip di SaveAs/Open |
| AddChartSheet(Name, Type, Title) | Crea un foglio di lavoro contrassegnato da
IsChartSheet = True e inizializza Charts[0]
con un ancoraggio predefinito ragionevole a pagina intera. SaveAs scrive questi fogli
in xl/chartsheets/sheetN.xml. Vedere
TXLSXChart |
| ParallelParse | Quando True, SaveAs usa Open per foglio — nessuna cache sheetXmls
viene mantenuta, sharedStrings.xml viene emesso per ultimo dopo che ogni foglio
ha popolato l'SST. In combinazione con |
| ParallelParseThreads | Imposta il numero massimo di stream di fogli analizzati
contemporaneamente durante Open. Zero seleziona il numero
automatico di worker, mentre i valori positivi impostano un limite
esplicito. I working set attivi di inflater e reader XML sono limitati
da questo valore |
| StreamingWrite | When True, SaveAs uses
WriteWorksheetXmlStreaming per foglio — non viene
tenuta alcuna cache sheetXmls, sharedStrings.xml viene emesso per
ultimo dopo che ogni foglio ha popolato la SST. Combinato con il
TXLSWideStringBuilder per riga questo mantiene la memoria
lineare sui fogli di grandi dimensioni. Il valore predefinito è False
(comportamento esistente) |
| PreserveUnsupportedParts / ClearUnsupportedParts | PreserveUnsupportedParts vale
True per impostazione predefinita e conserva le parti del pacchetto
sconosciute raggiungibili via relationship, oltre alle dichiarazioni di
namespace estranee alla radice della cartella di lavoro, agli attributi
di markup-compatibility e agli interi <extLst>
payload a livello di cartella di lavoro durante Open e SaveAs. I riferimenti
relationship dentro il payload di estensione preservato vengono
rimappati quando gli ID generati entrano in conflitto con il sorgente
Impostare la proprietà su False prima di Open, oppure chiamare
ClearUnsupportedParts, to discard this state. The
UnsupportedPartCount and UnsupportedPartBytes
diagnostiche contano le parti del pacchetto preservate e non includono
i metadati XML inline della cartella di lavoro |
| PreserveRawParts | per riga questo mantiene lineare la memoria su fogli di grandi dimensioni. Il valore predefinito è False (comportamento esistente) |
| SaveAsEncrypted / OpenEncrypted / CanReadEncrypted | Supporto di scrittura con la crittografia Standard ECMA-376
SaveAsEncrypted scrive un contenitore OLE Compound File protetto AES-128
conforme allo standard per password non vuote, usando
l'accelerazione AES-NI quando disponibile e un fallback software portabile
altrimenti. L'output crittografato si apre in Excel 2007 e successivi con
la password usata per salvarlo. CanReadEncrypted rileva
i magic bytes OLE2; OpenEncrypted ripiega in modo trasparente
sul normale Open per i file non crittografati e continua a sollevare
EXlsxEncryptionNotImplemented per i package crittografati
finché non arriva il supporto alla decrittazione |
| SaveAs(FileName) | Scrive la cartella di lavoro sul file indicato. Restituisce
1 in caso di successo e un valore negativo in caso di fallimento; se la cartella di lavoro non ha
fogli, viene aggiunto un foglio Sheet1 predefinito prima della scritturaQuesto overload e SaveAs(FileName, FileFormat) mettono in staging l'output prima di sostituire la destinazione
Se la sostituzione fallisce, il valore di ritorno è -1 e LastDiagnostic riporta xlsDiagnosticOutputCommitFailed (1005), il NativeCodeWindows originale e il relativo messaggio di errore di sistema
La vecchia destinazione e il FileName della cartella di lavoro restano invariati; l'output temporaneo viene rilasciato e un salvataggio successivo cancella la diagnostica precedente |
| SaveAs(FileName, FileFormat) | Accetta xlsxOpenXMLWorkbook per l'output OOXML ordinario, xlsxOpenDocumentSpreadsheet per ODS, xlsxOpenXMLTemplate per un template XLTX privo di macro o xlsxOpenXMLMacroEnabledTemplate per un template XLTM, con output bufferizzato e in streaming supportati per tutte le scelte OOXMLL'output dei template scrive application/vnd.openxmlformats-officedocument.spreadsheetml.template.main+xml per /xl/workbook.xml; l'estensione .xltx va usata per i file e application/vnd.openxmlformats-officedocument.spreadsheetml.template quando il package viene servito via HTTPIl formato va selezionato esplicitamente: né l'estensione del file né un template importato cambiano l'output predefinito di SaveAs outputSe è presente un progetto VBA, l'output XLTX restituisce -1 con una diagnostica di formato non supportato prima di scrivere la destinazione; XLTM conserva un progetto VBA esistente e accetta anche una cartella di lavoro senza macroSaveAsODS resta la scorciatoia dedicata per l'output ODS con l'opzionale controllo TODSExportOptions control |
| GetConversionReport / SaveAsChecked | Ispeziona un report di conversione delle funzionalità note, di proprietà del chiamante e senza mutazioni, oppure rifiuta funzionalità degradate e scartate prima della scrittura lasciando AllowLossy=False
Il salvataggio lossy esplicito rifiuta comunque le conversioni non supportate; vedi fedeltà di calcolo e conversione per i confini di target, proprietà, diagnostica e conservazione |
| SaveAs(Stream) / SaveAs(Stream, FileFormat) | Scrive la cartella di lavoro direttamente in qualsiasi TStream, e l'overload con FileFormat accetta xlsxOpenXMLWorkbook, xlsxOpenDocumentSpreadsheet, xlsxOpenXMLTemplateo xlsxOpenXMLMacroEnabledTemplate rispettivamente per cartelle di lavoro OOXML in memoria, fogli di calcolo ODS, template XLTX o template XLTMRestituisce 1 in caso di successo, e i salvataggi su stream rispettano RecalcBeforeSave: la modalità manuale preserva le cache delle formule esistenti, mentre le politiche dirty e always le aggiornano prima della serializzazioneChi chiama conserva la proprietà dello stream; l'annullamento prima dell'inizio della scrittura ne preserva contenuto e posizione, mentre un fallimento dopo l'avvio della serializzazione può lasciare output parziale |
| Open(FileName) | Legge un archivio OOXML .xlsx e sostituisce la
raccolta
Sheets con il suo contenuto. Restituisce 1
in caso di successo |
| Open(FileName, Password) | Riservato al futuro supporto XLSX crittografato. Oggi si comporta
come Open(FileName) — la password viene ignorata |
| Open(Stream) | Legge un archivio OOXML .xlsx da uno
TStream. Restituisce 1 in caso di successo |
| OpenCSV(FileName) / OpenCSV(Stream) | Importa testo CSV o TSV nella cartella di lavoro con
rilevamento automatico del separatore (,, ;,
tab o pipe), rilevamento della codifica UTF-8 / UTF-16 basato su BOM, campi tra virgolette in stile
RFC 4180 e inferenza opzionale del tipo di valore tramite
gli overload ADetectTypes . Una chiamata a
Open(FileName) su .csv o
.tsv viene instradata automaticamente a questo importer. Vedere
metodo OpenCSV |
| OpenODS(FileName) / OpenODS(Stream) | Importa un package OpenDocument Spreadsheet (.ods) da file o stream. Il lettore carica content.xml, le informazioni di stile condivise da styles.xmle le impostazioni di visualizzazione quando presenti, preservando nomi dei fogli, valori scalari, risultati delle formule in cache, conversione di base dei riferimenti alle formule, righe/colonne/celle ripetute, intervalli uniti, rich text, collegamenti ipertestuali, commenti, immagini incorporate, grafici incorporati, righe/colonne/fogli nascosti, altezze delle righe, larghezze delle colonne, stili ereditati/predefiniti, formati numero/data/ora/valuta/scientifico/frazione, stato di protezione di celle e fogli, intervalli denominati, aree di stampa, interruzioni di pagina manuali, riquadri bloccati, intervalli AutoFilter, gruppi struttura di righe/colonne, intestazioni/piè di pagina, convalide dati comprese le richieste, formattazioni condizionali comprese formule/scale di colore/barre di dati, e il colore della scheda del foglio. La semantica completa di OpenFormula, le chiavi di protezione ODS, la geometria dei commenti, la formattazione avanzata dei commenti e le caratteristiche del package esterne al contenuto del foglio di calcolo non vengono convertite |
| SaveAsODS(FileName) / SaveAsODS(Stream), with optional TODSExportOptions | Salva la cartella di lavoro come package OpenDocument Spreadsheet valido. Scrive direttamente mimetype, manifest, metadati, stili e contenuto dei fogli di lavoro ODF, riportando valori tipizzati, formule, stili, rich text, dimensioni, unioni, collegamenti ipertestuali, immagini, grafici, intervalli denominati, intervalli AutoFilter, formattazioni condizionali, convalide dati, riquadri bloccati, impostazioni di pagina, intestazioni/piè di pagina, aree di stampa, interruzioni di pagina manuali, gruppi struttura, colore della scheda e visibilità dei fogli laddove queste caratteristiche sono rappresentate nel modello di cartella di lavoro di HotXLS. Passando le opzioni di esportazione, incluso nil, restano in vigore la normale politica di ricalcolo, l'annullamento dell'avanzamento, la diagnostica e la protezione da scrittura. L'output su file prepara un file sibling e sostituisce la destinazione solo dopo una serializzazione riuscita; fallimento di serializzazione e annullamento prima del commit preservano la destinazione precedente. L'avanzamento della scrittura riporta ogni tabella completata, e ppsEnd è una notifica terminale la cui richiesta di Abort non può annullare un salvataggio già completato. L'output su stream conserva la proprietà al chiamante e il normale comportamento di salvataggio su stream, che può lasciare output parziale dopo che la serializzazione è iniziata |
| TODSExportOptions | Controlla l'esportazione ODS. Generator sovrascrive il valore meta:generator in meta.xml; un valore vuoto usa la stringa di generatore incorporata di HotXLS. IncludeCharts e IncludeImages valgono True per impostazione predefinita e, quando False, rimuovono insieme le cornici di disegno, le parti del package e le voci di manifest corrispondenti, così che l'output non abbia riferimenti orfani a grafici o immagini. L'istanza delle opzioni è di proprietà del chiamante e va liberata |
| GetODSSheetNames(FileName, AList), GetODSSheetNames(Stream, AList) | Legge solo i nomi delle tabelle ODS da content.xml in AList , senza azzerare o popolare la cartella di lavoro. Usarlo quando un selettore di file o un flusso di importazione richiede i nomi dei fogli prima di caricare la cartella di lavoro |
| SaveAsCSV overloads | Quattro overload (FileName o Stream ×
predefinito del foglio attivo / SheetIndex + Delimiter espliciti). Scrive il
foglio scelto come CSV UTF-8 con BOM. I valori data vengono resi come
yyyy-mm-dd hh:nn:ss; le celle con formula vengono calcolate prima
dell'esportazione, e il testo della formula è usato solo quando il calcolo non è disponibile
Restituisce 0 in caso di successo |
| SaveAsHTML overloads | Gli overload con opzioni accettano TXLSXHtmlExportOptions per Title, WriteDocument, IncludeStyles, IncludeBOMe TableClass. Impostare WriteDocument su False per un frammento di tabella; impostare IncludeBOM su False quando l'output viene incorporato in una risposta UTF-8 esistente. L'output esportato ora preserva i collegamenti ipertestuali delle celle come ancore <a> e le immagini ancorate come URI di immagine data: in linea; l'esportazione a livello di cartella di lavoro include ancore fuori dalle celle popolate. I commenti delle celle vengono emessi anche come attributi <td>title con escape, e l'esportazione a livello di cartella di lavoro include ancore di soli commenti. Quando IncludeStyles è abilitato, i valori ColWidth espliciti vengono emessi come larghezze <col> e i valori RowHeight espliciti come stili di altezza <tr> . Le sequenze (run) di rich text delle celle vengono emesse come elementi <span> con escape e stili in linea di font, colore, enfasi e sottolineatura quando IncludeStyles è abilitato. I bordi delle celle vengono emessi come regole CSS border-left, border-right, border-tope border-bottom quando IncludeStyles è abilitato. Le righe e le colonne nascoste marcate da RowHidden / ColHidden, più le colonne a larghezza zero esplicite, vengono saltate nella tabella generata e in <colgroup>. Le impostazioni di allineamento verticale vengono emesse come regole CSS vertical-align quando IncludeStyles è abilitato |
| SaveAsRTF overloads | Quattro overload (FileName o Stream ×
predefinito del foglio attivo / SheetIndex esplicito). Scrive il foglio scelto
come documento RTF 1.6 con una tabella semplice. Le larghezze delle colonne sono derivate
dai dati ColWidth (1 unità carattere ≈ 96 twips;
predefinito 809 twips). Vengono applicati grassetto / corsivo / dimensione font per cella;
i caratteri non ASCII sono codificati come escape unicode RTF \uN?
con segno a 16 bit. Le celle unite non vengono estese su più colonne. Restituisce 0 in
caso di successo |
| ActiveSheet | Indice a partire da 1 del foglio attivo (selezionato) (0 se nessuno), corrispondente a ActiveSheetIndexdel classico motore XLS. SaveAs scrive activeTab="N" su <workbookView> (l'attributo OOXML activeTab in sé resta a base 0) quando occorre emettere le opzioni di visualizzazione della cartella di lavoro, e contrassegna il foglio corrispondente con tabSelected="1" |
| Minimized / WindowHidden / ShowHorizontalScroll / ShowVerticalScroll | Flag di aspetto della finestra della cartella di lavoro scritti in <workbookView>. Minimized scrive minimized="1", WindowHidden scrive visibility="hidden", e ShowHorizontalScroll / ShowVerticalScroll nascondono o mostrano le barre di scorrimento della cartella di lavoro. Open fa il round-trip di tutti e quattro i valori |
| XWindow / YWindow / WindowWidth / WindowHeight | Geometria della finestra della cartella di lavoro scritta in <workbookView>. XWindow e YWindow memorizzano l'origine della finestra, mentre WindowWidth e WindowHeight ne memorizzano le dimensioni. I valori sono limitati a 0..65535 e fanno il round-trip al caricamento |
| ShowSheetTabs / TabRatio / FirstSheet / AutoFilterDateGrouping | Opzioni di visualizzazione della finestra della cartella di lavoro scritte in <workbookView>. ShowSheetTabs nasconde o mostra la barra delle schede dei fogli, TabRatio controlla la ripartizione della larghezza tra barra delle schede e barra di scorrimento e si limita a 0..1000, FirstSheet seleziona la prima scheda visibile come indice del foglio a base 0 e si limita a un foglio esistente, e AutoFilterDateGrouping controlla il raggruppamento delle date di Excel nei menu a discesa di AutoFilter. Open fa il round-trip di tutti e quattro i valori |
| Date1904 | Base delle date della cartella di lavoro. False (predefinito) =
epoca 1900 di Windows; True = epoca 1904 di Mac (sposta ogni
seriale di data di 1462 giorni). Impostarlo prima di assegnare
valori
TDateTime alle celle, così Excel mostra la stessa
data di calendario |
| Iterate / IterateCount / IterateDelta | Riporta la famiglia di package caricata dalla chiamata
IterateCount o
IterateDelta riuscita più recente. Restituisce Iterate per cartelle di lavoro e template OOXML, inclusi gli XLTX, e False |
| CalcMode / RefMode / CalcId | Controlla la modalità di calcolo della cartella di lavoro, lo
stile di riferimento delle formule e l'identità del motore di calcolo
CalcMode accepts auto,
manual, or autoNoTableRefMode accepts A1 or R1C1
con input case-insensitive e output canonico
L'output degli errori moderni rich-value usa un CalcId emesso di almeno
191029 così Excel interpreta gli errori moderni in cache, preservando
i valori richiesti più alti e lasciando invariata la proprietà in memoria |
| FullCalcOnLoad / ForceFullCalc / CalcCompleted / CalcOnSave / FullPrecision | Controlla il ricalcolo completo, il completamento del
calcolo in cache, il ricalcolo prima del salvataggio e la policy di
precisione Ogni valore non predefinito emette e fa transitare
indipendentemente il corrispondente <calcPr> attribute |
| ConcurrentCalc / ConcurrentManualCount | per ODS; una cartella di lavoro appena creata riporta
ConcurrentManualCount finché non viene aperto un file. Questa proprietà non seleziona il formato di output |
| SourceFormat | Riporta la famiglia di package caricata dalla chiamata Open o OpenODS riuscita più recente, restituendo xlsxOpenXMLWorkbook per cartelle di lavoro e template OOXML, inclusi XLTX e XLTM, xlsxOpenDocumentSpreadsheet per ODS, e xlsxExcelBinaryWorkbook per il sottoinsieme valori-e-stili XLSB supportatoUna cartella di lavoro appena creata riporta xlsxOpenXMLWorkbook finché non viene aperto un file, e questa proprietà non seleziona il formato di output |
| IndexedColor[Index] | valore ARGB per lo slot
di palette a colori indicizzati OOXML indicato (0..63). In lettura
restituisce l'override utente se impostato, altrimenti il default
OOXML integrato (XlsxDefaultIndexedPalette)
Writing overrides slot N; SaveAs then emits a full
<indexedColors> block with all 64 slots |
| ResolveIndexedColor | Classifies public color indexes, BIFF icv valori, oppure colori indicizzati OOXML, e risolve un valore ARGB normalizzato quando la palette della cartella di lavoro o un callback esplicito per i colori di sistema ne fornisce uno |
| NearestIndexedColor | Restituisce la voce fisica più vicina della palette tramite il matcher OKLab condiviso e in cache, senza modificare la palette o lo stato della cartella di lavoro |
| ScanIndexedColorUsage | Restituisce un inventario deterministico a 56 slot con i colori della palette, i conteggi di definizione e di riferimento, i tipi di consumer e i lock di preservazione, senza materializzare celle o modificare lo stato della cartella di lavoro |
| BuildBiffPalettePlan | Restituisce un piano di palette BIFF a 56 slot senza mutazioni, con slot bloccati, target true-color aggregati, mappature deterministiche, identità del sorgente e statistiche di errore OKLab pesate |
| ApplyBiffPalettePlan | completo con tutti i 64 slot |
| HasCustomIndexedColor / CustomIndexedColorCount / ResetIndexedColors | HasCustomIndexedColor(N) restituisce
True quando lo slot N è stato sovrascritto esplicitamente
CustomIndexedColorCount restituisce il numero di slot sovrascritti
(0 = nessun blocco <colors> emesso da SaveAs)
ResetIndexedColors scarta ogni sovrascrittura e ripristina
la palette predefinita |
| ExternalLinks | Raccolta di riferimenti a cartelle di lavoro esterne. Ogni voce
TXLSXExternalLink
contiene un URL Target e un elenco SheetNames . SaveAs
emette il blocco <externalReferences> in
xl/workbook.xml e le parti
xl/externalLinks/ parti. Open fa transitare Target e
SheetNames nel round-trip; i valori delle celle in cache all'interno di
<sheetDataSet> are not preserved |
| CreateWorkspaceWorkbook | Returns the revocable IXLSWorkspaceWorkbook adapter per questa cartella di lavoro L'adapter preserva l'identità e la generazione del sorgente della cartella di lavoro e si disconnette prima che il modello della cartella di lavoro venga distrutto |
| ExternalWorkspace | Registro thread-safe che preserva i percorsi e viene usato dalla valutazione live delle formule esterne Identità esatte e alias sono preferiti, la ricerca per basename ambigua viene rifiutata e la normalizzazione delle identità non esegue accessi impliciti a file o rete Vedere Live workbook workspace |
| RegisterExternalWorkbook / UnregisterExternalWorkbook | corrispondenti. Open fa il round-trip di Target e
SheetNames; i valori delle celle in cache all'interno di ExternalWorkspace non vengono preservati |
uses lxHandleX;
var
wb: TXLSXWorkbook;
begin
wb := TXLSXWorkbook.Create;
try
wb.Sheets.Add('Demo').Cells.Item[1, 1].Value := 'Hello';
wb.SaveAs('demo.xlsx');
wb.Open('demo.xlsx');
ShowMessage(wb.Sheets[0].Cells.Item[1, 1].Value);
finally
wb.Free;
end;
end;