PdfExportOptions.PdfACompatibility Property

Specifies document compatibility with the PDF/A specification.

Namespace: DevExpress.XtraPrinting

Assembly: DevExpress.Printing.v21.1.Core.dll

Declaration

[DefaultValue(PdfACompatibility.None)]
public PdfACompatibility PdfACompatibility { get; set; }

Property Value

Type Default Description
PdfACompatibility

None

A PdfACompatibility enumeration value.

Available values:

Name Description
None

The document is not PDF/A-compatible and supports the ISO 32000-1:2005 specification.

PdfA1a

The document supports the PDF/A-1a (Accessible) specification and contains tags that assistive technologies can use.

PdfA1b

The document supports the PDF/A-1b (ISO 19005-1) specification.

PdfA2a

The document supports the PDF/A-2a (Accessible) specification and contains tags that assistive technologies can use.

PdfA2b

The document supports the PDF/A-2b (ISO 19005-2:2011) specification.

PdfA3a

The document supports the PDF/A-3a (Accessible) specification and contains tags that assistive technologies can use.

PdfA3b

The document supports the PDF/A-3b (ISO 19005-3:2012) specification.

Property Paths

You can access this nested property as listed below:

Library Object Type Path to PdfACompatibility
Cross-Platform Class Library ExportOptions
.Pdf.PdfACompatibility
WinForms Controls DiagramOptionsExport
.PdfExportOptions.PdfACompatibility
WPF Controls DiagramControl
.PdfExportOptions.PdfACompatibility
DiagramDesignerControl
.PdfExportOptions.PdfACompatibility
ExportOptionsContainer
.Pdf.PdfACompatibility

Remarks

The following PDF/A specifications are supported.

  • PDF/A-1b (ISO 19005-1)
  • PDF/A-2b (ISO 19005-2:2011)
  • PDF/A-3b (ISO 19005-3:2012)

To make a document compatible with the PDF/A specification, use the following options.

If the PdfExportOptions.PdfACompatibility property is set to PdfACompatibility.None (the default value), the resulting document will conform to the ISO 32000-1:2005 standard without any restrictions.

For a code sample, refer to the following example online: How to export a report to ZUGFeRD.

For the current versions of the library, consider the following restrictions associated with PDF/A compatibility.

  • All PDF/A versions implicitly prohibit encryption.
  • All fonts that are used in PDF/A documents should be embedded.
  • The PDF/A-1b and PDF/A-2b standards do not support attachments.
  • The PDF/A-1b standard does not support transparency, and the alpha channel in images will be ignored.

To check the validity of PDF export options, use the PdfExportOptions.Validate method that returns a list of any detected inconsistencies.

See Also