DataViewBase.FocusedRowHandle Property
Gets or sets the focused row’s handle. This is a dependency property.
Namespace: DevExpress.Xpf.Grid
Assembly: DevExpress.Xpf.Grid.v19.1.Core.dll
Declaration
Property Value
| Type | Description |
|---|---|
| Int32 | An integer value that specifies the focused row’s handle. |
Remarks
The focused row is not 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 is not visible onscreen, a View is automatically scrolled to make the focused row visible.
After the focused row has been changed, the DataViewBase.FocusedRowHandleChanged event is raised.
Example: How to Focus a Cell with the Specified Value
This example shows how to identify a data cell with the specified value and focus it. To do this, click the 'Find Next' button. The search is performed starting from the currently focused row.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/how-to-focus-a-cell-with-the-specified-value-e1544.
<Window x:Class="DXSample_FocusingCells.Window1"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:dxg="http://schemas.devexpress.com/winfx/2008/xaml/grid"
Title="Focusing Cells" Height="300" Width="491">
<Grid>
<Grid.RowDefinitions>
<RowDefinition Height="*" />
<RowDefinition Height="32" />
</Grid.RowDefinitions>
<dxg:GridControl Margin="5" Name="grid" AutoGenerateColumns="AddNew">
<dxg:GridControl.View>
<dxg:TableView x:Name="view" AutoWidth="True" ShowGroupPanel="False" AllowGrouping="False" NavigationStyle="Cell" />
</dxg:GridControl.View>
</dxg:GridControl>
<Button Grid.Row="1" HorizontalAlignment="Left" Margin="2" Click="Button_Click">
Find Next</Button>
</Grid>
</Window>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;
using DevExpress.Xpf.Grid;
namespace DXSample_FocusingCells {
public partial class Window1 : Window {
public Window1() {
InitializeComponent();
grid.ItemsSource = new nwindDataSetTableAdapters.ProductsTableAdapter().GetData();
}
private void Button_Click(object sender, RoutedEventArgs e) {
if (grid.VisibleRowCount == 0) return;
int rowHandle = view.FocusedRowHandle + 1;
while (Convert.ToDouble(grid.GetCellValue(rowHandle, "UnitPrice")) != 10 &&
grid.IsValidRowHandle(rowHandle)) {
rowHandle++;
}
if (grid.IsValidRowHandle(rowHandle)) {
grid.CurrentColumn = grid.Columns["UnitPrice"];
view.FocusedRowHandle = rowHandle;
}
}
}
}
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.