TcxCustomDBTreeList.FindNodeByKeyValue(Variant,TcxTreeListNode,Boolean,Boolean) Method

Locates a TreeList node by its key field value (also called the unique identifier).

Declaration

function FindNodeByKeyValue(const AKeyValue: Variant; AStartNode: TcxTreeListNode = nil; AExpandedOnly: Boolean = False; AForward: Boolean = True): TcxDBTreeListNode;

Parameters

Name	Type
AKeyValue	Variant
AStartNode	TcxTreeListNode
AExpandedOnly	Boolean
AForward	Boolean

Returns

Type
TcxDBTreeListNode

Remarks

AKeyValue specifies the node’s unique identifier.

AStartNode specifies the node from which the search starts.

AExpandedOnly specifies whether the child nodes of expanded parents are involved in the search.

AForward specifies the search direction.

If found, this function returns the located node; otherwise – nil.