blt_treenodeid(3) [debian man page]

Blt_TreeNodeId(3)					      BLT Library Procedures						 Blt_TreeNodeId(3)

__________________________________________________________________________________________________________________________________________________

NAME

       Blt_TreeNodeId - Returns the node serial number.

SYNOPSIS

       #include <bltTree.h>

       unsigned int
       Blt_TreeNodeId(node)

ARGUMENTS

       Blt_TreeNode   node   (in)      Node whose ID is to be returned.
_________________________________________________________________

DESCRIPTION

       This  procedure	returns the node serial number.  The node serial number is useful for programs that export the tree data object to the Tcl
       programming level.  Since node labels (and therefore pathnames) are not unique, the ID can be used to uniquely identify a node.

       The arguments are as follows:

       node	 The node whose serial number is returned.  The serial number of the root node for example is always 0.

RETURNS

       The serial number of the node.  Nodes are given a unique serial number when they are created.  You can use the ID  to  later  retrieve  the
       node using Blt_TreeGetNode.

EXAMPLE

       The following example prints the ID of a node.

	      printf("root ID is %s
", Blt_TreeNodeId(node));

KEYWORDS

       Tcl_TreeCreateNode, Tcl_TreeDeleteNode

BLT
									2.4							 Blt_TreeNodeId(3)

Blt_TreeDeleteNode(3)					      BLT Library Procedures					     Blt_TreeDeleteNode(3)

__________________________________________________________________________________________________________________________________________________

NAME

       Blt_TreeDeleteNode - Deletes a node and its descendants.

SYNOPSIS

       #include <bltTree.h>

       Blt_TreeNode
       Blt_TreeDeleteNode(tree, node)

ARGUMENTS

       Blt_Tree       tree   (in)      Tree containing the node.

       Blt_TreeNode   node   (in)      Node to be deleted.
_________________________________________________________________

DESCRIPTION

       This procedure deletes a given node and all it descendants from a tree data object.

       The arguments are as follows:

       tree	 The tree containing the parent node.

       node	 Node  to  be  deleted.  The node and its descendant nodes are deleted.  Each node's data values are deleted also.   The reference
		 count of the Tcl_Obj is decremented.

       Since all tree objects must contain at least a root node, the root node itself can't 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.

RETURNS

       Always returns TCL_OK.  Errors generated in a notification callbacks are backgrounded (see Tcl_TreeCreateNotifyHandler).

EXAMPLE

       The following example deletes the root node.

	      Blt_TreeNode root;

	      root = Blt_TreeRootNode(token);
	      Blt_TreeDeleteNode(token, root);

NOTIFICATIONS

       Blt_TreeDeleteNode  can	trigger  tree notify events.  You can be notified whenever a node is deleted by using the Blt_TreeCreateNotifyHan-
       dler.  A callback routine is registered that will be automatically invoked whenever a node is deleted via Blt_TreeDeleteNode to the tree.

KEYWORDS

       tree, token

BLT
									2.4						     Blt_TreeDeleteNode(3)