Focus and Navigation¶
Cell and Row Navigation Modes¶
The DataGrid's default behavior allows users to navigate between cells using the keyboard, or focus them using the mouse.
Use the DataGridControl.NavigationMode
property to switch between Cell Navigation and Row Navigation modes.
Cell Navigation (default)
Users can focus any cell using the keyboard or mouse.
Row Navigation
Users cannot focus individual cells, and cell edit operations are disabled. Clicking a cell highlights the entire row.
Focused Column¶
Use the DataGridControl.FocusedColumn
property to obtain the focused column. To move focus to a specific column, assign a corresponding GridColumn
object to the FocusedColumn
property.
Note
You can only focus a column in Cell Navigation mode.
Focused Row¶
Use the DataGridControl.FocusedRowIndex
property to retrieve the focused row's index. The DataGridControl.FocusedItem
property allows you to retrieve the focused row's underlying data object.
To move focus to a specific row, you can assign this row's index to the DataGridControl.FocusedRowIndex
property.
Focused Cell¶
The focused cell is determined by the intersection of the focused row and focused column. To move focus to a specific cell, focus the target row and column.