Accessibility Support

• Apr 16, 2024
• 4 minutes to read

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. Navigate through Data Navigator elements. The Column Filter Popup is not focused automatically when you open it. Expand/collapse a group row in WinExplorer View. 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’s expanded/collapsed state changes. Specified criterion in the AutoFilterRow. Group row value when a user navigates from a master row to a detail grid’s group row. Grid values that are changed via APIs. Values within the NewItemRow/AutoFilterRow. Fields in the Card and Layout View cards when a user navigates through them without editing. In the WinExplorer View, focused group row.
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)	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 cursor in the active cell editor.
Ctrl / Shift + ↑ / ↓	Increases/decreases value in the active cell editor (depends on editor type).
Alt + ↓ / F4	OOpens 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 column’s dropdown filter.
F3 / Shift + F3	Navigates to the next/previous search result.[3]
Ctrl + Click on a column header	Clears sorting settings of the column.
Shift + Click on a column header	Sorts data against this column. Keeps previously applied sort order.
Ctrl + +	Expands the focused master-detail row.
Ctrl + -	Collapses the focused master-detail row.
Ctrl + Space	Toggles 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 the 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.