iText7 8.0.0版本后如何设置现有PDF表单域背景为白色？

iText 8.x版本重构了表单域的API，表单域的外观属性（包括背景色）不再由PdfFormField直接管理，而是转移到其关联的**Widget注释（PdfWidgetAnnotation）**中。你可以通过以下步骤实现需求：

1. 加载目标PDF并获取表单对象
2. 遍历所有表单域，获取每个域对应的Widget注释集合
3. 对每个Widget注释设置背景色为白色或透明
4. 按需执行扁平化操作

代码示例（Java） #

import com.itextpdf.kernel.colors.ColorConstants;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfReader;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.forms.PdfAcroForm;
import com.itextpdf.forms.fields.PdfFormField;
import com.itextpdf.kernel.pdf.annot.PdfWidgetAnnotation;

import java.io.IOException;
import java.util.List;

public class ModifyFormBackground {
    public static void main(String[] args) throws IOException {
        String inputPath = "your-input.pdf";
        String outputPath = "your-output.pdf";

        try (PdfDocument pdfDoc = new PdfDocument(new PdfReader(inputPath), new PdfWriter(outputPath))) {
            PdfAcroForm acroForm = PdfAcroForm.getAcroForm(pdfDoc, true);
            if (acroForm == null) {
                return;
            }

            // 遍历所有表单域
            for (PdfFormField field : acroForm.getFormFields().values()) {
                List<PdfWidgetAnnotation> widgets = field.getWidgets();
                for (PdfWidgetAnnotation widget : widgets) {
                    // 设置背景为白色
                    widget.setBackgroundColor(ColorConstants.WHITE);
                    // 若要设置为透明，替换为：
                    // widget.setBackgroundColor(null);
                }
            }

            // 执行扁平化操作（按需选择）
            acroForm.flattenFields();
        }
    }
}

关键说明 #

• 设置透明背景时，直接向setBackgroundColor()传入null即可，原有背景色会被清除。
• 部分表单域可能关联多个Widget注释（如跨页显示的域），需确保遍历处理所有Widget，避免遗漏。
• 扁平化操作必须在修改背景色之后执行，否则背景色的修改不会被固化到静态内容中。

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