ASPxClientGridView.GetFocusedRowIndex Method

Returns the focused row’s index.

Declaration

GetFocusedRowIndex(): number

Returns

Type	Description
number	A zero-based integer that specifies the focused row’s index.

Remarks

The GetFocusedRowIndex method returns -1:

• if the ASPxGridViewBehaviorSettings.AllowFocusedRow property is set to false;
• for a newly created row in Batch Edit mode.

Example

This example illustrates how to dynamically display a focused employee’s photo and details outside the grid.

Note

For a full example, see the ASPxGridView - Focused Row (WebForms) and Grid View - focused Row (MVC) demos.

WebForms:

ASPX

<dx:ASPxGridView ID="grid" ClientInstanceName="grid" runat="server" DataSourceID="EmployeesDataSource"
    KeyFieldName="EmployeeID" PreviewFieldName="Notes" AutoGenerateColumns="False" 
    EnableRowsCache="false" Width="100%">
    <Columns>
    ...
    </Columns>
    <ClientSideEvents FocusedRowChanged="function(s, e) { OnGridFocusedRowChanged(); }" />
</dx:ASPxGridView>

JS

function OnGridFocusedRowChanged() {
    // Gets the focused row's "EmployeeID" and "Notes" fields values.
    // The OnGetRowValues() function returns these values.
    DetailNotes.SetText("Loading...");
    grid.GetRowValues(grid.GetFocusedRowIndex(), 'EmployeeID;Notes', OnGetRowValues);
}

function OnGetRowValues(values) {
    DetailImage.SetImageUrl("FocusedRow.aspx?Photo=" + values[0]);
    DetailImage.SetVisible(true);
    DetailNotes.SetText(values[1]);
}

MVC:

Razor (View)

@Html.DevExpress().GridView(settings => {
    settings.Name = "grid";
    settings.KeyFieldName = "EmployeeID";
    ...
    settings.ClientSideEvents.FocusedRowChanged = "OnGridFocusedRowChanged";
}).Bind(Model).GetHtml()

JS

function OnGridFocusedRowChanged(s, e) {
    s.GetRowValues(s.GetFocusedRowIndex(), 'EmployeeID;Notes', OnGetRowValues);
}
function OnGetRowValues(values) {
    DetailPhoto.SetImageUrl("@GridViewRowsDemosHelper.GetEmployeeImageRouteUrl()?@GridViewRowsDemosHelper.ImageQueryKey=" + values[0]);
    DetailNotes.SetText(values[1]);
}

Result: