DataGridView.HitTest(Int32, Int32) Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Retorna informações de localização, como índices de linha e coluna, considerando as coordenadas x e y.

public:
 System::Windows::Forms::DataGridView::HitTestInfo ^ HitTest(int x, int y);
public System.Windows.Forms.DataGridView.HitTestInfo HitTest (int x, int y);
member this.HitTest : int * int -> System.Windows.Forms.DataGridView.HitTestInfo
Public Function HitTest (x As Integer, y As Integer) As DataGridView.HitTestInfo

Parâmetros

x
Int32

A coordenada X.

y
Int32

A coordenada Y.

Retornos

DataGridView.HitTestInfo

Um DataGridView.HitTestInfo que contém as informações de localização.

Exemplos

O exemplo de código a seguir ilustra o uso desse método. Este exemplo faz parte de um exemplo maior disponível no tópico de referência de Columns propriedade.

private DataGridViewCell clickedCell;

private void dataGridView1_MouseDown(object sender, MouseEventArgs e)
{
// If the user right-clicks a cell, store it for use by the shortcut menu.
    if (e.Button == MouseButtons.Right)
    {
        DataGridView.HitTestInfo hit = dataGridView1.HitTest(e.X, e.Y);
        if (hit.Type == DataGridViewHitTestType.Cell)
        {
            clickedCell =
                dataGridView1.Rows[hit.RowIndex].Cells[hit.ColumnIndex];
        }
    }
}

Private clickedCell As DataGridViewCell

Private Sub dataGridView1_MouseDown(ByVal sender As Object, _
    ByVal e As MouseEventArgs) Handles dataGridView1.MouseDown

    ' If the user right-clicks a cell, store it for use by the 
    ' shortcut menu.
    If e.Button = MouseButtons.Right Then
        Dim hit As DataGridView.HitTestInfo = _
            dataGridView1.HitTest(e.X, e.Y)
        If hit.Type = DataGridViewHitTestType.Cell Then
            clickedCell = _
                dataGridView1.Rows(hit.RowIndex).Cells(hit.ColumnIndex)
        End If
    End If

End Sub

Comentários

Você pode usar esse método para determinar qual parte do DataGridView controle está localizada nas coordenadas especificadas. Por exemplo, você pode chamar esse método - especificando as coordenadas de um clique do mouse - para determinar os índices de linha e coluna da célula clicada ou se uma célula de cabeçalho ou barra de rolagem foi clicada.

Aplica-se a

Confira também