ConvertToPdfA Method

Description

Apply operations to convert a PDF document while satisfying PDF/A-1b compliance. Automatic fix-ups are applied if possible, conversion failure is raised as an exception.

Note: PDF/A compliance is not guaranteed if changes are made to the PDF document after conversion has succeeded.

Syntax

Visual Basic
Public Sub ConvertToPdfA( _ ByVal options As ConvertOptions _ )

Parameters

options: Configures the conversion activities for a PDF document.

Remarks

Apply ISO 19005-1:2005 restrictions and prohibitions to convert a candidate PDF document to PDF/A.

If the candidate PDF document violates a restriction or prohibition, PDF Xpress may attempt to apply an automatic fix-up to satisfy compliance. If a detected violation is not fixed, then the conversion process will raise an exception that describes the nature of the failure.

PDF Xpress PDF/A conversion support is limited to new image-only PDFs. Image-only PDFs lack searchable text content, but require only honoring a subset of PDF/A-1b compliance rules. Consequently, converting a candidate PDF document to PDF/A-1b is guaranteed to fail if any of the following is true—

The candidate was opened from the file system or from memory.
Pages from another PDF document are inserted into the candidate.
XFDF is imported into the candidate.
A watermark is added to the candidate.

PDF/A compliance is not guaranteed if changes are made to the PDF document after conversion has succeeded.

Refer to ISO 19005-1:2005 Document management — Electronic document file format for long-term preservation — Part 1: Use of PDF 1.4 (PDF/A-1)

Specify a well-formed ICC profile using either a filename or a local memory buffer. The ICC profile filename will be ignored if a local memory buffer is provided.