Accessibility for WinForms Dashboard Viewer
- 4 minutes to read
Accessibility Features Overview
| 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
- Accessibility requirement is not met
Dashboard Item Accessibility
WinForms Dashboard items are built with DevExpress WinForms UI controls. As such, accessibility features in Dashboard depend on WinForms UI control implementation. For additional information, review the following help topic: WinForms Controls - Accessibility Support.
The following table gives you a quick breakdown of available dashboard items, corresponding WinForms UI Controls, and accessibility feature conformance:
Dashboard Item | Control | Accessibility Compliance | Additional Information |
|---|---|---|---|
| Keyboard navigation to column headers and totals is not supported. Filter Popup Menus cannot be accessed from the keyboard. A screen reader cannot read information about column headers and totals. | ||
| Keyboard navigation inside the control is not supported. Screen readers cannot read control content. | ||
| Keyboard navigation inside the control is not supported. Screen readers cannot read control content. | ||
| Space/Enter key press on a card in multi-select mode results in focus loss. Contrast ratio is not sufficient for the selected card when you apply Master Filtering. | ||
| A Pivot item does not provide accessibility information about field headers. A Pivot item does not provide information about focus state. Users cannot use the keyboard to expand/collapse fields. | ||
| You cannot apply Master Filtering inside MapDashboardItem from the keyboard. Screen readers cannot read control content. | ||
| Keyboard navigation inside the control is not supported. Screen readers cannot read control content. | ||
| Screen readers can read text from TextBox dashboard items. | ||
| You can set alternative text for Bound Image and Image dashboard items. | ||
| You cannot focused disabled dates in a Date Filter. | ||
A custom component that you can customize directly. |
| Accessibility support depends on custom item implementation. |
High Contrast Mode
Use the DevExpress High Contrast or Bezier Skin to improve readability. These skins include predesigned color palettes that use carefully selected color combinations to help users with impaired vision (to distinguish text, borders, selection states, and other visual elements/states).
High Contrast Skin
The High Contrast skin includes the following color palettes: Default, High Contrast White, High Contrast #1, High Contrast #2.
The Bezier Skin
The Bezier skin includes two high contrast palettes: High Contrast White, High Contrast Black.
Limitations
The limitation applies to the selected card item when you apply master-filtering: contrast ratio for this element is lower than 4.5:1 including high contrast skins.
High DPI Support
DevExpress WinForms Dashboard Viewer is based on DevExpress WinForms UI Controls. These controls support DirectX hardware acceleration and deliver exceptional performance and superb High DPI rendering quality (4K/8K). As such, your applications can render clearer text and UI elements on bigger screens.
Right-to-Left Support
DevExpress forms and UI controls support right-to-left languages (RTL) at runtime. Read the following topic for detailed information and examples: Right-to-Left Layout in WinForms Controls.
Keyboard Navigation
Most dashboard items are based on WinForms Controls. Keyboard navigation in the dashboard item is the same as in the corresponding WinForms UI control.
For dashboard items that are not based on the WinForms UI controls, use the following keystrokes:
| Action | Key |
|---|---|
| Navigate between dashboard items. | F5 or F6 |
| Apply a card as a Master Filter. | Enter or Space |
| Toggle a predefined interval in a Date Filter item. | Enter |
| Navigate between cards in a Card item. | Arrows |
Ribbon, toolbars, and menus allow end users to navigate between bars and invoke link functionality using the keyboard: Default Keyboard Hotkeys.
Dialogs
The following dialogs are available in the WinForms Dashboard Viewer:
- Data Inspector
- Export to (PDF, Excel, Image)
- Set Predefined Intervals for a Range Filter
- Dashboard Parameters
The dialogs follow common accessibility practices for creating desktop applications.
Limitations
The following keyboard navigation limitations apply to dashboard layout elements in the WinForms Dashboard Viewer:
- Navigation between buttons in the dashboard title and dashboard item captions is not supported.
- You cannot open a dashboard item context menu from the keyboard.