xtrareports-404960-desktop-reporting-common-features-accessibility-winforms-document-viewer-accessibility.md
| Accessibility Requirement | Support Level |
|---|---|
| Keyboard Navigation Support | |
| Screen Reader Support | |
| Contrast Color Theme |
- all component features meet the requirement
- component features partially meet the requirement
The WinForms Document Viewer component complies with Section 508 and WCAG 2.x standards criteria. We have not encountered any issues other than the following:
| Section 508 criteria | WCAG 2.x criteria | Exception description |
|---|---|---|
| 1.3.1 Info and Relationships | In the Document Page area, assistive technology cannot programmatically determine which column header is associated with a specific cell. | |
| 1.3.2 Meaningful Sequence | The reading sequence is determined by the order in which visual elements of the document (bricks) are created when a report is processed. This order may not correspond to the visual order on the page. | |
| 2.1.2 No Keyboard Trap | Focus in Parameters or Document Map panels cannot be moved away using arrow or tab keys. A user must press the Esc key to switch to the Document Page area, but users are advised against the use of this method to move focus away. | |
| 3.1.1 Language of Page | The component does not expose UI language information to assistive technologies. A developer can specify a language in the page that contains the component. |
A user can use the following keys to interact with the Document Viewer:
| Key | Action |
|---|---|
| Tab | Navigates between the Document area, breadcrumbs in drill-through reports, Search panel, Parameters panel, Document Map panel. Navigates between Ribbon items. Navigates between elements in the Parameters, Search, and Document Map panels. |
| Narrator + Left/Right Arrow | Moves between Ribbon command items. Navigates within the contents of a document page when you move the focus to a document page. Moves between editors in the Document Map and Export panels. Selects an item in drop-down boxes. |
| Esc | Moves focus to a document page. |
| Space | Triggers an action when a command item is selected in the Ribbon. |
WinForms Document Viewer supports screen readers and complies to WAI-ARIA standards. Exceptions are listed in the Accessibility Standards Compliance topic section.
Use the DevExpress High Contrast or The Bezier Skin to improve readability. Review the following help topic for information on DevExpress WinForms application skins: WinForms Skins and Color Palettes.
Accessibility mode for the Document Viewer for WinForms component is enabled out-of-the-box. You can set the DisableAccessibility option to True to disable accessibility support for all DevExpress UI controls in a WinForms application.
When the document page is selected, a user can press Enter to activate Document Read mode. In this mode, the user can navigate page elements and use the screen reader to vocalize the content of these elements. You can also specify custom text that the screen reader can vocalize instead of an element’s default content. Refer to the following help topic for more information: Accessible API for WinForms UI Controls.