JSL Syntax Reference • JSL Messages • Display Boxes • Tree Node and Tree Box
Previous
 • 
Next
Tree Node and Tree Box
For the following messages, node stands for a tree node or a reference to one and root stands for a tree box or a reference to one.
node <<Append(<node_ref>)
Inserts a referenced tree node after this node’s children.
root <<Collapse(<node>)
Collapses the given tree node.
root <<Expand(<node>)
Expands the given tree node.
root <<Get Selected(<node>)
Gets the currently selected tree node.
–
In a single-item tree, the currently selected tree node or Empty is returned.
–
Multi-Select Tree Results shows the results for a Tree Box() that contains the MultiSelect argument.
Multi-Select Tree Results 
Items Selected in Tree
Result
no items selected
empty
single item selected
list of one tree node
multiple items selected
list of selected tree nodes
node <<Get Tip
Returns the tooltip for the node.
root <<Is Multiselect
Returns 1 for a MultiSelect tree and 0 for a single-select tree.
node <<Prepend(<node_ref>)
Inserts a tree node before this node’s children.
node <<Remove(<node>)
Removes the given tree node and all its children from the tree display box.
root <<Set Selected(node|{nodes}, <0|1>)
Selects the given tree node in the tree display box. In list of tree nodes, all nodes in the list are selected for MultiSelect trees. Otherwise, the first node in the list is selected. Specify the Boolean argument to indicate whether the node or nodes should be selected or unselected. The default value is 1, which selects the nodes.
Notes: 
•
On Windows, the <<Set Selected() message expands all nodes between the selected node or nodes and the root of the tree; items that are selected deep within the tree are shown. The expansion state does not change for nodes that were previously selected.
•
On Macintosh, <<Set Selected() does not change the tree expansion state.
node <<Set Tip("text")
Specifies a tooltip for the node.

Previous
 • 
Next
Help created on 9/19/2017