PdfExportOptions.PdfACompatibility Property
Specifies document compatibility with the PDF/A specification.
Namespace: DevExpress.XtraPrinting
Assembly: DevExpress.Printing.v22.2.Core.dll
NuGet Packages: DevExpress.Printing.Core, DevExpress.Win.Dashboard.Design
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 |
|
| WinForms Controls | DiagramOptionsExport |
|
| WPF Controls | DiagramControl |
|
Remarks
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-1 and PDF/A-2 standards do not support attachments.
- The PDF/A-1 standard does not support transparency, and the alpha channel in images is ignored.
To check the validity of PDF export options, use the PdfExportOptions.Validate method that returns a list of any detected inconsistencies.