報表控件stimulsoft教程：報表或儀表盤中的字體配置

翻譯|使用教程|編輯：吉煒煒|2025-05-26 10:34:14.307|閱讀 127 次

概述：在創建報表或儀表板時，用戶經常會遇到與字體相關的問題：哪些字體可用、字體如何工作以及字體在不同設備上的顯示方式。在今天的文章中，我們將深入探討這些問題以及其他問題，并找出決定報表設計器中可用字體列表的因素。

相關鏈接：

在創建報表或儀表板時，用戶經常會遇到與字體相關的問題：哪些字體可用、字體如何工作以及字體在不同設備上的顯示方式。在今天的文章中，我們將深入探討這些問題以及其他問題，并找出決定報表設計器中可用字體列表的因素。答案是：主要因素是操作系統和所使用的產品。

Stimulsoft Ultimate （原Stimulsoft Reports.Ultimate）是用于創建報表和儀表板的通用工具集。該產品包括用于WinForms、ASP.NET、.NET Core、JavaScript、WPF、PHP、Java和其他環境的完整工具集。無需比較產品功能，Stimulsoft Ultimate包含了所有內容！

Stimulsoft Ultimate 最新版下載

操作系統

每個操作系統都包含一組基本字體，這些字體可能因操作系統版本和更新而異。此外，用戶可以手動安裝其他字體或通過第三方應用程序安裝。所有字體通常分為兩大類：位圖字體和矢量字體（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