Manual Reference Pages - BLT_TREEDELETENODE (3)
Blt_TreeDeleteNode - Deletes a node and its descendants.
Tree containing the node.
Node to be deleted.
This procedure deletes a given node and all it descendants from a tree
The arguments are as follows:
Since all tree objects must contain at least a root node, the root
node itself cant be deleted unless the tree is released and
destroyed. Therefore you can clear a tree by deleting its root, but
the root node will remain until the tree is destroyed.
The tree containing the parent node.
Node to be deleted. The node and its descendant nodes are deleted.
Each nodes data values are deleted also. The reference count of
the Tcl_Obj is decremented.
Always returns TCL_OK. Errors generated in a notification callbacks
are backgrounded (see Tcl_TreeCreateNotifyHandler).
The following example deletes the root node.
root = Blt_TreeRootNode(token);
Blt_TreeDeleteNode can trigger tree notify events.
You can be notified whenever a node is deleted by using the
Blt_TreeCreateNotifyHandler. A callback routine is registered
that will be automatically invoked whenever a node is deleted
via Blt_TreeDeleteNode to the tree.
|BLT ||BLT_TREEDELETENODE (3) ||2.5 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.