Edit

Share via


DataGridViewCellMouseEventArgs Class

Definition

Provides data for mouse events raised by a DataGridView whenever the mouse is moved within a DataGridViewCell.

C#
public class DataGridViewCellMouseEventArgs : System.Windows.Forms.MouseEventArgs
Inheritance
DataGridViewCellMouseEventArgs

Examples

The following code example illustrates the use of this type.

C#
private void dataGridView1_ColumnHeaderMouseClick(
    object sender, DataGridViewCellMouseEventArgs e)
{
    DataGridViewColumn newColumn = dataGridView1.Columns[e.ColumnIndex];
    DataGridViewColumn oldColumn = dataGridView1.SortedColumn;
    ListSortDirection direction;

    // If oldColumn is null, then the DataGridView is not sorted.
    if (oldColumn != null)
    {
        // Sort the same column again, reversing the SortOrder.
        if (oldColumn == newColumn &&
            dataGridView1.SortOrder == SortOrder.Ascending)
        {
            direction = ListSortDirection.Descending;
        }
        else
        {
            // Sort a new column and remove the old SortGlyph.
            direction = ListSortDirection.Ascending;
            oldColumn.HeaderCell.SortGlyphDirection = SortOrder.None;
        }
    }
    else
    {
        direction = ListSortDirection.Ascending;
    }

    // Sort the selected column.
    dataGridView1.Sort(newColumn, direction);
    newColumn.HeaderCell.SortGlyphDirection =
        direction == ListSortDirection.Ascending ?
        SortOrder.Ascending : SortOrder.Descending;
}

private void dataGridView1_DataBindingComplete(object sender,
    DataGridViewBindingCompleteEventArgs e)
{
    // Put each of the columns into programmatic sort mode.
    foreach (DataGridViewColumn column in dataGridView1.Columns)
    {
        column.SortMode = DataGridViewColumnSortMode.Programmatic;
    }
}

Remarks

The DataGridViewCellMouseEventArgs class provides data for the following DataGridView events:

Constructors

Properties

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)
ColumnIndex

Gets the zero-based column index of the cell.

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)
Location

Gets the location of the mouse during the generating mouse event.

(Inherited from MouseEventArgs)
RowIndex

Gets the zero-based row index of the cell.

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)

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also