java - iText 7 : Set image to button that appears multiple times

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-截至目前的快照)；您可以通过执行不带 acroForm.flattenFields() 行的代码并检查输出来验证这一点。

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

因此，您的用例

The button field appears multiple times in the document. I would like to set the image once at the field level, so that the image appears for every occurrence of the field.

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，这可以进行扁平化操作。

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