Back to Devexpress

Accessibility for WPF Document Viewer

xtrareports-404962-desktop-reporting-common-features-accessibility-wpf-document-viewer-accessibility.md

latest3.6 KB
Original Source

Accessibility for WPF Document Viewer

  • Jul 03, 2025
  • 2 minutes to read

Accessibility Features Overview

Accessibility RequirementSupport Level
Keyboard Navigation Support
Screen Reader Support
Contrast Color Theme

- all component features meet the requirement

- component features partially meet the requirement

Accessibility Standards Compliance

WinForms Document Viewer component complies to Section 508 and WCAG 2.x standards criteria. We have not encountered any issues other than the following:

Section 508 criteriaWCAG 2.x criteriaException description
1.3.1 Info and RelationshipsIn the Document Page area, assistive technology cannot programmatically determine which column header is associated with a specific cell.
1.3.2 Meaningful SequenceThe 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 TrapDocument Map panel focus cannot be moved with arrow or tab keys.
3.1.1 Language of PageThe component does not expose UI language information to assistive technologies. A developer can specify a language in the page that contains the component.

Keyboard Navigation

A user can use the following keys to interact with the Document Viewer:

KeyAction
TabNavigates between the Document area, Parameters panel, Document Map panel. Navigates between Ribbon items. Navigates between elements in Parameters and Document Map panels.
Narrator + Left/Right ArrowMoves between Ribbon command items. Navigates within the contents of a document page when you move focus to a document page. Moves between editors in Document Map and Export panels. Selects an item in drop-down boxes.
EscMoves focus to the page that contains bricks when navigating between bricks on a page.
SpaceTriggers an action when a command item is selected in the Ribbon.

Screen Reader Support

WinForms Document Viewer supports screen readers and complies to WAI-ARIA standards. The exceptions are listed in the Accessibility Standards Compliance topic section.

Contrast Color Theme

Use the DevExpress Office 2019 High Contrast theme to improve readability. Review the following help topic for information on DevExpress WPF application themes: WPF Application Themes.

Accessibility Mode

Set the IsEnabled property to false to enable accessibility features in a DevExpress WPF application:

csharp
public partial class App : Application {
    static App() {
    // ... 
    DevExpress.Xpf.Core.ClearAutomationEventsHelper.IsEnabled = false;
    }
}
vb
Partial Public Class App  
    Inherits Application  
    Public Sub New()  
    DevExpress.Xpf.Core.ClearAutomationEventsHelper.IsEnabled = False  
    End Sub  
End Class
...