النماذج التفاعلية

تظهر هذه الدورة كيفية إنشاء وإدارة حقول AcroForm في مستندات PDF باستخدام Aspose.PDF FOSS for Java . سوف تتعلم إضافة أزرار الراديو والصناديق الاختيارية وحقول النص وصنادق التجميع وجداول القائمة واسترداد قيم الحقل المقدمة.

واجهة برمجة التطبيقات AcroForm API

المجلس الوزاري Form الدرجة، يمكن الوصول إليها عبر: Document.getForm(),، يدير جميع حقول AcroForm في يتم إضافة الحقول عن طريق استدعاء المستند. Form.add(field, pageNumber).

RadioButtonField

إنشاء مجموعة من أزرار الراديو، كل خيار في خاصته Rectangle.كل خيار هو مع ملصق و مربع تحديد. اتصل setValue() اختيار إختيار مسبق:

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() يختار خيار برمجياً. getValue() يعيد المعادلة الحالية اسم الخيار المختار.

CheckboxField

CheckboxField يمثل حقل إدخال بولي واحد في نموذج PDF. Set setChecked(true) لتجعل الحقل معين الافتراضي. إضافته إلى النموذج في رقم الصفحة المحدد (مؤشر واحد):

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 يقبل إدخال النص الحر. حدد قيمة افتراضية مع setValue() و سجل الحقل مع النموذج قبل حفظه:

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");
}

حقل ComboBox و ListBoxField

ComboBoxField و ListBoxField يقدم قائمة خيارات قابلة للاختيار. خيارات الخياارات عبر addOption() ويكشفوا getValue() لاسترداد الاختيار.

FormEditor

FormEditor هي فئة واجهة للعمل مع حقل AcroForm. ربط وثيقة مع bindPdf(), تطبيق التغييرات, ثم الاتصال save().

قراءة قيم الحقل

بعد تحميل النموذج المملوء، استعادة القيمة الحالية للحقل المسمى عن طريق الاتصال doc.getForm().get(name) والصب إلى نوع الحقل الخرساني:

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