Configurazione dei Font per la Visualizzazione dei Fogli di Lavoro

Possibili Scenari di Utilizzo

Le API di Aspose.Cells forniscono la possibilità di rendere i fogli di calcolo in formati di immagine e di convertirli in formati PDF e XPS. Per massimizzare la fedeltà della conversione, è necessario che i font utilizzati nel foglio di calcolo siano disponibili nella directory predefinita dei font del sistema operativo. Nel caso in cui i font richiesti non siano presenti, le API di Aspose.Cells cercheranno di sostituire i font richiesti con quelli disponibili.

Selezione dei font

Di seguito il processo che le API di Aspose.Cells seguono dietro le quinte.

1. L’API cerca di trovare i font nel file system corrispondenti al nome esatto del font utilizzato nel foglio di calcolo.
2. Se l’API non riesce a trovare i font con lo stesso nome esatto, tenta di utilizzare il font predefinito specificato nella proprietà DefaultStyle.Font del foglio di lavoro.
3. Se l’API non riesce a individuare il font definito nella proprietà DefaultStyle.Font del foglio di lavoro, tenta di utilizzare il font specificato nelle proprietà PdfSaveOptions.DefaultFont o ImageOrPrintOptions.DefaultFont.
4. Se l’API non riesce a individuare il font definito nelle proprietà PdfSaveOptions.DefaultFont o ImageOrPrintOptions.DefaultFont, tenta di utilizzare il font specificato nella proprietà FontConfigs.DefaultFontName.
5. Se l’API non riesce a individuare il font definito nella proprietà FontConfigs.DefaultFontName, tenta di selezionare i font più adatti tra tutti i font disponibili.
6. Infine, se l’API non riesce a trovare alcun font nel file system, renderizza il foglio di calcolo utilizzando Arial.

Le API di Aspose.Cells scansionano sempre la directory predefinita dei font del sistema operativo, con un’eccezione, ovvero quando gli argomenti JVM -DAspose.Cells.FontDirExc=“YourFontDir” sono impostati. In tal caso, le API di Aspose.Cells salteranno la scansione della directory predefinita dei font del sistema operativo e cercheranno solo il percorso specificato negli argomenti JVM menzionati.

Impostazione delle cartelle dei font personalizzate

Le API di Aspose.Cells cercano la directory predefinita dei font del sistema operativo per i font richiesti. Nel caso in cui i font richiesti non siano disponibili nella directory dei font del sistema, le API cercano attraverso le directory personalizzate (definite dall’utente). La classe FontConfigs ha esposto un certo numero di modi per impostare le directory dei font personalizzate come dettagliato di seguito.

1. FontConfigs.setFontFolder: Questo metodo è utile se c’è solo una cartella da impostare.
2. FontConfigs.setFontFolders: Questo metodo è utile quando i font risiedono in più cartelle e l’utente desidera impostare tutte le cartelle separatamente anziché combinare tutti i font in una singola cartella.
3. FontConfigs.setFontSources: Questo meccanismo è utile quando l’utente desidera caricare i font da più cartelle o un singolo file font o dati font da un array di byte.

Entrambi i metodi FontConfigs.setFontFolder e FontConfigs.setFontFolders accettano un secondo parametro di tipo Boolean. Passare true come secondo parametro indirizzerà le API di Aspose.Cells a cercare i file dei font nelle sottocartelle.

Si prega di utilizzare uno qualsiasi dei metodi sopra menzionati all’inizio dell’applicazione, cioè prima di invocare qualsiasi altro oggetto delle API di Aspose.Cells.

Se vengono utilizzati più di uno dei metodi sopra menzionati per impostare le origini dei font, solo le ultime impostazioni avranno effetto.

Meccanismo di sostituzione del font

Le API di Aspose.Cells forniscono anche la capacità di specificare il font sostitutivo per scopi di visualizzazione. Questo meccanismo è utile quando un font richiesto non è disponibile sulla macchina dove deve avvenire la conversione. Gli utenti possono fornire un elenco di nomi di font come alternativa al font richiesto originariamente. Per ottenere questo, le API di Aspose.Cells hanno esposto il metodo FontConfigs.setFontSubstitutes che accetta 2 parametri. Il primo parametro è di tipo String, che dovrebbe essere il nome del font che deve essere sostituito. Il secondo parametro è un array di tipo String. Gli utenti possono fornire un elenco di nomi di font come sostituti al font originale (specificato nel primo parametro).

Ecco uno scenario d’uso semplice.

 //Substituting the Arial font with Times New Roman & Calibri

FontConfigs.setFontSubstitutes("Arial", new String[] { "Times New Roman", "Calibri" });

Raccolta informazioni

Oltre ai metodi sopra menzionati, le API Aspose.Cells forniscono anche mezzi per raccogliere informazioni su quali fonti e sostituzioni sono state impostate.

1. FontConfigs.getFontSources: Questo metodo restituisce un array di tipo FontSourceBase contenente l’elenco delle origini dei font specificate. Nel caso in cui non siano state impostate delle origini, il metodo FontConfigs.getFontSources restituirà un array vuoto.
2. FontConfigs.getFontSubstitutes: Questo metodo accetta un parametro di tipo String permettendo di specificare il nome del font per il quale è stata impostata la sostituzione. Nel caso in cui non sia stata impostata alcuna sostituzione per il nome del font specificato, il metodo FontConfigs.getFontSubstitutes restituirà null.