TreeList.CalcHitInfo(Point) Method

Returns information about the Tree List’s elements which are located at the specified point.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v19.2.dll

Declaration

C#

public TreeListHitInfo CalcHitInfo(
    Point pt
)

VB.NET

Public Function CalcHitInfo(
    pt As Point
) As TreeListHitInfo

Parameters

Name	Type	Description
pt	Point	A Point structure which specifies test point coordinates relative to the Tree List’s top-left corner.

Returns

Type	Description
TreeListHitInfo	A TreeListHitInfo object which contains information about the Tree List’s elements located at the test point.

Remarks

Use the CalcHitInfo method to determine which element is located at a specified point. For instance, this can be used when handling the Tree List’s Click event to determine which element was clicked. In such instances, pass the current mouse pointer’s coordinates as the method’s parameter.

Example

The code below obtains the name of the element located under the mouse pointer. The MouseMove event is handled to track mouse pointer movement.

C#

using DevExpress.XtraTreeList;
//...
private void treeList1_MouseMove(object sender, System.Windows.Forms.MouseEventArgs e) {
   TreeListHitInfo hi = treeList1.CalcHitInfo(new Point(e.X, e.Y));
   string elementName = hi.HitInfoType.ToString();
   //...
}

VB.NET

Imports DevExpress.XtraTreeList
'...
Private Sub TreeList1_MouseMove(ByVal sender As Object, _
ByVal e As System.Windows.Forms.MouseEventArgs) _
Handles TreeList1.MouseMove
   Dim hi As TreeListHitInfo = TreeList1.CalcHitInfo(New Point(e.X, e.Y))
   Dim ElementName As String = hi.HitInfoType.ToString()
   ' ...
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CalcHitInfo(Point) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-highlight-a-target-node-during-the-drag-drop-operation-e2074/CS/WindowsApplication1/DnDHighlightHelper.cs#L76

Point p = treeList.PointToClient(new Point(e.X, e.Y));
TreeListHitInfo hitInfo = SelectedTreeList.CalcHitInfo(p);
if (hitInfo.Node == null)

how-to-implement-block-selection-for-treelist-cells-e2176/CS/BlockSelection/BlockSelector.cs#L58

{
    TreeListHitInfo hInfo = fList.CalcHitInfo(e.Location);
    if (hInfo.HitInfoType == HitInfoType.RowIndicator)

how-to-show-an-image-for-a-hot-tracked-node-on-mouse-move-e3564/CS/TreeListDrawImage/DrawHelper.cs#L65

Point pt = tree.PointToClient(Control.MousePosition);
var hitInfo = tree.CalcHitInfo(pt);
if (hitInfo.HitInfoType == HitInfoType.RowIndicator)

implement-the-addnewnode-method-in-treelist-like-the-addnewrow-one-in-gridcontrol-e4190/CS/WindowsFormsApplication1/MyTreeList.cs#L53

protected override void OnMouseDown(MouseEventArgs e) {
    TreeListHitInfo info = this.CalcHitInfo(e.Location);
    if (info.HitInfoType == HitInfoType.Cell) {

how-to-use-a-custom-usercontrol-as-a-tooltip-e4533/CS/ToolTipControllerExample/Main.cs#L22

if(tree != null) {
    TreeListHitInfo hitInfo = tree.CalcHitInfo(e.ControlMousePosition);
    Record record = (Record)tree.GetDataRecordByNode(hitInfo.Node);

VB.NET

how-to-highlight-a-target-node-during-the-drag-drop-operation-e2074/VB/WindowsApplication1/DnDHighlightHelper.vb#L81

Dim p As Point = treeList.PointToClient(New Point(e.X, e.Y))
Dim hitInfo As TreeListHitInfo = SelectedTreeList.CalcHitInfo(p)
If hitInfo.Node Is Nothing Then

how-to-implement-block-selection-for-treelist-cells-e2176/VB/BlockSelection/BlockSelector.vb#L63

If e.Button = MouseButtons.Left Then
    Dim hInfo As TreeListHitInfo = fList.CalcHitInfo(e.Location)
    If hInfo.HitInfoType = HitInfoType.RowIndicator Then

how-to-implement-the-cells-multi-selection-feature-in-treelist-e2795/VB/WindowsApplication1/Helper/BlockSelector.vb#L54

Private Sub fList_PopupMenuShowing(ByVal sender As Object, ByVal e As PopupMenuShowingEventArgs)
    Dim hi As TreeListHitInfo = fList.CalcHitInfo(e.Point)
    If hi.HitInfoType = HitInfoType.Cell Then

how-to-show-an-image-for-a-hot-tracked-node-on-mouse-move-e3564/VB/TreeListDrawImage/DrawHelper.vb#L57

Dim pt As Point = tree.PointToClient(Control.MousePosition)
Dim hitInfo = tree.CalcHitInfo(pt)
If hitInfo.HitInfoType = HitInfoType.RowIndicator Then

implement-the-addnewnode-method-in-treelist-like-the-addnewrow-one-in-gridcontrol-e4190/VB/WindowsFormsApplication1/MyTreeList.vb#L55

Protected Overrides Sub OnMouseDown(ByVal e As MouseEventArgs)
    Dim info As TreeListHitInfo = Me.CalcHitInfo(e.Location)
    If info.HitInfoType = HitInfoType.Cell Then