ColumnView.UnselectRow(Int32) Method

Removes a row (card) from the current selection.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v23.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

C#

public virtual void UnselectRow(
    int rowHandle
)

VB.NET

Public Overridable Sub UnselectRow(
    rowHandle As Integer
)

Parameters

Name	Type	Description
rowHandle	Int32	An integer value identifying the row (card) by its handle.

Remarks

This method does nothing if multiple row selection is prohibited (the ColumnViewOptionsSelection.MultiSelect property is set to false). To clear the selection within the view, call the ColumnView.ClearSelection method.

Refer to the Multiple Row and Cell Selection topic for additional information on selecting rows and cards via code.

Note

Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the UnselectRow member must not be invoked for these Views. The UnselectRow member can only be used with Views that display real data within the Grid Control. Use the following methods to access these Views with which an end user interacts at runtime.

• GridControl.MainView - returns the top most View in a grid;
• GridControl.FocusedView - returns the focused View;
• GridControl.DefaultView - returns the currently maximized View;
• the sender parameter of View specific events;
• GridView.GetDetailView - returns a detail clone View for a specific master row.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the UnselectRow(Int32) method.

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#

winforms-grid-select-detail-rows-when-selecting-master-row/CS/MasterDetailSelectionHelper.cs#L33

    else if (_GridView.GetSelectedRows().Length == 0)
        (_GridView.ParentView as GridView).UnselectRow(masterRowHandle);
}

winforms-grid-copy-cells-in-biff8-format-using-excel-export-api/CS/gridCopyToClipboardExample/CopyToClipboardHelper.cs#L42

foreach (int gridRowHandle in selectedRows) {
    view.UnselectRow(gridRowHandle);
    view.RefreshRow(gridRowHandle);

VB.NET

winforms-grid-select-detail-rows-when-selecting-master-row/VB/MasterDetailSelectionHelper.vb#L27

ElseIf _GridView.GetSelectedRows().Length = 0 Then
    TryCast(_GridView.ParentView, GridView).UnselectRow(masterRowHandle)
End If

winforms-grid-copy-cells-in-biff8-format-using-excel-export-api/VB/gridCopyToClipboardExample/CopyToClipboardHelper.vb#L44

For Each gridRowHandle As Integer In selectedRows
    view.UnselectRow(gridRowHandle)
    view.RefreshRow(gridRowHandle)