Moving Row Focus
- 2 minutes to read
Availability
Rows can be focused if the DataViewBase.NavigationStyle property isn’t set to GridViewNavigationStyle.None. To specify the focused row, use the DataViewBase.FocusedRowHandle property. If the specified row isn’t visible onscreen, a View is automatically scrolled to make the focused row visible.
If the row focusing is enabled, the GridControl focuses the first row when loaded by default. To load the GridControl without focused rows, set the DataControlBase.AllowInitiallyFocusedRow property to false.
Moving Row Focus
The focused row is specified by its handle using the DataViewBase.FocusedRowHandle property. The GridControl provides multiple members that you can use to move row focus:
| Member | Description |
|---|---|
| DataControlBase.CurrentItem | Gets or sets the currently focused data row. |
| DataViewBase.MoveFirstRow | Moves focus to the first visible row or card within a View. |
| DataViewBase.MovePrevPage | Moves focus backward by the number of rows or cards displayed onscreen within a View. |
| DataViewBase.MovePrevRow | Moves focus to the row or card preceding the one currently focused. |
| DataViewBase.MoveNextRow | Moves focus to the row or card following the one currently focused. |
| DataViewBase.MoveNextPage | Moves focus forward by the number of rows or cards displayed onscreen within a View. |
| DataViewBase.MoveLastRow | Moves focus to the last visible row or card within a View. |
| DataViewBase.MoveFocusedRow | Moves focus to the specified row. |
| GridViewBase.MoveParentGroupRow | Moves focus to the group row that owns the currently focused row. |
All these methods move focus between visible rows. These methods don’t expand collapsed groups.
After the focused row has been changed, the DataControlBase.CurrentItemChanged event is raised.
The number of visible rows is returned by the DataControlBase.VisibleRowCount property. Note that rows contained within collapsed group rows are not taken into account.
Set the DataViewBase.FadeSelectionOnLostFocus property to false to keep the focused row highlighted when the GridControl loses focus.