Name

uiInsertNode — Insertion in a Tree

Calling Sequence

insertTree = uiInsertNode(tree, position, node)
insertTree = uiInsertNode(tree, parentNode, node)

Input parameters

tree

Tree were we do the insertion

position

a string, which is the position where we want to insert the node

parentNode

which is the parent node into we want to insert the node

node

node we want to insert

Output parameters

insertTree

a Tree with the node inserted

Description

Insertion of a node (subTree) into a tree. If we have 2 nodes called 'Node1' and 'Node2' each one at position 1.1 and 1.2. Insertion of a new node 'Node3' at position '1.2', will move the 'Node2' to position 1.3.

Examples

 
// We should create nodes(subTrees) before creating trees	
leaf11 = uiCreateNode('leaf 1.1', 'iconLeaf1.1', 'callbackLeaf1.1')
leaf12 = uiCreateNode('leaf 1.2', 'iconLeaf1.2', 'callbackLeaf1.2')
leaf31 = uiCreateNode('leaf 3.1', 'iconLeaf3.1', 'callbackLeaf3.1')
leaf32 = uiCreateNode('leaf 3.2', 'iconLeaf3.2', 'callbackLeaf3.2')
node1 = uiCreateNode('Node 1', 'iconNode1', 'callbackNode1')
node2 = uiCreateNode('Node 2', 'iconNode2', 'callbackNode2')
node3 = uiCreateNode('Node 3', 'iconNode3', 'callbackNode3')
root = uiCreateNode('Root', 'iconRoot', 'callbackRoot')

treeNode1 = uiCreateTree(node1, leaf11, leaf12)
treeNode3 = uiCreateTree(node3, leaf31, leaf32)
treeRoot = uiCreateTree(root, treeNode1, node2, treeNode3)

// Creation of a new nodes to insert
leaf13 = uiCreateNode('leaf 1.3', 'iconLeaf1.3', 'callbackLeaf1.3')
testNode = uiCreateNode('test', 'icon_test', 'callback_test')

// Insertion of 'leaf13' in 'node2'
treeInsert = uiInsertNode(treeRoot, node2, leaf13)
uiDisplayTree(treeInsert)

// Insertion of 'testNode' at position '1.1'
treeInsert = uiInsertNode(treeRoot, '1.1', testNode)
uiDisplayTree(treeInsert)

 

See Also

uiCreateNode , uiCreateTree , uiDisplayTree , uiDumpTree , uiDeleteNode , uiConcatTree , uiEqualsTree , uiFindNode , uiGetParentNode , uiGetChildrenNode , uiGetNodePosition