iText 7：将图像设置为多次出现的按钮

Question

我有一个带有按钮字段的简单 PDF，我想用图像填充。

按钮字段在文档中出现多次。我想在字段级别设置一次图像，以便每次出现该字段时都会显示图像。

The PDF 用于测试。

失败的代码：

ByteArrayOutputStream outStr = new ByteArrayOutputStream();

PdfDocument pdfDocument = new PdfDocument(new PdfReader(pdfStr), new PdfWriter(outStr));
PdfAcroForm acroForm = PdfAcroForm.getAcroForm(pdfDocument, false);

PdfButtonFormField button = (PdfButtonFormField) acroForm.getField("image");
button.setImage("src/test/resources/my_image.png");

acroForm.flattenFields();

pdfDocument.close();

抛出的异常：

com.example.documents.DocumentServiceException: Fail to render form
    at com.example.ITEXTTests.test(ITEXTTests.java:100)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:498)
    at org.junit.runners.model.FrameworkMethod$1.runReflectiveCall(FrameworkMethod.java:50)
    at org.junit.internal.runners.model.ReflectiveCallable.run(ReflectiveCallable.java:12)
    at org.junit.runners.model.FrameworkMethod.invokeExplosively(FrameworkMethod.java:47)
    at org.junit.internal.runners.statements.InvokeMethod.evaluate(InvokeMethod.java:17)
    at org.junit.runners.ParentRunner.runLeaf(ParentRunner.java:325)
    at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:78)
    at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:57)
    at org.junit.runners.ParentRunner$3.run(ParentRunner.java:290)
    at org.junit.runners.ParentRunner$1.schedule(ParentRunner.java:71)
    at org.junit.runners.ParentRunner.runChildren(ParentRunner.java:288)
    at org.junit.runners.ParentRunner.access$000(ParentRunner.java:58)
    at org.junit.runners.ParentRunner$2.evaluate(ParentRunner.java:268)
    at org.junit.runners.ParentRunner.run(ParentRunner.java:363)
    at org.eclipse.jdt.internal.junit4.runner.JUnit4TestReference.run(JUnit4TestReference.java:86)
    at org.eclipse.jdt.internal.junit.runner.TestExecution.run(TestExecution.java:38)
    at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:459)
    at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:678)
    at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.run(RemoteTestRunner.java:382)
    at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.main(RemoteTestRunner.java:192)
Caused by: java.lang.IllegalArgumentException
    at com.itextpdf.layout.element.Text.<init>(Text.java:69)
    at com.itextpdf.layout.element.Paragraph.<init>(Paragraph.java:80)
    at com.itextpdf.forms.fields.PdfFormField.drawButton(PdfFormField.java:3226)
    at com.itextpdf.forms.fields.PdfFormField.drawPushButtonAppearance(PdfFormField.java:3199)
    at com.itextpdf.forms.fields.PdfFormField.regenerateField(PdfFormField.java:2106)
    at com.itextpdf.forms.PdfAcroForm.flattenFields(PdfAcroForm.java:661)
    at com.example.ITEXTTests.test(ITEXTTests.java:98)
    ... 23 more

我使用的是 iText 7.1.4（最新的 7.x 版本）。

Answer 1

实际问题不是扁平化（7.1.4 出现异常；当前 7.1.5-SNAPSHOT 不再出现此异常），值设置已经失败（7.1.4 和 7.1 .5-SNAPSHOT 截至目前）；您可以通过执行不带acroForm.flattenFields() 行的代码并检查输出来验证这一点。

实际上，PdfFormField.regenerateField()（在设置字段值时调用）的当前实现似乎不支持具有多个小部件的字段，特别是在按钮字段的上下文中（但也适用于其他字段类型）它假定抽象表单字段对象和它的小部件被合并（只有一个小部件的字段才有可能），无论是从它检索信息还是向它添加生成的外观。

因此，您的用例

按钮字段在文档中出现多次。我想在字段级别设置一次图像，以便每次出现该字段时都会显示图像。

iText 7 尚不支持，至少在当前的 7.1.5-SNAPSHOT 版本中不支持。

---

一种解决方法是替换

button.setImage("src/test/resources/my_image.png");

通过

ImageData img = ImageDataFactory.create("src/test/resources/my_image.png");
PdfImageXObject imgXObj = new PdfImageXObject(img);
List<PdfWidgetAnnotation> widgets = button.getWidgets();
for (PdfWidgetAnnotation widget : widgets) {
    Rectangle rectangle = widget.getRectangle().toRectangle();
    PdfFormXObject xObject = new PdfFormXObject(rectangle);
    PdfCanvas canvas = new PdfCanvas(xObject, pdfDocument);
    canvas.addXObject(imgXObj, rectangle.getWidth(), 0, 0, rectangle.getHeight(), rectangle.getLeft(), rectangle.getBottom());
    widget.setNormalAppearance(xObject.getPdfObject());
}

(SetButtonImage 测试testSetImageToButtonWithManyVisualizationsWorkAround)

在下面使用当前的 7.1.5-SNAPSHOT，这包括展平。

请注意，这并不是对缺少对多小部件按钮的支持的完美修复，代码忽略了很多设置（例如按钮的边框和图像周围的边框宽度）并且可能会意外拉伸图像方法。此外，它仅针对您的示例 PDF 进行测试。因此，它实际上只能作为临时解决方法。