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.
- L’API cerca di trovare i font nel file system corrispondenti al nome esatto del font utilizzato nel foglio di calcolo.
- 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.
- 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.
- 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.
- 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.
- Infine, se l’API non riesce a trovare alcun font nel file system, renderizza il foglio di calcolo utilizzando Arial.
Impostazione delle cartelle dei font personalizzate
Le API di Aspose.Cells cercano nella directory predefinita dei font del sistema operativo 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 una serie di modi per impostare le directory dei font personalizzate come dettagliato di seguito.
- FontConfigs.SetFontFolder: Questo metodo è utile se c’è solo una cartella da impostare.
- 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.
- 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.
Meccanismo di sostituzione del font
Le API di Aspose.Cells forniscono anche la possibilità di specificare il font sostitutivo per scopi di rendering. 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 originariamente richiesto. 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 da sostituire. Il secondo parametro è un array di tipo string. Gli utenti possono fornire un elenco di nomi di font come sostituzione al nome del font originale (specificato nel primo parametro).
Ecco uno scenario d’uso semplice.
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.
- Il metodo FontConfigs.GetFontSources restituisce un array di tipo FontSourceBase contenente l’elenco delle fonti specificate. Nel caso in cui non siano state impostate fonti, il metodo FontConfigs.GetFontSources restituirà un array vuoto.
- Il metodo FontConfigs.GetFontSubstitutes accetta un parametro di tipo string che consente di specificare il nome del carattere per il quale è stata impostata una sostituzione. Nel caso in cui non sia stata impostata alcuna sostituzione per il nome del carattere specificato, il metodo FontConfigs.GetFontSubstitutes restituirà null.