XFDF
-
Concrete implementation of the
PSPDFAnnotationProvider
protocol that uses a XFDF file as a source.The XFDF file needs to be local and in a writable location, not on a web server. This annotation provider handles data form fields according to the XFDF spec: “An XFDF file with form data contains form field names and values. When importing XFDF into Acrobat, the target PDF file must already contain the form fields. Importing XFDF updates the form field values in the PDF file. Exporting to XFDF puts the current value of the field in the value element. Using XFDF, it is not possible to create a new form field in a PDF document, or change anything other than the value of an existing form field.” It compliments an existing data form fields from PDF with values from the XFDF file. If data form field value is not found in the XFDF file it will be served by this provider with the default value.
If you use XFDF to fill out form elements, you will want to keep both the file annotation provider and the xfdf provider around, using following order: annotationProviders = [xfdfProvider, fileProvider]. Without the fileProvider, form elements will not be found. (In versions of PSPDFKit earlier than 7.5, we did that somewhat magically. This requirement has now been made explicit.)
Note
Requires the
Features.annotationEditing
feature flag.Note
If an error occurs when attaching a parsed annotation a document, the error is logged and the annotation is skipped.
Warning
If the XFDF contains annotations with page indicies beyond the length of the document, then warnings will be logged and those annotations will be skipped.
Declaration
Objective-C
@interface PSPDFXFDFAnnotationProvider : PSPDFContainerAnnotationProvider
Swift
class XFDFAnnotationProvider : PDFContainerAnnotationProvider
-
Parses an XML in the XFDF standard. http://partners.adobe.com/public/developer/en/xml/XFDF_Spec_3.0.pdf
See moreDeclaration
Objective-C
@interface PSPDFXFDFParser : NSObject
Swift
class XFDFParser : NSObject
-
Writes an XML in XFDF standard from PSPDFKit annotations. http://partners.adobe.com/public/developer/en/xml/XFDF_Spec_3.0.pdf
See moreDeclaration
Objective-C
@interface PSPDFXFDFWriter : NSObject
Swift
class XFDFWriter : NSObject