Accessibility Support

• Dec 26, 2024
• 5 minutes to read

Many DevExpress WinForms controls comply with WCAG 2.2 (Level AA), Section 508, and EN 301 549 standards. Refer to the DevExpress Accessibility Conformance Report (ACR) for more information on how WinForms controls satisfy these requirements.

Download: DevExpress WinForms ACR v24.1(based on VPAT®)

Limitations

The following table lists known GridControl limitations according to the WCAG 2.x standard:

WCAG 2.x Criterion	Exception Description
1.3.1 Info and Relationships (Level A)	In Master-Detail mode, a detail tab does not provide assistive technologies with accessible information about other tabs. Exported documents do not preserve information about the table structure. Dialog Edit Form: editors do not provide assistive technologies with accessible information about their labels. Kanban View does not provide assistive technologies with accessible information about labels in the focused column.
1.3.2 Meaningful Sequence (Level A)	Content of the GridControl is presented in a meaningful sequence except for the following elements (when Scan Mode is activated in the screen reader): Column headers Elements in Layout View cards
2.1.1 Keyboard (Level A)	Control functionality is generally accessible through a keyboard interface except for the following: Focus column headers. As a workaround you can use GridControl‘s APIs (Group, Sort, or Filter ) and a key press event to perform column header actions. Open an item/cell/row’s context menu. Navigate through Data Navigator elements. The Column Filter Popup is not focused automatically when you open it. WinExplorer View Expand/collapse a group row. Navigate to the second part of the view in Split Presentation mode. TileView: Focus the Add New Item button. Scroll the view when you focus an item outside of the visible area on the right side.
2.1.2 No Keyboard Trap (Level A)	Users need to press the Ctrl+Tab or Ctrl+Shift+Tab shortcut to move focus away from the GridControl.
4.1.2 Name, Role, Value (Level A)	The list below contains the GridControl‘s accessible information that is not provided for assistive technologies: Group row Expanded/collapsed state changes. Checkbox states. AutoFilterRow criterion. Group row value when a user navigates from a master row to a detail grid’s group row. Grid values that are changed in code. Values within the NewItemRow/AutoFilterRow. Card View and Layout View: card fields if a user navigates through them without editing. WinExplorer View: focused group row. The find panel‘s search result. After a cell value is changed, GridControl remains in edit mode. In this mode, Narrator can only access the cell value. Press Esc to exit the edit mode.
2.5.7 Dragging Movements (Level AA 2.2 only)	DevExpress GridControl meets the specified criterion with the following exceptions: Column resize Column reorder Row drag & drop (when enabled)
2.5.8 Target Size (Minimum) (Level AA 2.2 only)	GridColumn resizing splitters and filter buttons may contain smaller pointer input areas than 24x24 pixels depending on the applied theme.
4.1.3 Status Messages (Level AA 2.1 only)	The DevExpress WinForms GridControl does not inform assistive technologies when a value changes in the GridControl’s find panel.

Note

Accessibility features of your application depend on implementation (your use of GridControl API). Your application may not require or enable user actions listed above. The limitation list may also be incomplete. Test all required user functionality to ensure accessibility compliance.

Keyboard Navigation

A user can use the following keys or shortcuts to interact with the GridControl component:

Key	Action
← → ↑ ↓	Navigates through cells if no cell is in the editing state.
Tab / Shift + Tab	Moves the focus one element forward/back. Focuses the first/last element in the next/previous row if there are no more elements in the current row.
PageUp / PageDown	Navigates to the previous/next page.
Enter	Activates a cell editor.[1] Saves changes made in a cell or row and deactivates all editors.[1]
F2	Activates a cell editor.[1]
Ctrl + ← / →	Moves the cursor in the active cell editor.
Ctrl / Shift + ↑ / ↓	Increases/decreases the value in the active cell editor (depends on the editor type).
Alt + ↓ / F4	Opens the active editor’s drop-down window (a select box, a calendar, etc.).
Home / End	Focuses the first/last cell in a row.
Ctrl + Home / Ctrl + End	Focuses the first/last cell.
Esc / Ctrl + Z	Cancels changes made in a cell or row.
Ctrl + C	Copies data from selected / focused cells to the clipboard.
Ctrl + V	Pastes clipboard content.[2]
Ctrl + F	Focuses the find panel.
Ctrl + Shift + F	Opens the find panel.
F3 / Shift + F3	Navigates to the next/previous search result.[3]
Ctrl + Click on a column header	Clears the column’s sort settings.
Shift + Click on a column header	Sorts data against this column. Keeps the previously applied sort order.
Ctrl + +	Expands the focused master-detail row.
Ctrl + -	Collapses the focused master-detail row.
Ctrl + Space	Toggles the selected state of the focused row/cell.
Ctrl + ←/→/↑/↓	If a cell/row is selected, navigates you to a cell/row and preserves the selection.
Ctrl + A	Selects all visible data items.
F5	Reloads data from the data source.

Information on Screen Reader Support and Contrast Skin Availability

Refer to the following topic for more information on accessibility support in DevExpress WinForms Controls: Accessibility Support.

Footnotes

1. If Editable is true.

2. If PasteMode is Append or Update.

3. If ColumnViewOptionsFind.Behavior is Search.