Features
Caratteristiche
Aspose.Cells FOSS per C++ è una libreria C++ open-source per creare, caricare, modificare e salvare cartelle di lavoro Excel .xlsx senza richiedere Microsoft Excel. La libreria espone un header-only C++ API organizzato attorno a un piccolo insieme di classi core.
Gestione di cartelle di lavoro e fogli di lavoro
La classe Workbook è l’oggetto radice per tutte le operazioni sui fogli di calcolo. Usala per creare una nuova cartella di lavoro, caricare un file XLSX esistente o salvare le modifiche su disco.
- Crea una nuova cartella di lavoro con
Workbook() - Carica un file XLSX con
Workbook(filePath) - Salva su file con
Workbook::Save(fileName) - Accedi a tutti i fogli tramite
Workbook::GetWorksheets() - Aggiungi, rinomina e configura i fogli tramite la classe
Worksheet
Valori e formule delle celle
La classe Cell rappresenta una singola cella del foglio di calcolo. Supporta la lettura e la scrittura di valori di testo, numerici, booleani e di formula.
- Scrivi valori con
Cell::PutValue(value)eCell::SetValue(value) - Leggi valori con
Cell::GetValue()restituisce unCellValue - Imposta formule con
Cell::SetFormula(formula)— sintassi standard delle formule Excel - Indirizza le celle per nome (
"A1") o per indice riga/colonna tramiteCells::operator[](cellName)
Stile delle celle
Applica una formattazione avanzata alle celle usando la classe Style. Ottieni lo stile corrente da Cell::GetStyle(), modificalo e riapplicalo con Cell::SetStyle(style).
- Configurazione del carattere tramite
Style::Font()che restituisce un oggettoFont— grassetto, colore, dimensione - Modelli di riempimento dello sfondo tramite
Style::SetPattern(FillPattern)eStyle::SetForegroundColor(Color) - Configurazione dei bordi tramite
Style::Borders() - Stringhe di formato numerico tramite
Style::SetNumberFormat(format)
Impostazione pagina e layout di stampa
La classe PageSetup consente di configurare le impostazioni di stampa del foglio di lavoro, come dimensione della carta, orientamento, margini, scala e testo dell’intestazione/piè di pagina.
- Imposta le dimensioni della carta con
PageSetup::SetPaperSize(PaperSizeType) - Imposta l’orientamento di stampa con
PageSetup::SetOrientation(PageOrientationType) - Configura i margini:
PageSetup::SetTopMargin,SetBottomMargin,SetLeftMargin,SetRightMargin - Ridimensionamento adatta alla pagina con
PageSetup::SetFitToPagesTalleSetFitToPagesWide
Formattazione condizionale
La classe ConditionalFormattingCollection gestisce la formattazione delle celle basata su regole. Le regole possono essere aggiunte agli intervalli del foglio di lavoro e la priorità può essere gestita automaticamente.
- Aggiungi regole con
ConditionalFormattingCollection::Add() - Rimuovi le regole per indice o area
- Recupera la prossima priorità disponibile con
ConditionalFormattingCollection::GetNextPriority()
Filtro automatico
La classe AutoFilter supporta l’applicazione di filtri dati a livello di colonna agli intervalli di fogli di lavoro.
- Imposta l’intervallo del filtro con
AutoFilter::SetRange(rangeAddress) - Cancella tutti i filtri attivi con
AutoFilter::Clear() - Gestisci i filtri personalizzati tramite
AutoFilterCustomFiltereAutoFilterCustomFilterCollection
Intervalli denominati e nomi definiti
La classe DefinedName memorizza formule e intervalli denominati a livello di cartella di lavoro o di foglio per il riutilizzo in formule e codice.
- Ottieni il nome definito con
DefinedName::GetName() - Ottieni o imposta la formula (indirizzo dell’intervallo) con
DefinedName::GetFormula()/SetFormula(formula) - Limita a un foglio specifico usando
DefinedName::GetLocalSheetIndex()
Supporto del formato XLSX
| Formato | Load | Save |
|---|---|---|
| XLSX | ✔ | ✔ |
| CSV | ✔ | — |
Tutte le operazioni di caricamento e salvataggio usano le overload Workbook::Save(fileName). Il formato è inferito dall’estensione del file per impostazione predefinita.
API Reference Riepilogo
| Classe | Descrizione |
|---|---|
Workbook | Oggetto principale del foglio di calcolo — crea, carica e salva file XLSX |
Worksheet | Foglio di lavoro singolo — nome, celle, impostazioni di stampa e filtro automatico |
Cell | Cella singola — valore, formula e operazioni di stile |
Style | Facciata dello stile cella — carattere, riempimento, bordi e formato numero |
Font | Impostazioni del carattere — grassetto, colore, dimensione |
PageSetup | Layout di stampa — formato carta, orientamento, margini, scala |
ConditionalFormattingCollection | Raccolta di regole di formattazione condizionale |
AutoFilter | Filtro automatico a livello di colonna per un intervallo di foglio di lavoro |
DefinedName | Intervallo denominato o definizione di formula |