DataGridViewCellMouseEventArgs Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fornece dados para eventos de mouse gerados por um DataGridView sempre que o mouse é movido dentro de um DataGridViewCell.

public ref class DataGridViewCellMouseEventArgs : System::Windows::Forms::MouseEventArgs

public class DataGridViewCellMouseEventArgs : System.Windows.Forms.MouseEventArgs

type DataGridViewCellMouseEventArgs = class
    inherit MouseEventArgs

Public Class DataGridViewCellMouseEventArgs
Inherits MouseEventArgs

Herança

Object

EventArgs

MouseEventArgs

DataGridViewCellMouseEventArgs

Exemplos

O exemplo de código a seguir ilustra o uso desse tipo.

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;
    }
}

Private Sub dataGridView1_ColumnHeaderMouseClick(ByVal sender As Object, _
    ByVal e As DataGridViewCellMouseEventArgs) _
    Handles dataGridView1.ColumnHeaderMouseClick

    Dim newColumn As DataGridViewColumn = _
        dataGridView1.Columns(e.ColumnIndex)
    Dim oldColumn As DataGridViewColumn = dataGridView1.SortedColumn
    Dim direction As ListSortDirection

    ' If oldColumn is null, then the DataGridView is not currently sorted.
    If oldColumn IsNot Nothing Then

        ' Sort the same column again, reversing the SortOrder.
        If oldColumn Is newColumn AndAlso dataGridView1.SortOrder = _
            SortOrder.Ascending Then
            direction = ListSortDirection.Descending
        Else

            ' Sort a new column and remove the old SortGlyph.
            direction = ListSortDirection.Ascending
            oldColumn.HeaderCell.SortGlyphDirection = SortOrder.None
        End If
    Else
        direction = ListSortDirection.Ascending
    End If

    ' Sort the selected column.
    dataGridView1.Sort(newColumn, direction)
    If direction = ListSortDirection.Ascending Then
        newColumn.HeaderCell.SortGlyphDirection = SortOrder.Ascending
    Else
        newColumn.HeaderCell.SortGlyphDirection = SortOrder.Descending
    End If

End Sub

Private Sub dataGridView1_DataBindingComplete(ByVal sender As Object, _
    ByVal e As DataGridViewBindingCompleteEventArgs) _
    Handles dataGridView1.DataBindingComplete

    ' Put each of the columns into programmatic sort mode.
    For Each column As DataGridViewColumn In dataGridView1.Columns
        column.SortMode = DataGridViewColumnSortMode.Programmatic
    Next
End Sub

Comentários

A DataGridViewCellMouseEventArgs classe fornece dados para os seguintes DataGridView eventos:

• CellMouseClick

• CellMouseDoubleClick

• CellMouseDown

• CellMouseMove

• CellMouseUp

• ColumnHeaderMouseClick

• ColumnHeaderMouseDoubleClick

• RowHeaderMouseClick

• RowHeaderMouseDoubleClick

Construtores

DataGridViewCellMouseEventArgs(Int32, Int32, Int32, Int32, MouseEventArgs)

Inicializa uma nova instância da classe DataGridViewCellMouseEventArgs.

Propriedades

Button	Obtém o botão do mouse que foi pressionado. (Herdado de MouseEventArgs)
Clicks	Obtém o número de vezes que o botão do mouse foi pressionado ou liberado. (Herdado de MouseEventArgs)
ColumnIndex	Obtém o índice de coluna de base zero da célula.
Delta	Obtém uma contagem com sinal do número de detentores que a roda do mouse girou, multiplicado pela constante WHEEL_DELTA. Um detentor é um ponto da roda do mouse. (Herdado de MouseEventArgs)
Location	Obtém o local do mouse durante o evento de geração do mouse. (Herdado de MouseEventArgs)
RowIndex	Obtém o índice da linha de base zero da célula.
X	Obtém a coordenada X do mouse durante o evento de mouse gerador. (Herdado de MouseEventArgs)
Y	Obtém a coordenada y do mouse durante o evento de mouse gerador. (Herdado de MouseEventArgs)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• DataGridView
• DataGridViewCell
• DataGridViewCellMouseEventHandler