windowsforms-404829-controls-and-libraries-data-grid-accessibility-support.md
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®)
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)
|
| |
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):
| |
2.1.1
Keyboard
(Level A)
|
Control functionality is generally accessible through a keyboard interface except for the following:
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.
Add a node in the Filter Editor.
Navigate to the second part of the view in Split Presentation mode.
| |
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
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:
| |
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.
A user can use the following keys or shortcuts to interact with the GridControl component:
|
Key
|
Action
| | --- | --- | |
← → ↑ ↓
|
| |
Tab
|
| |
Shift + Tab
|
| |
Ctrl + Shift + Tab
|
Focuses a column header.[1]
| |
Ctrl + Tab
|
Moves focus to the previously selected row if a column header is focused.[1]
| |
PageUp / PageDown
|
Navigates to the previous/next page.
| |
Enter
|
| |
Enter / Space
|
Sorts data by the column if a column header or a column in the group panel is focused.[1]
| |
Shift
Shift + Space
|
Adds the column to multi-column sorting if a column header or a column in the group panel is focused.[1]
| |
Ctrl
|
Removes the column from multi-column sorting if a column header or a column in the group panel is focused.[1]
| |
Ctrl + Space
|
| |
F2
|
Activates a cell editor.[2]
| |
Ctrl + ← / →
|
| |
Ctrl / Shift + ↑ / ↓
|
Increases/decreases the value in the active cell editor (depends on the editor type).
| |
Alt + ↓ / F4
|
| |
Shift + ←/→
|
Increases or decreases column/band width if a column header/band is focused.
| |
Shift + F10
Context Menu ≣
|
Opens the context menu if a column header/band or a column in the group panel is focused.
| |
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.[4]
| |
Ctrl + F
|
Focuses the find panel.
| |
Ctrl + Shift + F
|
Opens the find panel.
| |
F3
Shift + F3
|
Navigates to the next/previous search result.[5]
| |
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 + ←/→/↑/↓
|
| |
Ctrl + A
|
Selects all visible data items.
| |
F5
|
Reloads data from the data source.
|
Refer to the following topic for more information on accessibility support in DevExpress WinForms Controls: Accessibility Support.
Footnotes
If AllowHeaderNavigation is DefaultBoolean.True.
If Editable is true.
If InHeaderSearchMode is active.
If PasteMode is Append or Update.