Formularis interactius

Aquesta guia mostra com crear i gestionar camps d’AcroForm en documents PDF utilitzant Aspose.PDF FOSS per Java. Aprendrà a afegir botons de ràdio, caselles de marcació, camps de text, cases combinades i caixes de llista, i recuperar els valors dels camps enviats.

API d’AcroForm

El Form classe, accessible a través de Document.getForm(), gestiona tots els camps d’AcroForm en el sistema de dades. Els camps s’afegeixen cridant a la pàgina de l’entitat. Form.add(field, pageNumber).

RadioButtonField

Crear un grup de botons de ràdio, cada opció per a si mateixa Rectangle.Cada opció és: afegit amb una etiqueta i un quadre de limitació. setValue() per a seleccionar prèviament una opció:

try (Document doc = new Document()) {
    PageCollection pages = doc.getPages();
    Page page = pages.add();
    RadioButtonField radio = new RadioButtonField(page);
    radio.setPartialName("color");
    radio.addOption("Red", new Rectangle(50, 50, 70, 70));
    radio.addOption("Blue", new Rectangle(50, 80, 70, 100));
    doc.getForm().add(radio, 1);
    radio.setValue("Red");
    doc.save("form.pdf");
}

setValue() selecciona una opció programàticament. getValue() Retorna el valor actual. nom de l’opció seleccionada.

CheckboxField

CheckboxField representa un sol camp d’entrada booleana en el formulari PDF. Set setChecked(true) Per fer que el camp sigui comprovat per defecte. A més, afegir-lo al formulari en un número de pàgina (1-indexat):

try (Document doc = new Document()) {
    PageCollection pages = doc.getPages();
    Page page = pages.add();
    CheckboxField cb = new CheckboxField(page, new Rectangle(100, 100, 120, 120));
    cb.setPartialName("agree");
    cb.setChecked(true);
    doc.getForm().add(cb, 1);
    doc.save("form.pdf");
}

TextBoxField

TextBoxField accepta la entrada de text en forma lliure. Configurar un valor predeterminat amb setValue() i de la registrar el camp amb el formulari abans d’emmagatzemar:

try (Document doc = new Document()) {
    PageCollection pages = doc.getPages();
    Page page = pages.add();
    TextBoxField text = new TextBoxField(page, new Rectangle(50, 200, 250, 220));
    text.setPartialName("name");
    text.setValue("Default text");
    doc.getForm().add(text, 1);
    doc.save("form.pdf");
}

Camp ComboBox i camp ListBox

ComboBoxField i de la ListBoxField presentant llistes d’opcions seleccionables. opcions de cadena via addOption() i exposar getValue() per recuperar la selecció.

FormEditor

FormEditor és una classe de façana per treballar amb camps d’AcroForm. Unir un document amb: bindPdf(), aplicar canvis, després trucar save().

Llegir valors de camp

Després de carregar un formulari omplert, recuperar el valor actual d’un camp nomenat trucant doc.getForm().get(name) i la cocció al tipus de camp de formigó:

try (Document doc = new Document("form.pdf")) {
    RadioButtonField radio = (RadioButtonField) doc.getForm().get("color");
    String selected = radio.getValue();
    System.out.println("Selected: " + selected);
}