AddTreeViewNode ( text$,parent_node[,icon] )
Parameters
|
text$ - label of the new node parent_node - node to add the new node under; use TreeViewRoot for a top-level node icon (optional) - zero-based index into the tree view's icon strip; -1 for no icon (default) |
Description
|
Adds a new node under a tree view node and returns its handle. Appends the new node as the last child of parent_node. For a top-level node, pass the invisible root you get from TreeViewRoot. The returned handle is a positive, type-checked ID you keep to select, expand, rename or free the node later. This is how you build the classic editor hierarchy: a Scene node under the root, then cameras, lights and objects as children - exactly the pattern the samples use. Node text is UTF-8, and an icon from the strip assigned with SetGadgetIconStrip can be shown by passing its index. To place a node at a specific position among its siblings instead of at the end, use InsertTreeViewNode. When the user clicks a node, the tree posts a gadget-action event ($401); read SelectedTreeViewNode to find out which node it was. See it working in the tree and text area sample and throughout the world editor shell sample. Requires Extended mode. See also: InsertTreeViewNode, TreeViewRoot, CountTreeViewNodes, SelectTreeViewNode, ModifyTreeViewNode, FreeTreeViewNode. |
Index