IForm

All Implemented Interfaces: com.aspose.ms.System.IDisposable, java.io.Closeable

public interface IForm extends System.IDisposable, Closeable

Class representing Acro form object.

Methods

MethodDescription
getSrcFileName()Gets source file name.
setSrcFileName(String value)Sets source file name.
setConvertTo(PdfFormat value)Sets PDF file format.
getDestFileName()Gets destination file name.
setDestFileName(String value)Sets destination file name.
getSrcStream()Gets source stream.
setSrcStream(InputStream value)Gets source stream.
getDestStream()Gets destination stream.
setDestStream(OutputStream value)Gets destination stream.
getFieldNames()Gets list of field names on the form.
getFormSubmitButtonNames()Gets all form submit button names.
getFieldFacade(String fieldName)Returns FrofmFieldFacade object containing all appearance attributes.
fillField(String fieldName, String fieldValue)Fills the field with a valid value according to a fully qualified field name.
fillField(String fieldName, int index)Fills the radio box field with a valid index value according to a fully qualified field name.
fillField(String fieldName, boolean beChecked)Fills the check box field with a boolean value.
getButtonOptionCurrentValue(String fieldName)Returns the current value for radio button option fields.
getButtonOptionValuesInternal(String fieldName)Gets the radio button option fields and related values based on the field name.
getButtonOptionValues(String fieldName)Gets the radio button option fields and related values based on the field name.
getField(String fieldName)Gets the field’s value according to its field name.
getFullFieldName(String fieldName)Gets the full field name according to its short field name.
getFieldLimit(String fieldName)Get the limitation of text field.
save()Saves the value of the filled fields and close the opened Pdf document.
close()Closes opened files without any changes.
flattenAllFields()Flattens all the fields.
flattenField(String fieldName)Flattens a specified field with the fully qualified field name.
fillBarcodeField(String fieldName, String data)Fill a barcode field according to its fully qualified field name.
importFdf(InputStream inputFdfStream)Imports the content of the fields from the fdf file and put them into the new pdf.
exportFdf(OutputStream outputFdfStream)Exports the content of the fields of the pdf into the fdf stream.
importXml(InputStream inputXmlStream)Imports the content of the fields from the xml file and put them into the new pdf.
exportXml(OutputStream outputXmlStream)Exports the content of the fields of the pdf into the xml stream.
importXfdf(InputStream inputXfdfStream)Imports the content of the fields from the xfdf(xml) file and put them into the new pdf.
exportXfdf(OutputStream outputXfdfStream)Exports the content of the fields of the pdf into the xml stream.
fillField(String fieldName, String[] fieldValues)Fill a field with multiple selections.Note: only for AcroForm List Box Field.
renameField(String fieldName, String newFieldName)Renames a field.
getRichText(String fieldName)Get a Rich Text field’s value, including the formattinf information of every character.
getSubmitFlags(String fieldName)Returns the submit button’s submission flags
getFieldType(String fieldName)Returns type of field.
getFieldFlag(String fieldName)Returns flags of the field.
fillImageField(String fieldName, String imageFileName)Pastes an image onto the existing button field as its appearance according to its fully qualified field name.
fillImageField(String fieldName, InputStream imageStream)Overloads function of FillImageField.
getDocument()Gets the document Form is working on.
importXml(InputStream inputXmlStream, boolean IgnoreFormTemplateChanges)Imports the content of the fields from the xml file and put them into the new pdf.
fillField(String fieldName, String value, boolean fitFontSize)FillField
getContentDisposition()Gets or sets how content will be stored when result of operation is stored into HttpResponse object.
setContentDisposition(int value)Sets how content will be stored when result of operation is stored into HttpResponse object.
getSaveOptions()Gets or sets save options when result is stored as HttpResponse.
setSaveOptions(SaveOptions value)Gets or sets save options when result is stored as HttpResponse.
getAttachmentName()Gets or sets name of attachment when result of operation is stored into HttpResponse objects as attachment.
setAttachmentName(String value)Sets name of attachment when result of operation is stored into HttpResponse objects as attachment.

getSrcFileName()

public abstract String getSrcFileName()

Gets source file name.


Form form = new com.aspose.pdf.Form();
 form.setSrcFileName("file.pdf");

Returns: java.lang.String - String object

setSrcFileName(String value)

public abstract void setSrcFileName(String value)

Sets source file name.

Parameters:

ParameterTypeDescription
valuejava.lang.StringString object

setConvertTo(PdfFormat value)

public abstract void setConvertTo(PdfFormat value)

Sets PDF file format. Result file will be saved in specified file format. If this property is not specified then file will be save in default PDF format without conversion.

Parameters:

ParameterTypeDescription
valuePdfFormatPdfFormat element

getDestFileName()

public abstract String getDestFileName()

Gets destination file name.

Returns: java.lang.String - String object

setDestFileName(String value)

public abstract void setDestFileName(String value)

Sets destination file name.


Form form = new com.aspose.pdf.Form();
 form.setDestFileName("file.pdf");

Parameters:

ParameterTypeDescription
valuejava.lang.StringString object

getSrcStream()

public abstract InputStream getSrcStream()

Gets source stream.

Returns: java.io.InputStream - InputStream object

setSrcStream(InputStream value)

public abstract void setSrcStream(InputStream value)

Gets source stream.


Form form = new com.aspose.pdf.Form();
 form.setSrcStream(new FileInputStream("source.pdf"));

Parameters:

ParameterTypeDescription
valuejava.io.InputStreamInputStream object

getDestStream()

public abstract OutputStream getDestStream()

Gets destination stream.

Returns: java.io.OutputStream - OutputStream object

setDestStream(OutputStream value)

public abstract void setDestStream(OutputStream value)

Gets destination stream.


Form form = new com.aspose.pdf.Form();
 form.DestStream = new FileInputStream("file.pdf");

Parameters:

ParameterTypeDescription
valuejava.io.OutputStreamOutputStream object

getFieldNames()

public abstract String[] getFieldNames()

Gets list of field names on the form.


Form form = new Form("PdfForm.pdf");
 String[] fields = form.getFieldNames();
 for (String field : fields)
 {
     System.out.println(field);
 }

Returns: java.lang.String[] - String[] object

getFormSubmitButtonNames()

public abstract String[] getFormSubmitButtonNames()

Gets all form submit button names.


Form form = new Form("PdfForm.pdf");
 String[] submits = form.getFormSubmitButtonNames();
 for (String btn : submits)
 {
     System.out.println(btn);
 }

Returns: java.lang.String[] - String[] object

getFieldFacade(String fieldName)

public abstract FormFieldFacade getFieldFacade(String fieldName)

Returns FrofmFieldFacade object containing all appearance attributes.


com.aspose.pdf.facades.Form form = new com.aspose.pdf.facades.Form("form.pdf"));
 FormFieldFacade field = form.getFieldFacade("field1");
 System.out.println("Color of field border: " + field.BorderColor);

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringName of field to read.

Returns: FormFieldFacade - FormFieldFacade object

fillField(String fieldName, String fieldValue)

public abstract boolean fillField(String fieldName, String fieldValue)

Fills the field with a valid value according to a fully qualified field name. Before filling the fields, every field’s names and its corresponding valid values must be known. Both the fields’ name and values are case sensitive. Please note that Facades supports only full field names and does not work with partial field names in contrast with Aspose.Pdf.Kit; For example if field has full name “Form.Subform.TextField” you should specify full name and not “TextField”. You can use FieldNames property to explore existing field names and search required field by its partial name.


Form form = new Form("PdfForm.pdf");
 form.fillField("FirstName", "John");
 form.fillField("LastName", "Smith");



 // how to search field by its partial name:
 Form form = new Form("input.pdf", "output.pdf");
 for (String fieldName : form.getFieldNames())
 {
     if (fieldName.endsWith("TextField"))
     {
 	System.out.println("Full name is: " + fieldName);
     }
 }

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe field’s name to be filled.
fieldValuejava.lang.StringThe field’s value which must be a valid value for some fields.

Returns: boolean - boolean value

fillField(String fieldName, int index)

public abstract boolean fillField(String fieldName, int index)

Fills the radio box field with a valid index value according to a fully qualified field name. Before filling the fields, only field’s name must be known. While the value can be specified by its index. Notice: Only be applied to Radio Box, Combo Box and List Box fields. Please note that Facades supports only full field names and does not work with partial field names in contrast with Aspose.Pdf.Kit; For example if field has full name “Form.Subform.ListBoxField” you should specify full name and not “ListBoxField”. You can use FieldNames property to explore existing field names and search required field by its partial name.


Form form = new Form("PdfForm.pdf");
 form.fillField("listboxField", 2);
 form.fillField("comboboxField", 2);
 form.fillField("radiobuttonField", 2);


 // how to search field by its partial name:
 Form form = new Form("input.pdf", "output.pdf");
 for (String fieldName : form.getFieldNames())
 {
     if (fieldName.endsWith("ListBoxField"))
     {
 	System.out.println("Full name is: " + fieldName);
     }
 }

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe field’s name to be filled.
indexintThe selected box’s index in the whole radio box group.

Returns: boolean - boolean value

fillField(String fieldName, boolean beChecked)

public abstract boolean fillField(String fieldName, boolean beChecked)

Fills the check box field with a boolean value. Notice: Only be applied to Check Box. Please note that Facades supports only full field names and does not work with partial field names in contrast with Aspose.Pdf.Kit; For example if field has full name “Form.Subform.CheckBoxField” you should specify full name and not “CheckBoxField”. You can use FieldNames property to explore existing field names and search required field by its partial name.


Form form = new Form("PdfForm.pdf");
 form.fillField("checkboxField", true);

 // how to search field by its partial name:
 Form form = new Form("input.pdf", "output.pdf");
 for (String fieldName : form.getFieldNames())
 {
     if (fieldName.endsWith("CheckBoxField"))
     {
 	System.out.println("Full name is: " + fieldName);
     }
 }

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe field’s name to be filled.
beCheckedbooleanA boolean flag: true means to check the box, while false to uncheck it..

Returns: boolean - boolean value

getButtonOptionCurrentValue(String fieldName)

public abstract String getButtonOptionCurrentValue(String fieldName)

Returns the current value for radio button option fields.


Form form = new Form("PdfForm.pdf");
 System.out.println(form.GetButtonOptionCurrentValue("btnField"));

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringField Name

Returns: java.lang.String - String value for the current radio group optino. See also GetButtonOptionValues

getButtonOptionValuesInternal(String fieldName)

public abstract System.Collections.Generic.Dictionary<String,String> getButtonOptionValuesInternal(String fieldName)

Gets the radio button option fields and related values based on the field name. This method has meaning for radio button groups.


Form form = new Form("PdfForm.pdf");
 java.util.Map values = form.getButtonOptionValues("Color");
 System.out.println(values.get("White").toString());
 System.out.println(values.get("Black").toString());

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringField Name

Returns: Dictionary - Hash table of option values keyed by form item name

getButtonOptionValues(String fieldName)

public abstract Hashtable<String,String> getButtonOptionValues(String fieldName)

Gets the radio button option fields and related values based on the field name. This method has meaning for radio button groups.


Form form = new Form("PdfForm.pdf");
 java.util.Map values = form.getButtonOptionValues("Color");
 System.out.println(values.get("White").toString());
 System.out.println(values.get("Black").toString());

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringField Name

Returns: java.util.Hashtable<java.lang.String,java.lang.String> - Hash table of option values keyed by form item name

getField(String fieldName)

public abstract String getField(String fieldName)

Gets the field’s value according to its field name.


Form form = new Form("PdfForm.pdf");
 System.out.println("Field value = " + form.getField("Field1"));

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe fully qualified field name.

Returns: java.lang.String - The field’s value.

getFullFieldName(String fieldName)

public abstract String getFullFieldName(String fieldName)

Gets the full field name according to its short field name.


Form form = new Form("PdfForm.pdf");
 System.out.println("Full field name is : " + form.getFullFieldName("textField"));

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe fully qualified field name.

Returns: java.lang.String - The full field name.

getFieldLimit(String fieldName)

public abstract int getFieldLimit(String fieldName)

Get the limitation of text field.


Form form = new Form("PdfForm.pdf");
 System.out.println(form.getFieldLimit("textfieldBox"));

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe qualified field name.

Returns: int - Return the limitation number of characters a text field can be filled. It not set, return 0.

save()

public abstract void save()

Saves the value of the filled fields and close the opened Pdf document.


Form form = new Form("PdfForm.pdf", "PdfForm_Changed.pdf");
 form.fillField("textField", "new value");
 form.save();

close()

public abstract void close()

Closes opened files without any changes.

flattenAllFields()

public abstract void flattenAllFields()

Flattens all the fields.


Form form = new Form("PdfForm.pdf");
 form.flattenAllFields();

flattenField(String fieldName)

public abstract void flattenField(String fieldName)

Flattens a specified field with the fully qualified field name. Any other field will remain Unchangeable. If the fieldName is invalid, all the fields will remain unchangeable.


Form form = new Form("PdfForm.pdf");
 form.flattenField("textField");

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe name of the field to be flattened.

fillBarcodeField(String fieldName, String data)

public abstract boolean fillBarcodeField(String fieldName, String data)

Fill a barcode field according to its fully qualified field name.


Form form = new Form("PdfForm.pdf");
 form.fillBarcodeField("textField", "42207252");

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe fully qualified field name.
datajava.lang.StringThe new barcode value.

Returns: boolean - If filling succeed, return true; otherwise, false.

importFdf(InputStream inputFdfStream)

public abstract void importFdf(InputStream inputFdfStream)

Imports the content of the fields from the fdf file and put them into the new pdf.


Form form = new Form("PdfForm.pdf", "PdfForm_imported.pdf");
 form.importFdf(new FileInputStream("data.fdf"));
 form.save();

Parameters:

ParameterTypeDescription
inputFdfStreamjava.io.InputStreamThe input fdf stream.

exportFdf(OutputStream outputFdfStream)

public abstract void exportFdf(OutputStream outputFdfStream)

Exports the content of the fields of the pdf into the fdf stream.


Form form = new Form("PdfForm.pdf");
 OutputStream stream = new FileOutputStream("export.fdf");
 form.exportFdf(stream);
 stream.close();

Parameters:

ParameterTypeDescription
outputFdfStreamjava.io.OutputStreamThe output fdf stream.

importXml(InputStream inputXmlStream)

public abstract void importXml(InputStream inputXmlStream)

Imports the content of the fields from the xml file and put them into the new pdf.


Form form = new Form("PdfForm.pdf", "Form_Imported.pdf");
 InputStream fs = new FileInputStream("import.xml");
 form.importXml(fs);
 form.save();

Parameters:

ParameterTypeDescription
inputXmlStreamjava.io.InputStreamInputStream object

exportXml(OutputStream outputXmlStream)

public abstract void exportXml(OutputStream outputXmlStream)

Exports the content of the fields of the pdf into the xml stream. The button field’s value will not be exported.


Form form = new Form("PdfForm.pdf"));
 OutputStream fs = new FileOutputStream("export.xml");
 form.exportXml(fs);
 fs.close();

Parameters:

ParameterTypeDescription
outputXmlStreamjava.io.OutputStreamOutputStream object

importXfdf(InputStream inputXfdfStream)

public abstract void importXfdf(InputStream inputXfdfStream)

Imports the content of the fields from the xfdf(xml) file and put them into the new pdf.


Form form = new Form("PdfForm.pdf", "Form_ImportXfdf.pdf");
 InputStream fs = new FileInputStream("export_old.xfdf");
 form.importXfdf(fs);
 fs.close();
 form.save();

Parameters:

ParameterTypeDescription
inputXfdfStreamjava.io.InputStreamThe input xfdf(xml) stream.

exportXfdf(OutputStream outputXfdfStream)

public abstract void exportXfdf(OutputStream outputXfdfStream)

Exports the content of the fields of the pdf into the xml stream. The button field’s value will not be exported.


Form form = new Form("PdfForm.pdf");
 OutputStream fs = new FileOutputStream("export.xfdf");
 form.exportXfdf(fs);
 fs.close();

Parameters:

ParameterTypeDescription
outputXfdfStreamjava.io.OutputStreamThe output xml stream.

fillField(String fieldName, String[] fieldValues)

public abstract void fillField(String fieldName, String[] fieldValues)

Fill a field with multiple selections.Note: only for AcroForm List Box Field.


Form form = new com.aspose.pdf.Form("PdfForm.pdf", "Form_Updated.pdf");
 form.fillField("ListBox1", new String[]
 { "Three", "One" });
 form.save();

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe fully qualified field name.
fieldValuesjava.lang.String[]A String array which contains several items to be selected.

renameField(String fieldName, String newFieldName)

public abstract void renameField(String fieldName, String newFieldName)

Renames a field. Either AcroForm field or XFA field is OK.


Form form = new Form("PdfForm.pdf", "PdfFormUpdated.pdf");
 form.renameField("field", "field1");
 form.save();

Parameters:

ParameterTypeDescription
fieldNamejava.lang.Stringthe old field name
newFieldNamejava.lang.Stringthe new field name

getRichText(String fieldName)

public abstract String getRichText(String fieldName)

Get a Rich Text field’s value, including the formattinf information of every character.


Form form = new Form("PdfForm.pdf");
 System.out.println(form.getRichText("txtDescriptionRTF"));

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe fully qualified field name of the Rich Text field.

Returns: java.lang.String - Return a String containing formatting information of the Rich Text field.

getSubmitFlags(String fieldName)

public abstract SubmitFormFlag getSubmitFlags(String fieldName)

Returns the submit button’s submission flags


Form form = new Form("PdfForm.pdf");
 System.out.println((form.getSubmitFlags("btnSubmit") | SubmitFormFlag.Xfdf != 0) ? " XFDF" : " ");
 // / System.out.println( ( form.getSubmitFlags("btnSubmit") | SubmitFormFlag.Fdf
 // != 0) ? " FDF" : " ");
 System.out.println((form.getSubmitFlags("btnSubmit") | SubmitFormFlag.Pdf != 0) ? " PDF" : " ");

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe qualified field name.

Returns: SubmitFormFlag - SubmitFormFlag element

getFieldType(String fieldName)

public abstract FieldType getFieldType(String fieldName)

Returns type of field.


Form form = new Form("PdfForm.pdf");
 if (form.GetFieldType("textField") == FieldType.Text)
 {
     System.out.println("Type of field is text");
 }

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringField name.

Returns: FieldType - Element of FileType enumeration corresponding to field type.

getFieldFlag(String fieldName)

public abstract int getFieldFlag(String fieldName)

Returns flags of the field.


Form form = new Form("PdfForm.pdf");
 if (form.getFieldFlag("textField") == ProptyFlag.ReadOnly)
 {
     System.out.println("Field is read-only");
 }

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringField name

Returns: int - Property flag (ReadOnly/ Required/NoExport

fillImageField(String fieldName, String imageFileName)

public abstract void fillImageField(String fieldName, String imageFileName)

Pastes an image onto the existing button field as its appearance according to its fully qualified field name.


Form form = new Form("PdfForm.pdf", "PdfForm_filled.pdf");
 form.fillImageField("fieldName", "file.jpg");
 form.save();

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe fully qualified field name of the image button field.
imageFileNamejava.lang.StringThe path of the image file, relative and absolute are both ok.

fillImageField(String fieldName, InputStream imageStream)

public abstract void fillImageField(String fieldName, InputStream imageStream)

Overloads function of FillImageField. The input is a image stream.


Form form = new Form("PdfForm.pdf", "PdfForm_filled.pdf");
 form.fillImageField("fieldName", new FileInputStream("file.jpg"));

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringThe fully qualified field name.
imageStreamjava.io.InputStreamThe image’s stream.

getDocument()

public abstract IDocument getDocument()

Gets the document Form is working on.

Returns: IDocument - IDocument object

importXml(InputStream inputXmlStream, boolean IgnoreFormTemplateChanges)

public abstract void importXml(InputStream inputXmlStream, boolean IgnoreFormTemplateChanges)

Imports the content of the fields from the xml file and put them into the new pdf.

Parameters:

ParameterTypeDescription
inputXmlStreamjava.io.InputStreamThe input xml stream.
IgnoreFormTemplateChangesbooleanIf this parameter is true then all changes of the XFA form template will not be saved

fillField(String fieldName, String value, boolean fitFontSize)

public abstract boolean fillField(String fieldName, String value, boolean fitFontSize)

FillField

Parameters:

ParameterTypeDescription
fieldNamejava.lang.StringName of field
valuejava.lang.StringNew value of the field
fitFontSizebooleanIf true, the font size in the edit boxes will be fitted.

Returns: boolean - boolean value

getContentDisposition()

public abstract int getContentDisposition()

Gets or sets how content will be stored when result of operation is stored into HttpResponse object. Possible value: inline / attachment. Default: inline.

Returns: int - ContentDisposition element

setContentDisposition(int value)

public abstract void setContentDisposition(int value)

Sets how content will be stored when result of operation is stored into HttpResponse object. Possible value: inline / attachment. Default: inline.

Parameters:

ParameterTypeDescription
valueintContentDisposition element

getSaveOptions()

public abstract SaveOptions getSaveOptions()

Gets or sets save options when result is stored as HttpResponse. Default value: PdfSaveOptions.

Returns: SaveOptions - SaveOptions object

setSaveOptions(SaveOptions value)

public abstract void setSaveOptions(SaveOptions value)

Gets or sets save options when result is stored as HttpResponse. Default value: PdfSaveOptions.

Parameters:

ParameterTypeDescription
valueSaveOptionsSaveOptions object

getAttachmentName()

public abstract String getAttachmentName()

Gets or sets name of attachment when result of operation is stored into HttpResponse objects as attachment.

Returns: java.lang.String - string object

setAttachmentName(String value)

public abstract void setAttachmentName(String value)

Sets name of attachment when result of operation is stored into HttpResponse objects as attachment.

Parameters:

ParameterTypeDescription
valuejava.lang.StringString object