HitTest Method
TOC
Collapse the table of content
Expand the table of content

DataGridView.HitTest Method

Returns location information, such as row and column indices, given x- and y-coordinates.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public HitTestInfo HitTest (
	int x,
	int y
)
public HitTestInfo HitTest (
	int x, 
	int y
)
public function HitTest (
	x : int, 
	y : int
) : HitTestInfo
Not applicable.

Parameters

x

The x-coordinate.

y

The y-coordinate.

Return Value

A DataGridView.HitTestInfo that contains the location information.

You can use this method to determine which part of the DataGridView control is located at the specified coordinates. For example, you can call this method—specifying the coordinates of a mouse click—to determine the row and column indexes of the clicked cell or whether a header cell or scroll bar was clicked.

The following code example illustrates the use of this method. This example is part of a larger example available in the Columns property reference topic.

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];
        }
    }
}

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2016 Microsoft