TTreeNode.FindNode function

Declaration

function FindNode(const NodeText: string): TTreeNode

Arguments

Function result

The TTreeNode instance in Items with the specified value, or Nil if not found.

Description

FindNode is a TTreeNode function used to get the child node with the text specified in NodeText.

FindNode examines the child nodes in the Items property. The GetFirstChild method is called to get the first child node in Items. Each tree node in Items is examined after calling GetNextSibling until a node with the requested value is located.

The return value is the TTreeNode instance with a Text property that matches the value in NodeText, or Nil if a tree node is not found.

When the CaseInsensitiveFilenames compiler define is enabled, the SameText routine in SysUtils is called to perform a case-insensitive comparison using the text in the nodes and the value in NodeText. Otherwise, case is significant in the comparisons.

Use methods in the TTreeNodes container to locate tree nodes not in the current subtree; i. e. FindNodeWithText or FindNodeWithTextPath.

See also

• Text
• GetFirstChild
• GetNextSibling
• FindNodeWithText
• FindNodeWithTextPath