GridHitInfo Class

Contains information about a specific point within a Grid View.

Namespace: DevExpress.XtraGrid.Views.Grid.ViewInfo

Assembly: DevExpress.XtraGrid.v24.2.dll

Declaration

C#

public class GridHitInfo :
    BaseHitInfo

VB.NET

Public Class GridHitInfo
    Inherits BaseHitInfo

Related API Members

The following members return GridHitInfo objects:

• DragGridEventArgs.HitInfo
• GridView.CalcHitInfo(Int32, Int32)
• GridView.CalcHitInfo(Point)
• PopupMenuShowingEventArgs.HitInfo
• RowClickEventArgs.HitInfo

Remarks

GridHitInfo objects can be created by calling the desired View’s GridView.CalcHitInfo method. This method requires the test point as a parameter.

GridHitInfo class properties can be grouped into three logical categories:

• properties identifying the View element that contains the test point. For instance, the GridHitInfo.Column and GridHitInfo.RowHandle properties identify the column and row whose elements are under the test point;
• properties indicating whether the test point resides over a particular View element. For instance, the GridHitInfo.InColumnPanel property indicates whether the test point is over the column header panel;
• the GridHitInfo.HitTest property identifying the type of element located under the test point.

Example

The following sample code shows how to identify the element located at a specific point using the GridView.CalcHitInfo method.

In the example, the CalcHitInfo method is called when you move the cursor over a Grid Control. The name of the current View element is displayed in the form’s caption.

C#

using DevExpress.XtraGrid;
using DevExpress.XtraGrid.Views.Base;
using DevExpress.XtraGrid.Views.Base.ViewInfo;
using DevExpress.XtraGrid.Views.Grid.ViewInfo;
// ...
private void gridControl1_MouseMove(object sender, MouseEventArgs e) {
    GridControl grid = sender as GridControl;
    if (grid == null) return;
    // Get a View at the current point.
    BaseView view = grid.GetViewAt(e.Location);
    if (view == null) return;
    // Retrieve information on the current View element.
    BaseHitInfo baseHI = view.CalcHitInfo(e.Location);
    GridHitInfo gridHI = baseHI as GridHitInfo;
    if (gridHI != null)
        Text = gridHI.HitTest.ToString();
}

VB.NET

Imports DevExpress.XtraGrid
Imports DevExpress.XtraGrid.Views.Base
Imports DevExpress.XtraGrid.Views.Base.ViewInfo
Imports DevExpress.XtraGrid.Views.Grid.ViewInfo
' ...
Private Sub GridControl1_MouseMove(ByVal sender As System.Object, _
  ByVal e As System.Windows.Forms.MouseEventArgs) _
  Handles GridControl1.MouseMove
    Dim grid As GridControl = sender
    If grid Is Nothing Then
        Return
    End If
    ' Get a View at the current point.
    Dim view As BaseView = grid.GetViewAt(e.Location)
    If view Is Nothing Then
        Return
    End If
    ' Retrieve information on the current View element.
    Dim baseHI As BaseHitInfo = view.CalcHitInfo(e.Location)
    Dim gridHI As GridHitInfo = TryCast(baseHI, GridHitInfo)
    If Not gridHI Is Nothing Then
        Text = gridHI.HitTest.ToString()
    End If
End Sub

Inheritance

Object

BaseHitInfo

GridHitInfo

BandedGridHitInfo