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

Question

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

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

我用于测试的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

我使用的是iText7.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());
}

（SetButtonImageTestTestSetImageToButtonWithmanyVisualizationsWorld）

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

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