iText 7 获取文本宽度的正确方法

在 iText 7 中，获取文本宽度不再像 iText 5 那样通过链式调用 `getWidthPoint()` 简单实现，而是必须依托字体对象（推荐使用 `PdfFont.getWidth(text, fontSize)`）进行显式计算——这一设计剥离了布局逻辑与字形度量的耦合，不仅修复了旧版因上下文依赖导致的精度偏差，更全面支持 Unicode、OpenType 字体及字距调整，让多语言排版、动态文本测量和专业 PDF 生成变得真正可靠且高效。

在 iText 7 中，getWidthPoint() 已被移除，需通过 BaseFont.getWidthPoint() 或 PdfFont.getWidth() 配合字体实例和字号显式计算文本宽度，不再支持链式调用后直接获取。

在 iText 7 中，`getWidthPoint()` 已被移除，需通过 `BaseFont.getWidthPoint()` 或 `PdfFont.getWidth()` 配合字体实例和字号显式计算文本宽度，不再支持链式调用后直接获取。

在从 iText 5 升级到 iText 7 的过程中，许多开发者会遇到文本宽度计算失效的问题。例如，以下 iText 5 代码可直接返回宽度（单位：点）：

new Chunk(" TEST ", FONT_BOLD).getWidthPoint();

但在 iText 7 中，类似链式构建的 Text 对象（如 new Text(" TEST ").setFont(...).setFontSize(...)）不提供 getWidthPoint() 或等效的宽度访问器；调用 .getStrokeWidth() 等方法返回 null 是预期行为——因为 Text 是布局元素，其最终渲染宽度取决于上下文（如容器宽度、换行、对齐等），并非静态可预知值。

✅ 正确替代方案是：使用字体对象本身提供的宽度计算方法，分为两类：

1. 使用 PdfFont.getWidth()（推荐，面向现代 API）

适用于已加载的 PdfFont 实例（如通过 PdfFontFactory.createFont() 获取）：

PdfFont font = PdfFontFactory.createFont(StandardFonts.HELVETICA_BOLD);
float fontSize = 12f;
String text = " TEST ";
float widthInPoints = font.getWidth(text, fontSize); // 返回精确字形宽度（含字距调整）

✅ 优势：支持 TrueType、OpenType、嵌入字体及 Unicode 处理；自动应用字体内置的字宽表（glyph width table），结果更准确。

2. 使用 BaseFont.getWidthPoint()（兼容旧逻辑，仅限 Type1/TrueType 基础字体）

若你仍使用 BaseFont（如 BaseFont.createFont(...)），可调用：

BaseFont baseFont = BaseFont.createFont(StandardFonts.HELVETICA_BOLD, BaseFont.WINANSI, false);
float widthInPoints = baseFont.getWidthPoint(" TEST ", 12f);

⚠️ 注意：BaseFont 在 iText 7 中属于遗留层，不推荐新项目使用；它不支持 OpenType 字体或高级排版特性，且部分构造方式已被弃用。

? 关键注意事项

• 不可对 Text、Paragraph 等布局对象调用宽度方法：它们的尺寸由 Document 渲染流程动态决定，需通过 LayoutManager 获取实际布局结果（适用于复杂场景，但开销大，非必要不推荐）。
• 空格与不可见字符计入宽度：" TEST " 中首尾空格会被计算，如需净内容宽度，建议先 trim() 再测量。
• 字号单位始终为“点（pt）”：与 PDF 规范一致，1 pt = 1/72 英寸，无需额外换算。
• 性能提示：PdfFont.getWidth() 是轻量级纯计算，可安全用于循环或高频调用。

✅ 总结

iText 7 将文本度量职责明确交还给字体对象，体现了“关注点分离”的设计原则。要获取字符串的 PDF 渲染宽度，请务必：

1. 持有有效的 PdfFont 实例；
2. 调用 font.getWidth(text, fontSize)；
3. 避免依赖布局类的中间状态。

这一变更虽需适配，却显著提升了精度与可预测性——尤其在多语言、变体字体或自定义字距场景下，成为构建专业 PDF 排版功能的可靠基础。

到这里，我们也就讲完了《iText 7 获取文本宽度的正确方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！