Risposte pratiche ai problemi che gli utenti di HotXLS incontrano per primi.

Quali versioni di Delphi e C++Builder sono supportate?

Il pacchetto completo supporta Delphi e C++Builder da XE5 a RAD Studio 13.1 Florence. L'installer della versione di prova fornisce attualmente pacchetti per RAD Studio 11.3, 12.3 e 13.1.

Perché l'installer elenca solo alcune versioni dell'IDE?

La pagina dell'IDE elenca le installazioni di RAD Studio supportate rilevate sulla macchina corrente. Se un IDE supportato non è elencato, verifica che RAD Studio sia installato e che l'installer venga eseguito con lo stesso profilo utente di Windows che possiede le impostazioni dell'IDE.

Dove appaiono i componenti in fase di progettazione?

L'installer registra una scheda della Tool Palette denominata losLab. I componenti visivi sono DataToXLS e GridToXLS.

Perché i pacchetti o le demo per C++Builder mancano dopo l'installazione?

I file dei pacchetti C++Builder e i progetti demo sono contenuti opzionali dell'installer. Seleziona la casella dell'IDE C++Builder corrispondente durante l'installazione quando hai bisogno dell'integrazione C++Builder o delle demo.

Win32 e Win64 sono supportati?

Sì. HotXLS fornisce output di pacchetti standard Win32 e Win64 per le versioni IDE supportate. L'installer può registrare i percorsi delle librerie Win64 per le ricompilazioni dal sorgente, ma i pacchetti Win64 precompilati non vengono attualmente forniti.

È necessario avere Microsoft Excel installato?

No. HotXLS legge, scrive, stilizza ed esporta i workbook direttamente. Non richiede Microsoft Excel, automazione Office, automazione COM o un processo esterno di foglio di calcolo.

Quali limiti applica la versione di prova?

Per ciascun workbook, la versione di prova consente fino a 5 fogli di lavoro, 100 righe per foglio e 26 colonne per foglio. Gli stessi limiti si applicano alla facade XLS e alla facade XLSX.

Perché l'output della versione di prova si ferma dopo la colonna Z o la riga 100?

Le scritture oltre i limiti della versione di prova vengono accettate dall'API ma escluse dal file salvato. La versione completa rimuove questi limiti senza richiedere modifiche al codice sorgente.

La versione di prova troncherà i file che apro?

No. L'apertura di un workbook esistente con più di 5 fogli o più di 100 righe e 26 colonne non tronca il file. I limiti si applicano alle aggiunte di fogli e alle scritture di celle avviate dall'utente dopo la creazione del workbook.

La versione di prova mostra avvisi quando viene raggiunto un limite?

No. I limiti sono silenziosi: nessuna finestra di dialogo, riga di log o eccezione viene emessa quando una scrittura supera il limite della versione di prova.

Devo usare lxHandle o lxHandleX?

Usa lxHandle per i flussi di lavoro XLS classici di Excel 97-2003 e per il codice di report legacy. Usa lxHandleX e TXLSXWorkbook per i file XLSX Excel 2007+ e per le funzionalità specifiche di OOXML.

Un progetto può usare entrambe le facade?

Sì. Le applicazioni possono includere entrambe le unità e mantenere oggetti workbook separati per ciascun formato di file. Questo è utile quando si mantiene il vecchio output XLS aggiungendo nuovi report XLSX.

Perché alcune funzionalità XLSX non sono disponibili tramite la vecchia API XLS?

XLS e XLSX hanno modelli di file diversi. I concetti solo-XLSX come le stringhe condivise, gli stili OOXML, le tabelle, i fogli di grafico e le relazioni di pacchetto vivono in lxHandleX piuttosto che essere adattati alla facade XLS classica.

Da dove dovrei iniziare con il codice di esempio?

Inizia con le demo QuickStart e ApiTour nelle cartelle demo Delphi o C++Builder. Per il codice specifico XLSX, usa la panoramica della facade XLSX e le demo di esportazione XLSX.

Quali funzionalità XLSX sono supportate?

TXLSXWorkbook supporta valori, formule, calcolo esplicito delle formule, stili, formati numerici personalizzati, larghezze e altezze, celle unite, esportazione HTML a livello di range, collegamenti ipertestuali, commenti, immagini, formattazione condizionale, convalida dei dati, filtri, tabelle, grafici, testo ricco, proprietà del documento, visibilità dei fogli, impostazioni di pagina, salvataggio crittografato AES e apertura/salvataggio basati su stream.

Posso salvare o aprire file XLSX da stream?

Sì. La facade XLSX supporta SaveAs(Stream) e Open(Stream), adatti per buffer di memoria, campi BLOB di database, risposte HTTP e altri percorsi di archiviazione non basati su file.

Come dovrebbero essere gestite le esportazioni XLSX di grandi dimensioni?

Usa la facade XLSX e attiva Workbook.StreamingWrite quando il report viene generato foglio per foglio. Le scritture in streaming riducono la pressione sulla memoria del workbook durante il salvataggio.

HotXLS può aprire o salvare archivi XLSX crittografati con password?

TXLSXWorkbook.SaveAsEncrypted può scrivere un contenitore XLSX protetto da AES ECMA-376 quando fornisci una password non vuota. OpenEncrypted può ripiegare sul normale Open per i pacchetti non crittografati, ma solleva ancora EXlsxEncryptionNotImplemented per i pacchetti crittografati finché non sarà disponibile il supporto alla decrittazione. La protezione del foglio e del workbook rimangono funzionalità di blocco separate in stile Excel.

Posso conservare le macro?

La facade XLSX può mantenere un payload vbaProject.bin byte per byte attraverso il workbook ed esporre una visualizzazione analizzata e di sola lettura ParsedVBAProject per l'archiviazione VBA valida. Non compila né esegue codice VBA.

Le formule vengono calcolate all'interno di HotXLS?

HotXLS scrive il testo delle formule nei workbook salvati e le applicazioni di foglio di calcolo possono ricalcolare quelle celle quando il file viene aperto. Per la valutazione esplicita in-process, sia la facade XLS classica che quella XLSX espongono Calculate; assegna OnUserFunction quando le funzioni di foglio personalizzate o non supportate devono essere gestite dal codice applicativo.

HotXLS può esportare formati diversi da XLS o XLSX?

Sì. HotXLS include helper di esportazione per formati come CSV, TSV, HTML e RTF. Usa la facade che corrisponde al formato del tuo workbook e scegli il metodo di esportazione richiesto dal tuo flusso di lavoro.

Posso usare HotXLS in servizi o strumenti batch?

Sì. Poiché HotXLS non automatizza Excel, è adatto per applicazioni desktop, servizi, processi batch, installer e utility lato server dove l'automazione Office sarebbe fragile o non disponibile.

Ci sono royalty runtime?

No. HotXLS non richiede royalty runtime. Servono licenze per sviluppatori per gli sviluppatori che creano applicazioni con la libreria.

Dove dovrei guardare prima di chiedere aiuto?

• Panoramica del prodotto per lo scope delle funzionalità e la struttura del pacchetto.
• Documentazione HTML per le pagine di riferimento dell'API.
• Panoramica della facade XLSX per gli esempi di workbook moderni.
• Avviso sui limiti della versione di prova quando l'output di prova è più piccolo del previsto.