使用Apache PDFBox为PDF页面中的矩形框添加滚动条可行吗？

PDF本身是静态文档，原生绘制的矩形不支持滚动交互。要实现带滚动条的内容框，你需要利用PDF的交互式AcroForm文本域——这是PDF阅读器支持的标准交互元素，Apache PDFBox可以直接创建这类组件。

实现步骤 #

• 初始化AcroForm：获取或创建PDF文档的AcroForm实例，它是存放交互控件的容器
• 创建可滚动文本域：使用PDTextField创建文本域，开启多行和滚动属性
• 配置域的位置与样式：将文本域的位置、大小设置为你原本的矩形框参数，还可自定义边框、背景等外观
• 填充内容：向文本域中添加内容，当内容高度超过域的显示区域时，阅读器会自动显示滚动条

代码示例 #

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.common.PDRectangle;
import org.apache.pdfbox.pdmodel.interactive.form.PDAcroForm;
import org.apache.pdfbox.pdmodel.interactive.form.PDTextField;

import java.io.IOException;

public class ScrollableTextBox {
    public static void main(String[] args) throws IOException {
        try (PDDocument document = new PDDocument()) {
            PDPage page = new PDPage(PDRectangle.A4);
            document.addPage(page);

            // 初始化AcroForm容器
            PDAcroForm acroForm = new PDAcroForm(document);
            document.getDocumentCatalog().setAcroForm(acroForm);

            // 创建可滚动文本域
            PDTextField scrollableField = new PDTextField(acroForm);
            scrollableField.setPartialName("scrollableContent");
            // 开启多行显示与滚动属性
            scrollableField.setMultiline(true);
            scrollableField.setScrollable(true);

            // 设置文本域的位置和大小（对应目标矩形框：x=100, y=400, 宽300, 高200）
            PDRectangle fieldRect = new PDRectangle(100, 400, 300, 200);
            scrollableField.getWidgets().get(0).setRectangle(fieldRect);

            // 绘制文本域边框（可选）
            PDPageContentStream contentStream = new PDPageContentStream(document, page);
            contentStream.addRect(fieldRect.getLowerLeftX(), fieldRect.getLowerLeftY(), fieldRect.getWidth(), fieldRect.getHeight());
            contentStream.setStrokingColor(0, 0, 0);
            contentStream.stroke();
            contentStream.close();

            // 填充超长测试内容
            StringBuilder longContent = new StringBuilder();
            for (int i = 1; i <= 50; i++) {
                longContent.append("这是第").append(i).append("行测试内容，用于演示滚动效果。\n");
            }
            scrollableField.setValue(longContent.toString());

            // 将文本域加入AcroForm
            acroForm.getFields().add(scrollableField);

            document.save("scrollable_box.pdf");
        }
    }
}

注意事项 #

• 滚动功能依赖PDF阅读器的交互支持，必须用支持AcroForm的阅读器（如Adobe Acrobat、Foxit Reader）打开，纯静态视图（如打印、图片导出）无法显示滚动条
• 若需要自定义字体、文本对齐等样式，可通过PDAppearanceContentStream手动绘制文本域的外观
• 文本域的滚动是阅读器原生实现的，PDFBox仅负责创建符合标准的交互控件，无法控制阅读器的滚动行为细节

内容的提问来源于stack exchange，提问作者Kiran