DataGridView.HitTest(Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve informação de localização, como índices de linhas e colunas, dadas 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.
Devoluções
A DataGridView.HitTestInfo que contém a informação de localização.
Exemplos
O seguinte exemplo de código ilustra a utilização deste método. Este exemplo faz parte de um exemplo mais amplo disponível no Columns tópico de referência de propriedades.
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
Observações
Pode usar este método para determinar que parte do DataGridView controlo está localizada nas coordenadas especificadas. Por exemplo, pode chamar este método – especificar as coordenadas de um clique do rato – para determinar os índices de linhas e colunas da célula clicada ou se uma célula de cabeçalho ou barra de scroll foi clicada.