Back to Devexpress

ASPxClientGridView.UnselectRows Method

aspnet-js-aspxclientgridview-4c561ccf.md

latest3.3 KB
Original Source

ASPxClientGridView.UnselectRows Method

Deselects rows.

Declaration

ts
UnselectRows(
    visibleIndices?: number[] | number
): void

Parameters

NameTypeDescription
visibleIndicesnumbernumber[]

The visible indices of rows.

|

Remarks

If the visibleIndices parameter is not specified, the UnselectRows method deselects all rows in the grid.

For more information on row selection in grid, refer to the following topic: Selection.

Examples

Deselect All Grid Rows

aspx
<dx:ASPxGridView ID="MyGridView" ClientInstanceName="grid" runat="server"
    OnContextMenuInitialize="GridView_ContextMenuInitialize">
    <ClientSideEvents ContextMenuItemClick="OnContextMenuItemClick" />
    <%--...--%>
    <SettingsBehavior AllowSelectByRowClick="True" />
    <SettingsContextMenu Enabled="True" />
</dx:ASPxGridView>
js
function OnContextMenuItemClick(s, e) {
    switch(e.item.name) {
        case 'SelectAll':
            grid.SelectRows();
            break;
        case 'DeselectAll':
            grid.UnselectRows();
            break;
    }
}
csharp
protected void GridView_ContextMenuInitialize(object sender, ASPxGridViewContextMenuInitializeEventArgs e) {
    e.ContextMenu.Items.Add("Select All", "SelectAll");
    e.ContextMenu.Items.Add("Deselect All", "DeselectAll");
}
vb
Protected Sub GridView_ContextMenuInitialize(ByVal sender As Object, ByVal e As ASPxGridViewContextMenuInitializeEventArgs)
    e.ContextMenu.Items.Add("Select All", "SelectAll")
    e.ContextMenu.Items.Add("Deselect All", "DeselectAll")
End Sub

Deselect the Row Specified by Its Visible Index

aspx
<dx:ASPxGridView ID="ASPxGridView1" ClientInstanceName="grid" runat="server">
    <%--...--%>
</dx:ASPxGridView>


<dx:ASPxButton ID="ASPxButton1" runat="server" AutoPostBack="False" Text="Unselect row with index #2">
    <ClientSideEvents Click="UnselectSecondRow"/>
</dx:ASPxButton>
js
function UnselectSecondRow(s, e){
    grid.UnselectRows(2);
}

Deselect Multiple Rows Specified by Their Visible Indices

aspx
<dx:ASPxGridView ID="ASPxGridView1" ClientInstanceName="grid" runat="server">
    <%--...--%>
</dx:ASPxGridView>


<dx:ASPxButton ID="ASPxButton1" runat="server" AutoPostBack="False" Text="Unselect row with indices ##1-3">
    <ClientSideEvents Click="UnselectMultipleRows" />
</dx:ASPxButton>
js
function UnselectMultipleRows(s, e){
    var indices = [1, 2, 3];
    grid.UnselectRows(indices);
}

See Also

ASPxClientGridView Class

ASPxClientGridView Members