DataViewBase.FocusedRowHandle Property

Gets or sets the focused row’s handle. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v18.2.Core.dll

Declaration

C#

[Browsable(false)]
public int FocusedRowHandle { get; set; }

VB.NET

<Browsable(False)>
Public Property FocusedRowHandle As Integer

Property Value

Type	Description
Int32	An integer value that specifies the focused row’s handle.

Remarks

The focused row isn’t displayed if the DataViewBase.NavigationStyle property is set to GridViewNavigationStyle.None. To specify the focused row, use the FocusedRowHandle property or the DataViewBase.MoveFocusedRow method. If the specified row isn’t visible onscreen, a View is automatically scrolled to make the focused row visible.

After the focused row has been changed, the DataViewBase.FocusedRowChanged event is raised.

To learn more, see Moving Row Focus.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the FocusedRowHandle property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

dxgrid-how-to-multi-select-rows-by-using-the-touch-screen-e4621/CS/GridMultiTouchProject/GridMultiTouchBehavior.cs#L49

_isMultiSelection = true;
_startRowSelect = this.tableView1.FocusedRowHandle;
_finishRowSelect = this.tableView1.FocusedRowHandle;

expanding-and-collapsing-master-rows-e4044/CS/WpfApplication21/MainWindow.xaml.cs#L69

// or when a groupo row is focused
if (!view.IsFocusedView || view.FocusedRowHandle < 0)
    return;

how-to-preserve-the-dxgrid-for-wpf-view-state-e4222/CS/SaveWpfGridState/RowStateHelper.cs#L168

focusedDetailKey = null;
focusedRowHandle = gridControl.View.FocusedRowHandle;
if (gridControl.IsGroupRowHandle(focusedRowHandle)) {

dxgrid-how-to-bind-gridcontrol-context-menu-items-to-commands-e4624/VB/GridCommandToPopupMenuProject/MainWindow.xaml#L21

<dxg:GridControl.View>
    <dxg:TableView FocusedRowHandle="{Binding SelectedPersonNum, Mode=TwoWay}">
        <dxg:TableView.RowCellMenuCustomizations>

how-to-add-incremental-search-into-gridcontrol-t163003/CS/IncrementalSearch/Behavior/IncrementalSearchBehavior.cs#L274

{
    var currentCell = TableView.GetCellElementByRowHandleAndColumn(TableView.FocusedRowHandle, Grid.CurrentColumn);

VB.NET

dxgrid-how-to-multi-select-rows-by-using-the-touch-screen-e4621/VB/GridMultiTouchProject/GridMultiTouchBehavior.vb#L53

_isMultiSelection = True
_startRowSelect = Me.tableView1.FocusedRowHandle
_finishRowSelect = Me.tableView1.FocusedRowHandle

expanding-and-collapsing-master-rows-e4044/VB/WpfApplication21/MainWindow.xaml.vb#L65

' or when a groupo row is focused
If Not view.IsFocusedView OrElse view.FocusedRowHandle < 0 Then
    Return

how-to-preserve-the-dxgrid-for-wpf-view-state-e4222/VB/SaveWpfGridState/RowStateHelper.vb#L183

focusedDetailKey = Nothing
focusedRowHandle = gridControl.View.FocusedRowHandle
If gridControl.IsGroupRowHandle(focusedRowHandle) Then

how-to-add-incremental-search-into-gridcontrol-t163003/VB/IncrementalSearch/Behavior/IncrementalSearchBehavior.vb#L229

Public Sub TextHighlightUpdate()
    Dim currentCell = TableView.GetCellElementByRowHandleAndColumn(TableView.FocusedRowHandle, Grid.CurrentColumn)

how-to-clear-focus-when-loading-a-grid-e1388/VB/Window1.xaml.vb#L30

    Dim view As TableView = TryCast(grid.View, TableView)
    view.FocusedRowHandle = GridControl.InvalidRowHandle
End Sub