Command: treenode

Syntax

treenode <ident>

or

treenode <assign> {,<assign> ...}

Description

To create one or more treenode identifiers. Treenode identifiers are pointers to node objects in a tree window.

Parameters

• <assign>: <ident> = <treenode>

• <ident>
  The name of the identifier.

• <treenode>
  Another treenode identifier or a function returning a treenode.

Switches

None

Notes

Treenode identifiers are not usable until they point to a valid tree window node. Until then they have a null value.

Window tree nodes are created automatically by the wtree command. Each node is also given a unique handle of the form tn<x> where x is a hexadecimal number. Any treenode then pointing to the external object has the value tn<x>. The node may also be referenced via tn<x>.

Deleting a treenode identifier will not delete the tree window node to which it points. This must be done by using the treenode member function kill. When a window tree node is "killed" all treenode identifiers pointing to it are automatically nullified (but not deleted).

Examples

Create a new un-initialized treenode identifier.

treenode mynode

Use a treenode to delete the currently selected node in a tree window.

treenode t = mywin.selected_node
if (t) t.kill

See Also