Configuración de fuentes para renderizar hojas de cálculo
Posibles escenarios de uso
Las API Aspose.Cells brindan la posibilidad de representar las hojas de cálculo en formatos de imagen, así como convertirlas a los formatos PDF y XPS. Para maximizar la fidelidad de la conversión, es necesario que las fuentes utilizadas en la hoja de cálculo estén disponibles en el directorio de fuentes predeterminado del sistema operativo. En caso de que las fuentes requeridas no estén presentes, las API Aspose.Cells intentarán sustituir las fuentes requeridas por las disponibles.
Selección de fuentes
A continuación se muestra el proceso que siguen las API Aspose.Cells detrás de escena.
- El API intenta encontrar las fuentes en el sistema de archivos que coincidan con el nombre de fuente exacto utilizado en la hoja de cálculo.
- Si API no puede encontrar las fuentes con exactamente el mismo nombre, intenta usar la fuente predeterminada especificada en el Libro de trabajo.DefaultStyle.Font propiedad.
- Si API no puede localizar la fuente definida en el libro de trabajo**DefaultStyle.Font** propiedad, intenta utilizar la fuente especificada en**PdfSaveOptions.DefaultFont** o**ImageOrPrintOptions.DefaultFont** propiedad.
- Si API no puede localizar la fuente definida en**PdfSaveOptions.DefaultFont** o**ImageOrPrintOptions.DefaultFont** propiedad, intenta utilizar la fuente especificada en**FontConfigs.DefaultFontName** propiedad.
- Si API no puede localizar la fuente definida en**FontConfigs.DefaultFontName** propiedad, intenta seleccionar las fuentes más adecuadas de todas las fuentes disponibles.
- Finalmente, si API no puede encontrar ninguna fuente en el sistema de archivos, procesa la hoja de cálculo usando Arial.
Establecer carpetas de fuentes personalizadas
Aspose.Cells Las API buscan en el directorio de fuentes predeterminado del sistema operativo las fuentes requeridas. En caso de que las fuentes requeridas no estén disponibles en el directorio de fuentes del sistema, las API buscan en los directorios personalizados (definidos por el usuario). Él**Configuraciones de fuentes**class ha expuesto varias formas de establecer directorios de fuentes personalizados como se detalla a continuación.
- FontConfigs.SetFontFolder: Este método es útil si solo hay una carpeta para configurar.
- FontConfigs.SetFontFolders: este método es útil cuando las fuentes residen en varias carpetas y el usuario desea configurar todas las carpetas por separado en lugar de combinar todas las fuentes en una sola carpeta.
- FontConfigs.SetFontSources: este mecanismo es útil cuando el usuario desea cargar fuentes de varias carpetas o un solo archivo de fuentes o datos de fuentes de una matriz de bytes.
Mecanismo de sustitución de fuentes
Las API Aspose.Cells también brindan la capacidad de especificar la fuente sustituta para fines de representación. Este mecanismo es útil cuando una fuente requerida no está disponible en la máquina donde se debe realizar la conversión. Los usuarios pueden proporcionar una lista de nombres de fuentes como alternativa a la fuente requerida originalmente. Para lograr esto, las API Aspose.Cells han expuesto el**FontConfigs.SetFontSubstitutes** método que acepta 2 parámetros. El primer parámetro es de tipo**cadena** , que debe ser el nombre de la fuente que debe sustituirse. El segundo parámetro es una matriz de tipo**cadena**Los usuarios pueden proporcionar una lista de nombres de fuentes como sustitución del nombre de fuente original (especificado en el primer parámetro).
Aquí hay un escenario de uso simple.
Recopilación de información
Además de los métodos mencionados anteriormente, las API Aspose.Cells también han proporcionado medios para recopilar información sobre qué fuentes y sustituciones se han establecido.
- FontConfigs.GetFontSources método devuelve una matriz de tipo**FuenteFuenteBase**que contiene la lista de fuentes de fuentes especificadas. En caso de que no se hayan establecido fuentes, el**FontConfigs.GetFontSources**El método devolverá una matriz vacía.
- FontConfigs.GetFontSubstitutes método acepta un parámetro de tipocadena permitiendo especificar el nombre de la fuente para la que se ha establecido la sustitución. En caso de que no se haya establecido ninguna sustitución para el nombre de fuente especificado, el**FontConfigs.GetFontSubstitutes**método devolverá nulo.