GridView.SelectCell(Int32, GridColumn) Method

Selects the cell.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v22.2.dll

NuGet Package: DevExpress.Win.Grid

Declaration

C#

public virtual void SelectCell(
    int rowHandle,
    GridColumn column
)

VB.NET

Public Overridable Sub SelectCell(
    rowHandle As Integer,
    column As GridColumn
)

Parameters

Name	Type	Description
rowHandle	Int32	The cell’s row handle.
column	GridColumn	The cell’s column.

Remarks

A cell is located at the specified row and column’s intersection.

The SelectCell method does nothing if multiple cell selection (block selection) is disabled. To ensure that block selection is in effect, use the GridView.IsCellSelect property. To unselect a cell use the GridView.UnselectCell method.

When the selection changes, the ColumnView.SelectionChanged event occurs.

The code sample below illustrates how to select the entire grid column when users hold the CTRL button and click on a column’s header.

C#

gridView1.OptionsSelection.MultiSelect = true;
gridView1.OptionsSelection.MultiSelectMode = GridMultiSelectMode.CellSelect;
gridView1.MouseDown += GridView1_MouseDown;

private void GridView1_MouseDown(object sender, MouseEventArgs e)
{
    GridView view = sender as GridView;
    GridViewInfo gridInfo = view.GetViewInfo() as GridViewInfo;
    GridHitInfo hitInfo = view.CalcHitInfo(e.Location);

    if (hitInfo.InColumnPanel && e.Button == System.Windows.Forms.MouseButtons.Left && ModifierKeys == Keys.Control)
    {
        for (int i = 0; i < hitInfo.Column.View.RowCount; i++)
            view.SelectCell(i, hitInfo.Column);
        ((DXMouseEventArgs)e).Handled = true;
    }

}

VB.NET

gridView1.OptionsSelection.MultiSelect = True
gridView1.OptionsSelection.MultiSelectMode = GridMultiSelectMode.CellSelect
AddHandler gridView1.MouseDown, AddressOf GridView1_MouseDown

private void GridView1_MouseDown(Object sender, MouseEventArgs e)
    Dim view As GridView = TryCast(sender, GridView)
    Dim gridInfo As GridViewInfo = TryCast(view.GetViewInfo(), GridViewInfo)
    Dim hitInfo As GridHitInfo = view.CalcHitInfo(e.Location)

    If hitInfo.InColumnPanel AndAlso e.Button = System.Windows.Forms.MouseButtons.Left AndAlso ModifierKeys = Keys.Control Then
        For i As Integer = 0 To hitInfo.Column.View.RowCount - 1
            view.SelectCell(i, hitInfo.Column)
        Next i
        CType(e, DXMouseEventArgs).Handled = True
    End If