QI Mingxuan
1.6 KiB
1.6 KiB
字体方案说明 | Font Strategy
当前方案 | Current Approach
XP.ReportEngine 使用 Windows 系统自带字体 生成 PDF，无需额外下载或嵌入字体文件。
| 语言 | 字体 | 文件 | 说明 |
|---|---|---|---|
| 简体中文 / 繁体中文 | 微软雅黑 | C:\Windows\Fonts\msyh.ttc |
Windows 10+ 自带，支持简繁体 |
| 西文（英文等） | Arial | C:\Windows\Fonts\arial.ttf |
Windows 自带 |
为什么使用系统字体 | Why System Fonts
- Telerik RadPdfViewer 兼容性 — 系统字体生成的 PDF 在 Telerik RadPdfViewer 中显示正常，不会出现中文乱码
- 无需额外部署 — 不需要随应用程序分发字体文件，减小安装包体积
- 跨阅读器兼容 — 字体以子集嵌入 PDF 中（
PREFER_EMBEDDED），在任何 PDF 阅读器中都能正确显示
后备机制 | Fallback Mechanism
ITextPdfRenderer 按以下顺序加载字体：
- 微软雅黑（
msyh.ttc）→ 加载失败时尝试宋体（simsun.ttc） - Arial（
arial.ttf）→ 加载失败时使用 iText 内置 Helvetica - 最终后备：Helvetica（不支持中文字符）
系统要求 | System Requirements
- Windows 10 或更高版本（微软雅黑为系统预装字体）
- 如果在精简版 Windows 上运行，需确保系统已安装微软雅黑字体
Fonts 目录 | Fonts Directory
XP.ReportEngine/Fonts/ 目录当前为空，保留用于未来可能的自定义字体扩展。
如需添加自定义字体，可在 ITextPdfRenderer.InitializeFonts() 中扩展加载逻辑。