GroupField Class

A logical group of related PDF form fields.

Declaration

public class GroupField extends FormField

Remarks

The following code snippet creates and groups text fields:

import com.devexpress.docs.pdf.*;
import com.devexpress.system.drawing.*;
import com.devexpress.drawing.printing.DXPaperKind;

import java.nio.channels.*;
import java.nio.file.*;

public class Main {
    public static void main(String[] args) throws Exception {
        try (PdfDocument pdfDocument = new PdfDocument()) {
            // Add an A4 page to the document.
            Page page = pdfDocument.getPages().add(DXPaperKind.A4);

            // Create text fields.
            TextBoxField firstNameField = new TextBoxField("FirstName");
            TextBoxField lastNameField = new TextBoxField("LastName");

            firstNameField.setValue("John");
            lastNameField.setValue("Doe");

            TextBoxWidgetAnnotation widget1 =
                    new TextBoxWidgetAnnotation(
                        firstNameField,
                        new RectangleF(120, 720, 220, 20));
            page.getAnnotations().add(widget1);

            RectangleF bounds = new RectangleF(120, 720, 220, 20);
            TextBoxWidgetAnnotation widget2 =
                    new TextBoxWidgetAnnotation(
                            lastNameField,
                            new RectangleF(120, 690, 220, 20));
            page.getAnnotations().add(widget2);

            // Create a group.
            GroupField group = new GroupField("Contact");

            // Add fields to the group.
            group.getKids().add(firstNameField);
            group.getKids().add(lastNameField);

            // Add the group to the document.
            pdfDocument.getFields().add(group);

            // Save the document.
            try (WritableByteChannel channel =
                     FileChannel.open(Path.of("result.pdf"),
                         StandardOpenOption.CREATE,
                         StandardOpenOption.WRITE,
                         StandardOpenOption.TRUNCATE_EXISTING)) {

                pdfDocument.save(channel);
            }
        }
    }
}

Refer to the following help topic for additional information: Group Form Fields.