PdfExportOptions.PdfACompatibility Property
Specifies document compatibility with the PDF/A specification.
Namespace: DevExpress.XtraPrinting
Assembly: DevExpress.Printing.v23.2.Core.dll
NuGet Package: DevExpress.Printing.Core
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.
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the PdfACompatibility property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.