DataGrid.HitTest Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Recebe informações sobre o DataGrid controlo num ponto específico no ecrã.

Sobrecargas

Name Description
HitTest(Int32, Int32)

Obtém informação, como o número de linhas e colunas de um ponto clicado na grelha, usando as coordenadas x e y passadas ao método.
HitTest(Point)

Obtém informações, como o número de linhas e colunas de um ponto clicado na grelha, sobre a grelha usando um determinado Point.

HitTest(Int32, Int32)

Origem:
DataGrid.cs
Origem:
DataGrid.cs

Obtém informação, como o número de linhas e colunas de um ponto clicado na grelha, usando as coordenadas x e y passadas ao método.

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

Parâmetros

x
Int32

A posição horizontal da coordenada.

y
Int32

A posição vertical da coordenada.

Devoluções

DataGrid.HitTestInfo

A DataGrid.HitTestInfo que contém informação sobre a parte da grelha em que se clica.

Exemplos

O exemplo de código seguinte utiliza o HitTest método num evento que ocorre quando o utilizador clica na grelha.

Private Sub DataGrid1_MouseDown(ByVal sender As Object, ByVal e As MouseEventArgs)
    Dim myGrid As DataGrid = CType(sender, DataGrid)
    Dim hti As System.Windows.Forms.DataGrid.HitTestInfo
    hti = myGrid.HitTest(e.X, e.Y)
    Select Case hti.Type
    Case System.Windows.Forms.DataGrid.HitTestType.None 
       Console.WriteLine("You clicked the background.")
    Case System.Windows.Forms.DataGrid.HitTestType.Cell 
       Console.WriteLine("You clicked cell at row " & hti.Row & ", col " & hti.Column)
    Case System.Windows.Forms.DataGrid.HitTestType.ColumnHeader
       Console.WriteLine("You clicked the column header for column " & hti.Column)
    Case System.Windows.Forms.DataGrid.HitTestType.RowHeader 
       Console.WriteLine("You clicked the row header for row " & hti.Row)
    Case System.Windows.Forms.DataGrid.HitTestType.ColumnResize
       Console.WriteLine("You clicked the column resizer for column " & hti.Column)
    Case System.Windows.Forms.DataGrid.HitTestType.RowResize 
       Console.WriteLine("You clicked the row resizer for row " & hti.Row)
    Case System.Windows.Forms.DataGrid.HitTestType.Caption
       Console.WriteLine("You clicked the caption")
    Case System.Windows.Forms.DataGrid.HitTestType.ParentRows 
       Console.WriteLine("You clicked the parent row")
    End Select
 
 End Sub

Observações

O DataGrid.HitTestInfo, em conjunto com o método HitTest do controlo System.Windows.Forms.DataGrid, é usado para determinar em que parte de um controlo System.Windows.Forms.DataGrid o utilizador clicou. Contém DataGrid.HitTestInfo a linha, coluna e parte da grelha que foi clicada. Além disso, a Type propriedade devolve uma DataGrid.HitTestType enumeração.

O método utiliza um argumento x e y fornecido >, , , , , e .

Ver também

Aplica-se a

HitTest(Point)

Origem:
DataGrid.cs
Origem:
DataGrid.cs

Obtém informações, como o número de linhas e colunas de um ponto clicado na grelha, sobre a grelha usando um determinado Point.

public:
 System::Windows::Forms::DataGrid::HitTestInfo ^ HitTest(System::Drawing::Point position);
public System.Windows.Forms.DataGrid.HitTestInfo HitTest(System.Drawing.Point position);
member this.HitTest : System.Drawing.Point -> System.Windows.Forms.DataGrid.HitTestInfo
Public Function HitTest (position As Point) As DataGrid.HitTestInfo

Parâmetros

position
Point

A Point que representa uma única coordenada x,y.

Devoluções

DataGrid.HitTestInfo

A DataGrid.HitTestInfo que contém informações específicas sobre a grelha.

Exemplos

O exemplo de código seguinte utiliza o HitTest método em que ocorre quando um utilizador clica numa grelha.

Private Sub DataGrid1_MouseDown(ByVal sender As Object, ByVal e As MouseEventArgs)
    Dim hti As DataGrid.HitTestInfo
    hti = grid.HitTest(New Point(e.X, e.Y))
    Select Case hti.Type
    Case System.Windows.Forms.DataGrid.HitTestType.None 
       Console.WriteLine("You clicked the background.")
    Case System.Windows.Forms.DataGrid.HitTestType.Cell 
       Console.WriteLine("You clicked cell at row " & hti.Row & ", col " & hti.Column)
    Case System.Windows.Forms.DataGrid.HitTestType.ColumnHeader
       Console.WriteLine("You clicked the column header for column " & hti.Column)
    Case System.Windows.Forms.DataGrid.HitTestType.RowHeader 
       Console.WriteLine("You clicked the row header for row " & hti.Row)
    Case System.Windows.Forms.DataGrid.HitTestType.ColumnResize
       Console.WriteLine("You clicked the column resizer for column " & hti.Column)
    Case System.Windows.Forms.DataGrid.HitTestType.RowResize 
       Console.WriteLine("You clicked the row resizer for row " & hti.Row)
    Case System.Windows.Forms.DataGrid.HitTestType.Caption
       Console.WriteLine("You clicked the caption")
    Case System.Windows.Forms.DataGrid.HitTestType.ParentRows 
       Console.WriteLine("You clicked the parent row")
    End Select
 End Sub

Observações

O DataGrid.HitTestInfo, em conjunto com o método HitTest do controlo System.Windows.Forms.DataGrid, é usado para determinar em que parte de um controlo System.Windows.Forms.DataGrid o utilizador clicou. Contém DataGrid.HitTestInfo a linha, coluna e parte da grelha que foi clicada. Além disso, a Type propriedade devolve uma DataGrid.HitTestType enumeração.

O método utiliza um argumento x e y fornecido >, , , , , e .

Ver também

Aplica-se a