XRLabel.AccessibleRole Property
Specifies the role of XRLabel
and XRTableCell
in the exported PDF document. This value is used by assistive technologies.
Namespace: DevExpress.XtraReports.UI
Assembly: DevExpress.XtraReports.v24.2.dll
NuGet Package: DevExpress.Reporting.Core
#Declaration
[Browsable(true)]
public override XRAccessibleRole AccessibleRole { get; set; }
#Property Value
Type | Description |
---|---|
XRAccessible |
The value that defines the |
Available values:
Name | Description |
---|---|
Default | Applies no semantic meaning to the UI element. |
Heading1 | Applies “level one heading” meaning to an |
Heading2 | Applies “level two heading” meaning to an |
Heading3 | Applies “level three heading” meaning to an |
Heading4 | Applies “level four heading” meaning to an |
Heading5 | Applies “level five heading” meaning to an |
Heading6 | Applies “level six heading” meaning to an |
Table | Applies “table” meaning to an |
Table |
Applies “header row” meaning to an |
Table |
Applies “header cell” meaning to an |
#Remarks
You can specify how XRLabel
and XRTableCell
should be treated by screen readers in the exported PDF document.
#Define XRLabel Accessible Role
Set the control’s AccessibleRole
property to Heading1
- Heading6
before you export a report.
Set the PdfExportOptions.PdfUACompatibility property to PdfUA1
to conform the exported PDF document to PDF/UA specification. Then, export the report to PDF format.
The image below shows the result. XRLabel.AccessibleRole
is set to Heading2
, and the screen reader treats XRLabel
as a “level two” heading in the exported document:
#Define XRTableCell Accessible Role
Before you export a report, set the XRTable
‘s AccessibleRole
property to Table
to define a control as a table. Then, specify the XRTableCell.AccessibleRole
property:
Note
Accessible
is not in effect for cells merged with the XRTable
Set the PdfExportOptions.PdfUACompatibility property to PdfUA1
to conform the exported PDF document to PDF/UA specification. Then, export the report to PDF format.
The image below shows the result. XRTableCell.AccessibleRole
is set to TableHeaderCell
, and the screen reader treats XRTableCell
with “Bill to:” text as a header cell in the exported document: