Export (0) Print
Expand All

DataGridView.HitTestInfo Class

Contains information, such as the row and column indexes, about a specific coordinate pair in the DataGridView control. This class cannot be inherited.

System.Object
  System.Windows.Forms.DataGridView.HitTestInfo

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public sealed class HitTestInfo

The DataGridView.HitTestInfo type exposes the following members.

  NameDescription
Public propertyColumnIndexGets the index of the column that contains the coordinates described by the current DataGridView.HitTestInfo.
Public propertyColumnXGets the x-coordinate of the beginning of the column that contains the coordinates described by the current DataGridView.HitTestInfo.
Public propertyRowIndexGets the index of the row that contains the coordinates described by the current DataGridView.HitTestInfo.
Public propertyRowYGets the y-coordinate of the top of the row that contains the coordinates described by the current DataGridView.HitTestInfo.
Public propertyTypeGets the DataGridViewHitTestType that indicates which part of the DataGridView the coordinates described by the current DataGridView.HitTestInfo belong to.
Top

  NameDescription
Public methodEqualsDetermines whether the specified Object is equal to the current DataGridView.HitTestInfo. (Overrides Object.Equals(Object).)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Overrides Object.GetHashCode().)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents a DataGridView.HitTestInfo. (Overrides Object.ToString().)
Top

  NameDescription
Public fieldStatic memberNowhereSpecifies that the point is not on a cell or cell header. This field is read-only.
Top

The HitTest method of the DataGridView class returns a DataGridView.HitTestInfo. 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 type. This example is part of a larger example available in the DataGridView.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];
            }
        }
    }


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2014 Microsoft