iText - 绘制线条

在本章中，我们将了解如何使用 iText 库在 PDF 文档上绘制线条。

在 PDF 上绘制线条

您可以通过实例化 Document 类来创建一个空的 PDF 文档。实例化此类时，您需要将 PdfDocument 对象作为参数传递给其构造函数。

要在 PdfDocument 上绘制一条线，请实例化包 com.itextpdf.kernel.pdf.canvas 中的 PdfCanvas 类，并使用此类的 moveTo() 和 lineTO() 方法创建一条线。

以下是在 pdf 文档上绘制一条线的步骤。

步骤 1：创建 PdfWriter 对象

PdfWriter 类表示 PDF 的 DocWriter。此类属于包 com.itextpdf.kernel.pdf。此类的构造函数接受一个字符串，表示要创建 PDF 的文件的路径。

通过将字符串值（表示需要创建 PDF 的路径）传递给其构造函数来实例化 PdfWriter 类，如下所示。

// 创建 PdfWriter
String dest = "C:/itextExamples/drawingLine.pdf";
PdfWriter writer = new PdfWriter(dest);

当将此类型的对象传递给 PdfDocument（类）时，添加到此文档的每个元素都将写入指定的文件。

步骤 2：创建 PdfDocument 对象

PdfDocument 类是 iText 中表示 PDF 文档的类。此类属于包 com.itextpdf.kernel.pdf。要实例化此类（在写入模式下），您需要将类 PdfWriter 的对象传递给其构造函数。

通过将上面创建的 PdfWriter 对象传递给其构造函数来实例化 PdfDocument 类，如下所示。

// 创建 PdfDocument
PdfDocument pdfDoc = new PdfDocument(writer);

一旦创建了 PdfDocument 对象，您就可以使用其类提供的相应方法添加各种元素，如页面、字体、文件附件和事件处理程序。

步骤 3：创建 Document 对象

包 com.itextpdf.layout 的 Document 类是创建自给自足 PDF 时的根元素。此类的构造函数之一接受 PdfDocument 类的对象。

通过传递在前面的步骤中创建的 PdfDocument 类的对象来实例化 Document 类，如下所示。

// 创建文档
Document document = new Document(pdfDoc);

步骤 4：创建 PdfCanvas 对象

使用 PdfDocument 类的 addNewPage() 方法创建一个新的 PdfPage 类。

通过将上面创建的 PdfPage 对象传递给此类的构造函数来实例化包 com.itextpdf.kernel.pdf.canvas 的 PdfCanvas 对象，如下所示。

// 创建新页面
PdfPage pdfPage = pdfDoc.addNewPage();

// 创建 PdfCanvas 对象
PdfCanvas canvas = new PdfCanvas(pdfPage);

步骤 5：绘制线条

使用 Canvas 类的 moveTO() 方法设置线条的起始点，如下所示。

// 线条的起始点
canvas.moveTo(100, 300);

现在，使用 lineTo() 方法从此点绘制一条线到另一个点，如下所示。

// 绘制线条
canvas.lineTo(500, 300);

步骤 6：关闭文档

使用 Document 类的 close() 方法关闭文档，如下所示。

// 关闭文档
document.close();

示例

以下 Java 程序演示如何使用 iText 库在 PDF 文档中绘制一条线。它创建一个名为 drawingLine.pdf 的 PDF 文档，在其中绘制一个圆弧，并将其保存在路径 C:/itextExamples/

将此代码保存在名为 DrawingLine.java 的文件中。

import com.itextpdf.kernel.pdf.PdfDocument; 
import com.itextpdf.kernel.pdf.PdfPage; 
import com.itextpdf.kernel.pdf.PdfWriter; 
import com.itextpdf.kernel.pdf.canvas.PdfCanvas; 
import com.itextpdf.layout.Document;  

public class DrawingLine {     
   public static void main(String args[]) throws Exception {            
        // 创建 PdfWriter
        String dest = "C:/itextExamples/drawingLine.pdf";
        PdfWriter writer = new PdfWriter(dest);
        
        // 创建 PdfDocument 对象
        PdfDocument pdfDoc = new PdfDocument(writer);
        
        // 创建 Document 对象
        Document doc = new Document(pdfDoc);
        
        // 创建新页面
        PdfPage pdfPage = pdfDoc.addNewPage();
        
        // 创建 PdfCanvas 对象
        PdfCanvas canvas = new PdfCanvas(pdfPage);
        
        // 线的起始点
        canvas.moveTo(100, 300);
        
        // 绘制线
        canvas.lineTo(500, 300);
        
        // 关闭路径描边
        canvas.closePathStroke();
        
        // 关闭文档
        doc.close();
        
        System.out.println("对象在 pdf 上绘制成功");        
   }     
}

使用以下命令从命令提示符编译并执行保存的 Java 文件 −

javac DrawingLine.java 
java DrawingLine

执行后，上述程序将创建一个 PDF 文档，并显示以下消息。

对象在 pdf 上绘制成功

验证指定的路径，可以找到创建的PDF文档，如下所示。