xtrareports-devexpress-dot-xtrareports-dot-ui-dot-xrbarcode-e115d87b.md
Specifies the control’s accessible role in the exported PDF document. This value is used by assistive technologies.
Namespace : DevExpress.XtraReports.UI
Assembly : DevExpress.XtraReports.v25.2.dll
NuGet Package : DevExpress.Reporting.Core
[Browsable(true)]
public override XRAccessibleRole AccessibleRole { get; set; }
<Browsable(True)>
Public Overrides Property AccessibleRole As XRAccessibleRole
| Type | Description |
|---|---|
| XRAccessibleRole |
The value that defines the XRBarCode role.
|
Available values:
Show 13 items
| Name | Description |
|---|---|
| Default |
Applies default semantic meaning based on element type.
| | Heading1 |
Applies “level one heading” meaning to an XRLabel.
| | Heading2 |
Applies “level two heading” meaning to an XRLabel.
| | Heading3 |
Applies “level three heading” meaning to an XRLabel.
| | Heading4 |
Applies “level four heading” meaning to an XRLabel.
| | Heading5 |
Applies “level five heading” meaning to an XRLabel.
| | Heading6 |
Applies “level six heading” meaning to an XRLabel.
| | Table |
Applies “table” meaning to an XRTable.
| | TableHeaderRow |
Applies “header row” meaning to an XRTableRow.
| | TableHeaderCell |
Applies “header cell” meaning to an XRTableCell.
| | Decorative |
Applies “decorative” semantic meaning to an XRShape, XRPictureBox, XRZipCode, or XRBarCode.
| | Figure |
Applies “figure” semantic meaning to an image watermark (XRWatermark).
| | Paragraph |
Applies “paragraph” semantic meaning to a text watermark (XRWatermark).
|
Use the AccessibleRole property to specify how screen readers treat the XRBarCode control in exported PDF documents. You can change the value to Decorative or keep the default value of Figure.
A decorative element, known as an artifact , is not part of a PDF document’s logical structure. Artifacts do not appear in the tag tree and are excluded from the document’s main content.
Note
Do not exclude elements that carry meaning, use this tag only for decorative elements.
Before you export your report, set the PdfExportOptions.PdfUACompatibility property to PdfUA1 to make the document PDF/UA compatible.
The image below shows the result. XRBarCode.AccessibleRole is set to Decorative, and the screen reader treats XRBarCode as an artifact in the exported document:
The AccessibleDescription property is not in effect for artifacts.
See Also