Skip to main content

GridView.RowClick Event

Allows you to respond to row clicks. The event will not fire when data editing is enabled and the ColumnViewOptionsBehavior.EditorShowMode property is set to MouseDown (and to Default, if multiple row selection is disabled).

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v24.1.dll

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

Declaration

[DXCategory("Action")]
public event RowClickEventHandler RowClick

Event Data

The RowClick event's data class is RowClickEventArgs. The following properties provide information specific to this event:

Property Description
Button Gets which mouse button was pressed. Inherited from MouseEventArgs.
Clicks Gets the number of times the mouse button was pressed and released. Inherited from MouseEventArgs.
Delta Gets a signed count of the number of detents the mouse wheel has rotated, multiplied by the WHEEL_DELTA constant. A detent is one notch of the mouse wheel. Inherited from MouseEventArgs.
Handled Gets or sets whether this event should be forwarded to the control’s parent container. Inherited from HandledMouseEventArgs.
HitInfo Gets an object that identifies the clicked element.
IsHMouseWheel This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from DXMouseEventArgs.
IsMouseEvent Gets whether these event arguments provide data for the MouseUp, MouseDown, and MouseMove events. Inherited from DXMouseEventArgs.
Location Gets the location of the mouse during the generating mouse event. Inherited from MouseEventArgs.
RowHandle Gets the handle of the clicked row.
X Gets the x-coordinate of the mouse during the generating mouse event. Inherited from MouseEventArgs.
Y Gets the y-coordinate of the mouse during the generating mouse event. Inherited from MouseEventArgs.

The event data class exposes the following methods:

Method Description
GetMouseArgs(Control, EventArgs) Converts the MouseEventArgs object passed as a parameter to a DXMouseEventArgs object. Inherited from DXMouseEventArgs.
GetMouseArgs(MouseEventArgs) Converts the MouseEventArgs object passed as a parameter to a DXMouseEventArgs object. Inherited from DXMouseEventArgs.
Sync() For internal use. Inherited from DXMouseEventArgs.

Remarks

The RowClick event fires when clicking on any element of a grid row (cell, cell border, row indicator, etc).

The RowClick event will not fire when clicking on a row cell if data editing is enabled and the ColumnViewOptionsBehavior.EditorShowMode property is set to MouseDown (and to Default, if multiple row selection is disabled).

The code sample below illustrates how to use the RowClick event to copy a column’s value into a TextEdit control.

gridView1.Columns["ID"].View.OptionsBehavior.EditorShowMode = EditorShowMode.MouseUp;
gridView1.RowClick += gridView1_RowClick;

private void gridView1_RowClick(object sender, DevExpress.XtraGrid.Views.Grid.RowClickEventArgs e)
{
    textEdit1.EditValue = (sender as GridView).GetFocusedRowCellValue("ID");
}
See Also