DataGrid.HitTest 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得畫面指定點中 DataGrid 控制項的相關資訊。

多載

HitTest(Int32, Int32)	使用傳遞至這個方法的 x 和 y 座標來取得資訊，例如方格上按下點的資料列和資料行編號。
HitTest(Point)	取得使用指定 Point 方格的相關資料，例如方格上按下點的資料列和資料行編號。

HitTest(Int32, Int32)

使用傳遞至這個方法的 x 和 y 座標來取得資訊，例如方格上按下點的資料列和資料行編號。

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

參數

x

Int32

座標的水平位置。

y

Int32

座標的垂直位置。

傳回

DataGrid.HitTestInfo

DataGrid.HitTestInfo，包含方格按下區域的相關資訊。

範例

下列程式碼範例會在 HitTest 使用者按一下方格時所發生的 事件中使用 方法。

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

備註

HitTest搭配 DataGrid.HitTestInfo 控制項的 方法 System.Windows.Forms.DataGrid ，可用來判斷使用者已按一下的控制項哪個 System.Windows.Forms.DataGrid 部分。 DataGrid.HitTestInfo包含已按一下之方格的資料列、資料行和一部分。 此外， Type 屬性會 DataGrid.HitTestType 傳回列舉。

方法 HitTest 會採用控制項的 DragDrop 、 DragEnter 、 DragOver 、、 MouseDown 、 MouseMoveMouseUp 和 事件所提供的 System.Windows.Forms.DataGrid x 和 MouseWheel y 引數。

另請參閱

• MouseDown

HitTest(Point)

取得使用指定 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

參數

position

Point

Point，代表單一 X、Y 座標。

傳回

DataGrid.HitTestInfo

DataGrid.HitTestInfo，包含方格的指定資訊。

範例

下列程式碼範例會在 HitTest 使用者按一下方格時，使用 中的 方法。

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

備註

HitTest搭配 DataGrid.HitTestInfo 控制項的 方法 System.Windows.Forms.DataGrid ，可用來判斷使用者已按一下的控制項哪個 System.Windows.Forms.DataGrid 部分。 DataGrid.HitTestInfo包含已按一下之方格的資料列、資料行和一部分。 此外， Type 屬性會 DataGrid.HitTestType 傳回列舉。

方法 HitTest 會採用控制項的 DragDrop 、 DragEnter 、 DragOver 、、 MouseDown 、 MouseMoveMouseUp 和 事件所提供的 System.Windows.Forms.DataGrid x 和 MouseWheel y 引數。

另請參閱

• MouseDown