TBaseVirtualTree.InsertNode Method

Inserts a new node and returns it to the caller.

function InsertNode(Node: PVirtualNode; Mode: TVTNodeAttachMode; UserData: Pointer = nil): PVirtualNode;

Adds a new node relative to Node. The final position is determined by Mode. UserData can be used to set the first 4 bytes of the user data area to an initial value, which can be used in OnInitNode and will also cause to trigger the OnFreeNode event (if <> nil) even if the node is not yet "officially" initialized. 

InsertNode is a compatibility method and will implicitly validates the given node if the new node is to be added as child node. This is however against the virtual paradigm and hence I dissuade from its usage.

TBaseVirtualTree Class