PdfExportOptions.PdfACompatibility Property

Specifies document compatibility with the PDF/A specification.

Namespace: DevExpress.XtraPrinting

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

Declaration

C#

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

VB.NET

<DefaultValue(PdfACompatibility.None)>
<XtraSerializableProperty>
Public Property PdfACompatibility As PdfACompatibility

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.
PdfA1b	The document supports the PDF/A-1b (ISO 19005-1) specification.
PdfA2b	The document supports the PDF/A-2b (ISO 19005-2:2011) specification.
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.

• PdfExportOptions.PdfACompatibility
• PdfExportOptions.AdditionalMetadata

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.