Freigeben über


DataGrid.HitTest Methode

Definition

Ruft Informationen zum DataGrid-Steuerelement an einem angegebenen Punkt auf dem Bildschirm ab.

Überlädt

HitTest(Int32, Int32)

Ruft mithilfe der x- und y-Koordinaten, die der Methode übergebenen wurden, Informationen über das Datenblatt ab, z. B. Zeilen- und Spaltennummer eines Punktes im Datenblatt, auf den geklickt wurde.

HitTest(Point)

Ruft mithilfe eines bestimmten Point Informationen über das Datenblatt ab, z. B. Zeilen- und Spaltennummer eines Punktes im Datenblatt, auf den geklickt wird.

HitTest(Int32, Int32)

Ruft mithilfe der x- und y-Koordinaten, die der Methode übergebenen wurden, Informationen über das Datenblatt ab, z. B. Zeilen- und Spaltennummer eines Punktes im Datenblatt, auf den geklickt wurde.

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

Parameter

x
Int32

Die horizontale Position der Koordinate.

y
Int32

Die vertikale Position der Koordinate.

Gibt zurück

Eine DataGrid.HitTestInfo mit Informationen über den Teil des Datenblatts, auf den geklickt wurde.

Beispiele

Im folgenden Codebeispiel wird die HitTest -Methode in einem Ereignis verwendet, das auftritt, wenn der Benutzer auf das Raster klickt.

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

Hinweise

In DataGrid.HitTestInfoVerbindung mit der HitTest -Methode des System.Windows.Forms.DataGrid -Steuerelements wird verwendet, um zu bestimmen, auf welchen Teil eines System.Windows.Forms.DataGrid Steuerelements der Benutzer geklickt hat. Enthält DataGrid.HitTestInfo die Zeile, Spalte und einen Teil des Rasters, auf das geklickt wurde. Darüber hinaus gibt die Type -Eigenschaft eine DataGrid.HitTestType Enumeration zurück.

Die HitTest -Methode übernimmt ein x- und y-Argument, das von den System.Windows.Forms.DataGrid - , DragEnter, DragOver, MouseDown- MouseUpMouseMoveund MouseWheel -Ereignissen des -Steuerelements DragDropbereitgestellt wird.

Weitere Informationen

Gilt für:

HitTest(Point)

Ruft mithilfe eines bestimmten Point Informationen über das Datenblatt ab, z. B. Zeilen- und Spaltennummer eines Punktes im Datenblatt, auf den geklickt wird.

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

Parameter

position
Point

Ein Point, der eine einzelne x,y-Koordinate darstellt.

Gibt zurück

Eine DataGrid.HitTestInfo, die spezifische Informationen über das Datenblatt enthält.

Beispiele

Im folgenden Codebeispiel wird die HitTest -Methode in verwendet, wenn ein Benutzer auf ein Raster klickt.

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

Hinweise

In DataGrid.HitTestInfoVerbindung mit der HitTest -Methode des System.Windows.Forms.DataGrid -Steuerelements wird verwendet, um zu bestimmen, auf welchen Teil eines System.Windows.Forms.DataGrid Steuerelements der Benutzer geklickt hat. Enthält DataGrid.HitTestInfo die Zeile, Spalte und einen Teil des Rasters, auf das geklickt wurde. Darüber hinaus gibt die Type -Eigenschaft eine DataGrid.HitTestType Enumeration zurück.

Die HitTest -Methode übernimmt ein x- und y-Argument, das von den System.Windows.Forms.DataGrid - , DragEnter, DragOver, MouseDown- MouseUpMouseMoveund MouseWheel -Ereignissen des -Steuerelements DragDropbereitgestellt wird.

Weitere Informationen

Gilt für: