TreeList.GetVisibleIndexByNode(TreeListNode) Method

Returns the index of the specified node among the visible nodes.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v18.2.dll

Declaration

C#

public int GetVisibleIndexByNode(
    TreeListNode node
)

VB.NET

Public Function GetVisibleIndexByNode(
    node As TreeListNode
) As Integer

Parameters

Name	Type	Description
node	TreeListNode	The TreeListNode object representing the node whose visible index is obtained.

Returns

Type	Description
Int32	An integer value specifying the position of the specified node among the visible nodes.

Remarks

A node is implied invisible if it is a child of a collapsed node. The GetVisibleIndexByNode returns a zero or a greater value when the node is out of the Tree List’s viewable area due to the current scrolling position (see the TreeList.TopVisibleNodeIndex property). This method returns -1 in the cases listed below:

• the specified node is null (Nothing in Visual Basic);
• the specified node is a child of a collapsed node.

Example

The sample code below demonstrates how to determine whether a user sees a given node within the Tree List’s scrollable area. The IsNodeVisibleOnScreen method returns false if the node is invisible or only partially visible at the bottom of the Tree List control.

C#

private bool IsNodeVisibleOnScreen(DevExpress.XtraTreeList.Nodes.TreeListNode node) {
   DevExpress.XtraTreeList.TreeList tree = node.TreeList;
   int visibleIndex = tree.GetVisibleIndexByNode(node);
   return visibleIndex >= tree.TopVisibleNodeIndex && visibleIndex < 
     tree.TopVisibleNodeIndex + tree.ViewInfo.VisibleRowCount;
}

VB.NET

Imports DevExpress.XtraTreeList.Nodes

Private Function IsNodeVisibleOnScreen(ByVal node As TreeListNode) As Boolean
   Dim tree As DevExpress.XtraTreeList.TreeList = node.TreeList
   Dim visibleIndex As Integer = tree.GetVisibleIndexByNode(node)
   Return visibleIndex >= tree.TopVisibleNodeIndex AND visibleIndex < _
     tree.TopVisibleNodeIndex + tree.ViewInfo.VisibleRowCount
End Function

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the GetVisibleIndexByNode(TreeListNode) 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.

VB.NET

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

For Each column As TreeListColumn In node.TreeList.Columns
    If block.Contains(column.VisibleIndex, node.TreeList.GetVisibleIndexByNode(node)) Then
        result_Renamed &= node.GetDisplayText(column)

how-to-navigate-to-the-last-summary-using-keyboard-navigation-e379/VB/WindowsApplication255/Form1.vb#L27

If treeList1.FocusedNode Is last AndAlso last.NextVisibleNode Is Nothing Then
    treeList1.TopVisibleNodeIndex = treeList1.GetVisibleIndexByNode(ri.Node)
End If

C#

how-to-preserve-the-expanded-state-of-treelist-nodes-when-refreshing-data-e864/CS/TreeListViewState.cs#L61

    if(topVisibleNode == null) topVisibleNode = TreeList.FocusedNode;
    TreeList.TopVisibleNodeIndex = TreeList.GetVisibleIndexByNode(topVisibleNode);
}

how-to-navigate-to-the-last-summary-using-keyboard-navigation-e379/CS/WindowsApplication255/Form1.cs#L30

    if (treeList1.FocusedNode == last && last.NextVisibleNode == null)
        treeList1.TopVisibleNodeIndex = treeList1.GetVisibleIndexByNode(ri.Node);
}