Java 中文 PDF 排版利器：文字对齐精讲

在 Java 开发中，处理 PDF 文档的生成与编辑是常见的需求。然而，当涉及到复杂的排版，特别是中文内容的文字对齐时，许多开发者常常会遇到挑战。默认的文本输出往往难以满足美观或规范的要求，精确控制文字的对齐方式变得至关重要。本文将深入探讨如何利用 Java 高效、准确地设置 PDF 中的文字对齐方式，特别是借助强大的 Spire.PDF for Java 库，帮助你轻松解决中文排版难题。

1. Spire.PDF for Java 简介与安装

Spire.PDF for Java 是一个专业的 PDF 组件，专为 Java 应用程序设计，用于创建、读取、写入、编辑和转换 PDF 文档。它提供了丰富的 API 接口，可以实现 PDF 文本、图片、表格的绘制与排版，以及页面操作、表单填写、安全加密等功能。对于需要精细控制 PDF 文档布局，尤其是文字对齐和中文排版的用户来说，它是一个非常便捷且功能强大的选择。

Maven 依赖配置

要在你的 Java 项目中使用 Spire.PDF，只需在 pom.xml 文件中添加以下 Maven 依赖：

xml 复制代码

    
    
    
  <repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.pdf</artifactId>
        <version>11.12.16</version>
    </dependency>
</dependencies>

2. 设置 PDF 段落文字对齐方式

在 PDF 文档中，段落对齐是构建清晰、易读内容的基础，无论是报告的正文、合同条款还是书籍章节，都需要精确的段落对齐来提升专业度。Spire.PDF 提供了灵活的 API 来控制段落的水平对齐方式。

以下代码示例将演示如何创建一个包含文字的 PDF 文档，并为段落中的文本设置 左对齐 、居中、右对齐 和 两端对齐效果。

java 复制代码

    
    
    
  import com.spire.pdf.graphics.*;

import java.awt.*;

public class AlignText {

    public static void main(String[] args) {

        //创建PdfDocument对象
        PdfDocument doc = new PdfDocument();
        
        //添加一页
        PdfPageBase page = doc.getPages().add();

        //创建CJK字体
        PdfCjkStandardFont cjkFont = new PdfCjkStandardFont(PdfCjkFontFamily.Sino_Type_Song_Light, 15f);

        //创建画刷
        PdfSolidBrush brush = new PdfSolidBrush(new PdfRGBColor(Color.black));

        //使用PdfStringFormat创建左对齐
        PdfStringFormat leftAlignment = new PdfStringFormat(PdfTextAlignment.Left);
        
        //使用drawSting方法绘制文字，并在方法中传入左对齐参数
        page.getCanvas().drawString("靠左", cjkFont , brush, 0, 20, leftAlignment);

        //绘制右对齐文字
        PdfStringFormat rightAlignment = new PdfStringFormat(PdfTextAlignment.Right);
        page.getCanvas().drawString("靠右", cjkFont , brush, page.getCanvas().getClientSize().getWidth(), 20, rightAlignment);

        //绘制居中文字
        PdfStringFormat centerAlignment = new PdfStringFormat(PdfTextAlignment.Center);
        page.getCanvas().drawString("居中", cjkFont , brush, page.getCanvas().getClientSize().getWidth() / 2, 20, centerAlignment);

        //保存文档
        doc.saveToFile("AlignText.pdf");
    }
}

在上述代码中，我们通过 PdfStringFormat 类的 PdfTextAlignment 属性来控制文本的水平对齐方式。PdfTextAlignment 枚举提供了 Left (左对齐), Center (居中), Right (右对齐), Justify (两端对齐) 选项。

3. 设置文本框内文字对齐方式

除了段落对齐，在 PDF 中，我们还经常需要在特定的 文本框 、单元格 或 固定布局区域 内设置文字的对齐方式。例如，在创建表单、生成表格或设计复杂布局时，对文本框内文字的精确控制变得尤为重要。Spire.PDF 允许我们通过在绘制文本时指定 PdfStringFormat 来实现。

以下代码将展示如何创建一个包含文本框的 PDF，并设置文本框内文字的多种对齐方式。

java 复制代码

    
    
    
  import com.spire.pdf.graphics.*;

import java.awt.*;
import java.awt.geom.Rectangle2D;

public class AlignTextWithinRectangle {

    public static void main(String[] args) {

        //创建PdfDocument对象
        PdfDocument doc = new PdfDocument();
        
        //添加一页
        PdfPageBase page = doc.getPages().add();

        //创建CJK字体
        PdfCjkStandardFont cjkFont = new PdfCjkStandardFont(PdfCjkFontFamily.Sino_Type_Song_Light, 15f);
        
        //创建画笔
        PdfPen pen = new PdfPen(new PdfRGBColor(Color.black));
        
        //创建画刷
        PdfSolidBrush brush = new PdfSolidBrush(new PdfRGBColor(Color.black));

        //在PDF中绘制一个矩形
        Rectangle2D.Float rect = new Rectangle2D.Float();
        rect.setRect(0, 20, page.getCanvas().getClientSize().getWidth() / 2, 100);
        page.getCanvas().drawRectangle(pen, rect);

        //使用PdfSringFormat创建左上对齐
        PdfStringFormat topLeft = new PdfStringFormat(PdfTextAlignment.Left, PdfVerticalAlignment.Top);
        
        //使用drawSting方法绘制文字，并在方法中传入左上对齐参数
        page.getCanvas().drawString("左上", cjkFont, brush, rect, topLeft);

        //同理，绘制右上对齐文字
        PdfStringFormat topRight = new PdfStringFormat(PdfTextAlignment.Right, PdfVerticalAlignment.Top);
        page.getCanvas().drawString("右上", cjkFont, brush, rect, topRight);

        //绘制居中文字
        PdfStringFormat center = new PdfStringFormat(PdfTextAlignment.Center, PdfVerticalAlignment.Middle);
        page.getCanvas().drawString("居中", cjkFont, brush, rect, center);

        //绘制左下对齐文字
        PdfStringFormat bottomLeft = new PdfStringFormat(PdfTextAlignment.Left, PdfVerticalAlignment.Bottom);
        page.getCanvas().drawString("左下", cjkFont, brush, rect, bottomLeft);

        //绘制右下对齐文字
        PdfStringFormat bottomRight = new PdfStringFormat(PdfTextAlignment.Right, PdfVerticalAlignment.Bottom);
        page.getCanvas().drawString("右下", cjkFont, brush, rect, bottomRight);

        //保存文档
        doc.saveToFile("AlignTextWithinRectangle.pdf");
    }
}

在这个示例中，我们仍然通过 PdfTextAlignment 来设置文本框内的文本对齐方式。同时使用 PdfVerticalAlignment 来控制文本的上下对齐，以达到文本的左上、左下、右、右下等对齐方式。这种方式非常适合在 PDF 中创建具有特定布局和对齐要求的可编辑或固定文本区域。

结语

通过本文的详细教程，我们深入探讨了如何使用 Java 和 Spire.PDF 库来精确控制 PDF 文档中的文字对齐方式。无论是针对 段落的整体排版 ，还是 文本框内的局部对齐 ，Spire.PDF 都提供了强大而灵活的 API 支持。开发者可以轻松实现中文文本的 左对齐、居中、右对齐和两端对齐，从而创建出专业、美观且符合规范的 PDF 文档。

希望这篇教程能帮助你在 Java PDF 开发中，告别中文乱码和排版难题，更高效地构建出高质量的文档。鼓励你根据自身项目需求，进一步探索 Spire.PDF 的其他丰富功能，如表格处理、图片插入、页面操作等，以解锁更多 PDF 文档处理的可能性！