配置字体以渲染电子表格
Contents
[
Hide
]
可能的使用场景
Aspose.Cells API 提供了在图像格式中渲染电子表格以及将其转换为 PDF 和 XPS 格式的功能。为了最大程度地保持转换的准确性,电子表格中使用的字体应该存储在操作系统的默认字体目录中。如果所需字体不可用,则 Aspose.Cells API 将尝试使用可用的字体来替代所需字体。
选择字体
以下是 Aspose.Cells API 在幕后执行的过程。
- API试图在文件系统中找到与电子表格中使用的确切字体名称匹配的字体。
- 如果API无法找到具有相同名称的精确字体,则尝试使用工作簿的DefaultStyle.Font属性下指定的默认字体。
- 如果API无法找到工作簿的DefaultStyle.Font属性下定义的字体,则尝试使用PdfSaveOptions.DefaultFont或ImageOrPrintOptions.DefaultFont属性下指定的字体。
- 如果API无法找到PdfSaveOptions.DefaultFont或ImageOrPrintOptions.DefaultFont属性下定义的字体,则尝试使用FontConfigs.DefaultFontName属性下指定的字体。
- 如果API无法找到FontConfigs.DefaultFontName属性下定义的字体,则尝试从所有可用字体中选择最合适的字体。
- 最后,如果API在文件系统中找不到任何字体,则使用Arial呈现电子表格。
设置自定义字体文件夹
Aspose.Cells API会搜索操作系统的默认字体目录以获取所需的字体。如果系统的字体目录中没有所需的字体,则API将通过自定义(用户定义的)目录进行搜索。 FontConfigs 类已公开了许多设置自定义字体目录的方式。
- FontConfigs.SetFontFolder:如果只有一个要设置的文件夹,则此方法很有用。
- FontConfigs.SetFontFolders:当字体存在于多个文件夹中,而用户希望将所有文件夹分开设置而不是将所有字体合并到一个文件夹中时,此方法很有用。
- FontConfigs.SetFontSources:当用户希望从多个文件夹加载字体或从字节数组加载单个字体文件或字体数据时,此机制很有用。
Both FontConfigs.SetFontFolder 和 FontConfigs.SetFontFolders 方法接受一个布尔类型的第二个参数。 将 true 作为第二个参数传递将指示 Aspose.Cells API 在子文件夹中搜索字体文件。
请在应用程序启动时使用以上任一方法,在调用 Aspose.Cells API 的其他对象之前使用。
如果使用所有上述方法设置字体源,则只有最后一次设置将生效。
字体替换机制
Aspose.Cells API 还提供了指定替代字体以进行渲染的能力。 当需要的字体在进行转换的机器上不可用时,这种机制非常有用。 用户可以提供字体名称列表作为原始所需字体的替代。 为了实现这一点,Aspose.Cells API 公开了一个接受 2 个参数的 FontConfigs.SetFontSubstitutes 方法。 第一个参数是 string 类型,应该是需要替换的字体的名称。 第二个参数是 string 类型的数组。 用户可以提供字体名称列表作为原始字体名称(指定在第一个参数中)的替代。
这里是一个简单的使用场景。
信息收集
除上述方法外,Aspose.Cells APIs还提供了收集已设置的来源和替换信息的手段。
- FontConfigs.GetFontSources 方法返回一个 FontSourceBase 类型的数组,其中包含指定字体源的列表。 如果没有设置源,则 FontConfigs.GetFontSources 方法将返回一个空数组。
- FontConfigs.GetFontSubstitutes 方法接受一个 string 类型的参数,允许指定已设置替代字体的字体名称。 如果为指定的字体名称设置了替换,则 FontConfigs.GetFontSubstitutes 方法将返回 null。