DataGridView.HitTest(Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.