报表控件stimulsoft教程：报表或仪表盘中的字体配置

翻译|使用教程|编辑：吉炜炜|2025-05-26 10:34:14.307|阅读 24 次

概述：在创建报表或仪表板时，用户经常会遇到与字体相关的问题：哪些字体可用、字体如何工作以及字体在不同设备上的显示方式。在今天的文章中，我们将深入探讨这些问题以及其他问题，并找出决定报表设计器中可用字体列表的因素。

操作系统

每个操作系统都包含一组基本字体，这些字体可能因操作系统版本和更新而异。此外，用户可以手动安装其他字体或通过第三方应用程序安装。所有字体通常分为两大类：位图字体和矢量字体（TrueType、OpenType、PostScript）。

由于我们的产品支持各种技术，字体的呈现方式可能有所不同。操作系统版本起着重要作用。例如，在 .NET Framework 上运行的Reports.NET和Reports.WPF在 Windows 8/10/11 中支持 TrueType 和 OpenType 字体，而旧版 Windows 仅支持 TrueType 字体。因此，报表设计器仅显示系统上已安装且产品支持的字体。

这些原则适用于Reports.NET、Reports.WPF和Dashboards.WIN。对于基于 Web 的产品（客户端-服务器技术），字体列表由服务器端的操作系统决定。但是，如果项目使用 JS 报表引擎，则可用字体列表由开发人员定义。

在本文中，我们将介绍如何为 JS 报告生成器连接字体的示例。需要注意的是，将报告导出为 PDF 时，我们建议使用字体嵌入模式。默认情况下，此模式处于启用状态，但您可以关闭以减小输出文件的大小。但是，为了确保 PDF 文件在不同设备和操作系统上都能正确显示，强烈建议嵌入字体。

将字体嵌入到报告资源中

确保字体在 Windows 和 macOS 等各种操作系统上的报表可用性的一个非常简单可靠的方法是将字体直接嵌入到报表资源中。创建或编辑报表时，字体文件将添加到报表资源中。之后，即可在报表或仪表板中使用该字体。这是一种可靠的方法，尤其是当需要在其他设备或其他操作系统上打开报表时。

此方法的主要缺点是增加了报表模板的文件大小。由于字体文件物理嵌入到报表文件中，因此大小会显著增加 - 特别是如果将多个字体文件添加到资源中。

有关如何使用设计器将字体文件添加到报表资源的视频教程可以找到。

所有其他方法都涉及通过项目代码添加字体。处理字体的主要类是StiFontCollection，它包含各种静态方法。

通过代码将字体文件嵌入到资源中

在项目开发过程中，可以通过代码将字体文件嵌入到报表资源中。其缺点与从设计器嵌入相同，主要是报表文件大小增加。

添加字体文件

可以使用addFontFile()方法添加字体文件。文件路径是必需参数，其他所有参数均为可选参数。除了文件路径之外，您还可以指定字体名称、字体样式以及字体加载参数。

缺点：如果您需要添加多个字体文件，此方法不太方便，因为它可能会导致重复的代码行。

添加字体文件夹

如果需要加载字体文件集合，可以为每个文件使用addFontFile()方法。然而，更合理的方法是指定整个字体文件夹。为此，StiFontCollection类提供了一个特殊的方法setFontsFolder()。此方法仅接受一个参数——包含字体文件的文件夹路径。

缺点：此方法仅适用于 Node.js 项目，因为出于安全策略考虑，浏览器无法访问文件系统。

添加字体配置

如上所述，无法在 Web 报表设计器中使用setFontsFolder()方法。但是，仍然可以使用addFontFile()方法将字体文件作为服务器资源加载到报表设计器中。为了避免在加载多种字体时重复代码行，您可以创建一个字体配置并将其传递给registerFontConfig()方法。

该配置应该是一个对象数组，其中每个对象定义字体属性，例如文件路径（必需）、字体名称和字体样式（可选）。

本质上，registerFontConfig()方法在底层使用了addFontFile() ，遍历提供的数组并加载所有指定的字体。

缺点：您必须事先创建一个配置对象。

没有一刀切的解决方案，但每种情况都有合适的方法。在构建报告和数据分析系统时，尤其是针对 Windows 和 macOS 等不同的操作系统，正确处理字体仍然是一个重要的考虑因素。根据具体情况选择最合适的字体管理方法：在某些情况下，将字体嵌入到报表资源中就足够了；在其他情况下，使用配置更方便。最终决定权在你。

---------------------------------------------------------------------------

关于慧都科技：

慧都科技是一家行业数字化解决方案公司，长期专注于软件、油气与制造行业。公司基于深入的业务理解与管理洞察，以系统化的业务建模驱动技术落地，帮助企业实现智能化运营与长期竞争优势。在软件工程领域，我们提供开发控件、研发管理、代码开发、部署运维等软件开发全链路所需的产品，提供正版授权采购、技术选型、个性化维保等服务，帮助客户实现技术合规、降本增效与风险可控。慧都科技是Stimulsoft的在中国区的合作伙伴，Stimulsoft作为图表报表领域的优秀产品，帮助企业实现轻松构建高性能的表格报告及图表。

下载|体验更多Stimulsoft产品，请咨询，或拨打产品热线：023-68661681