Description:  Allows to use a context menu when right clicking the tree or not 
Syntax:  {boolean„'} 'obj' Œwi 'allowcontextmenu' {boolean} 
boolean: 1(default)=right click displays a context menu, 0=right click has no effect 
Example: 
      'ff.tree' Œwi 'allowcontextmenu'1 

Description:  Allows to drag and drop a branch of the tree on to another branch 
Syntax:  {boolean„'} 'obj' Œwi 'allowdragdrop' {boolean} 
boolean: 1(default)=drag & drop is allowed, 0=drag & drop has no effect 
Example: 
      'ff.tree' Œwi 'allowdragdrop'1 

Description:  Display check boxes to the left of tree items or not 
Syntax:  {boolean„'} 'obj' Œwi 'checkbox' {boolean} 
boolean: 1=display check boxes, 0(default)=do not display check boxes 
Example: 
      'ff.tree' Œwi 'checkbox'1 

Description:  Indicate which item check boxes should be checked 
Syntax:  {booleanvec„'} 'obj' Œwi 'checked' {booleanvec} 
booleanvec:  boolean vector with 1's for items which check boxes are checked 
Note:  show Check Boxes even if they were not visible before <checked> is called 
Example: 
      'ff.tree' Œwi 'checked'1 0 0 1 0 0 0 1 1 
      'ff.tree' Œwi 'checked'1               © check all items 
      'ff.tree' Œwi 'checked'1 0             © check every other item 

Description:  Return current object class 
Syntax:  class„'obj' Œwi 'class' 

Description:  Allows to specify additional data attached to tree branches 
Syntax:  {data„'} 'obj' Œwi 'data' {nestedmatrix} 
nestedmatrix:  a nested matrix of data which number of rows matches the *list property number of rows 
Example: 
      'ff.tree' Œwi 'data' (3 3½'APL+Win'1000 1 'APL+Unx'3000 1 'APL+Dos'500 0) 

Description:  Indicate the tree item depths for all tree items 
Syntax:  {depths„'} 'obj' Œwi 'depths' {depths} 
depths:  integer vector representing the depths of all the tree items 
Example: 
      'ff.tree' Œwi 'depths'1 2 2 3 4 5 2 3 4 

Description:  Indicate whether the dropped items should become children of root or of target item on which they are dropped 
Syntax:  {boolean„'} 'obj' Œwi 'dropatrootlevel' {boolean} 
boolean:  1=drop as children of root  0=drop as children of target item level 
Example: 
      'ff.tree' Œwi 'dropatrootlevel'1 

Example: 
0 0½'ff' Œwi '*Create' 'TForm5' ('*size'300 400) 'DemoShow' 
0 0½'ff.tree' Œwi '*Create' 'TTree5' ('wherelc'Ð Ð '>' '>') ('attach'1 2 3 4) 
0 0½'tree' Œwi 'treeex'1 0 0(1 2 2 3 4 4 2 3 2) ('Label1' 'Label2' 'Label3' 'Label4' 'Label5' 'Label6' 'Label7' 'Label8' 'Label9') (9½›23 24 0 0) (9½›'') 
0 0½'tree' Œwi 'ExpandTree' 
'tree'Gets5 5 
‘tree 
© Another way to work with the Tree object 
0 0½'ff' Œwi '*Create' 'TForm5' ('*caption' 'TTree5 Example') ('*size'300 400) 'DemoShow' 
0 0½'ff' Œwi '*.tree.Create' 'TTree5' ('wherelc'Ð Ð'>' '>'0'>5+Objects') ('caption' 'Objects') 
0 0½'ff' Œwi '.tree.attach'1 2 3 4 
labels„œ'TObject5' 'TForm5' 'TEdit5' 'TEditList5' 'TEditSpin5' 'TCombo5' 'TComboFilter5' 
sons„7 2½  1 ¯1     2 1     3 1       4 3         5 3        6 1        7 6 
images„122 121 0 0 
0 0½'ff' Œwi '.tree.list'sons labels images 
0 0½'ff' Œwi '*.tree.Expand' 'expandbranch'1 
0 0½'ff' Œwi '.tree.Check'2 ¯3 5             © add check boxes to nodes 2 3 and 5 and check 2 and 5 
0 0½'ff' Œwi '.tree.Check' (¼7) 
0 0½'ff' Œwi '.tree.RemoveCheckBox'1 3 4 6 

Description:  Get or Set the tree item id numbers 
Syntax:  {intvec„'} 'obj' Œwi 'ids' {intvec} 
intvec:  an integer vector of the tree items id numbers 
Example: 
      'ff.tree' Œwi 'ids'1 7 6 5 4 3 2 8 9 

Description:  Indicate whether an image should be displayed to the left of tree items or not 
Syntax:  {boolean„'} 'obj' Œwi 'image' {boolean} 
boolean:  1(default)=an image is displayed to the left of tree items, 0=no image is displayed 
Example: 
      'ff.tree' Œwi 'image'1 

Description:  Get or Set the image numbers for all the tree items 
Syntax:  {images„'} 'obj' Œwi 'images' {images} 
images:  a 4-column integer matrix representing tree item images 
         [;1] „… image for non selected node 
         [;2] „… image for selected node 
         [;3] „… index to an overlay image 
         [;4] „… index to a user-state image (default=0) 
Example: 
      'ff.tree' Œwi 'images' (9 4½68 78 0 0) 

Description:  Get or Set the tree item labels 
Syntax:  {labels„'} 'obj' Œwi 'labels' {labels} 
labels:  a nested vector of labels for all the tree items 
Example: 
      'ff.tree' Œwi(›'labels'),(›'Test '),¨•¨¼9 

Description:  Set or return the TTree list property 
Syntax:  'obj' Œwi 'list'tree labels {images} {style} 
tree:    2-column integer matrix with son ids in column 1 and father ids in column 2 
labels:  character matrix of sons tree labels 
    or   vector of character vectors of tree labels 
images:  a b 0 0 where a & b are image indices in BUTTONS.BMP for non active & active nodes 
style:   (optional) a nested vector of styles being a subset of: 
         'highlightbold' 'highlightcut' 'highlightdrop' 'highlightselect' 
Example: 
      'ff.tree' Œwi 'list' (4 2½1 0 2 1 3 2 4 1) (œ'Node1' 'Node2' 'Node3' 'Node4') (23 24 0 0) '' 
R„C TreeMat I- Draw tree from node I" 
C „… Incidence matrix" 
I „… Node number from which to draw the tree" 
R „… Tree drawn as an integer matrix" 
The final tree matrix must be:   (0,tree[;Œio])[Œio+R]" 
Requires: -" 
(c) Eric Lescasse[3jan92]" 

Description:  Tells if the Move methods (MoveUp, MoveDn, MoveRight and MoveLeft) also move the topic children 
Syntax:  {boolean„'} 'obj' Œwi 'movechildren' {boolean} 
boolean:  1=move children with topic; 0=don't 
Example: 
      'ff.tree' Œwi 'movechildren'1 

Description:  Get or Set state information for all nodes 
Syntax:  'obj' Œwi 'states' {states} 
states:  a nested vector of nested vector containing state information for all tree nodes 
         Each nested vector contains a subset of the following items: 
         'highlightbold' 'highlightcut' 'highlightdrop' 'highlightselect' 'expanded' 
         'expandedonce' 'haschildren' 'forceparent' 
Example: 
      'ff.tree' Œwi 'states' (9½›'highlightbold' 'expanded') 
      aaa„'ff.tree' Œwi 'states' 
      aaa[4]„›'highlightbold' 
      'ff.tree' Œwi 'states'aaa 

Description:  Get or set a nested matrix representing a tree and optionnally addtional data associated with tree branches 
Syntax:  'obj' Œwi 'tree' {nestedmatrix} 
nestedmatrix:  a nested APL matrix with at least 2 columns: 
nestedmatrix[;1] „… tree node depths (starting at 1 for root) 
nestedmatrix[;2] „… tree node labels 
nestedmatrix[;3] „… 0(default) or (a b 0 0) where a & b are image indices into BUTTONS.BMP 
nestedmatrix[;4] „… '' or a nested vector containing any subset of: 
                    'highlightbold' 'highlightcut' 'highlightdrop' 'highlightselect' 'expanded' 
                    'expandedonce' 'haschildren' 'forceparent' 
0 4‡nestedmatrix „… additional tree node data 
Example: 
      'ff.tree' Œwi 'tree' (4 4½1'Node1' (23 24 0 0) ('highlightbold' 'highlightselect')2'Node2' (23 24 0 0) ''3'Node3' (23 24 0 0) ''4'Node4' (23 24 0 0) '') 

Description:  Get or Set the extended tree property describing the Tree content 
Syntax:  'obj' Œwi 'tree'image checkbox ids depths{labels}{image indices}{state information} 
image: 0=do not display images or 1=display images 
checkbox: 0=do not display check boxes or 1=display check boxes 
ids: Ð=number nodes from 1 to N or vector of node numbers 
depths: vector of node depths 
labels: vector of node labels 
imageindices: vector of 44-element vectors of image indices 
stateinformation: vector of node state information 
Example: 
      'ff.tree' Œwi 'treeex'0 1(¼4) (1 2 3 2) ('Node1' 'Node2' 'Node3' 'Node4') (›23 24 0 0) ('' '' ('highlightbold' 'highlightselect') '') 

Description:  Add check boxes to the tree for specified nodes 
Syntax:  'obj' Œwi 'AddCheck'nodenos 
nodenos:  node numbers 
Example: 
      'ff.tree' Œwi 'AddCheckBox'1 3 4 

Description:  Add a child node at the bottom of the currently active node 
Syntax:  'obj' Œwi 'AddNode' 
Example: 
      'ff.tree' Œwi 'AddNode' 

Description:  Get or Set the check boxes for one or more or all nodes 
Syntax:  'obj' Œwi 'CheckBox'nodes 
nodes:  node numbers 
        (check boxes if nodes are >0, uncheck them if nodes are <0) 
Example: 
      'ff.tree' Œwi 'Check'1 ¯3 4 

Description:  Return all node ids of the branch which start at a given node id 
Syntax:  nodeids„'obj' Œwi 'Children'nodeid 
nodeid:  a node identifier 
nodeids:  its children 
Example: 
      'ff.tree' Œwi 'Children'5 
5 6 7 8 

Description:  Collapses all tree branches 
Syntax:  'obj' Œwi 'CollapseTree' 
Example: 
      'ff.tree' Œwi 'CollapseTree' 

Description:  Deletes the currently active node.  Asks for confirmation. 
Syntax:  'obj' Œwi 'DeleteNode' 
Example: 
      'ff.tree' Œwi 'DeleteNode' 

Description:  Expands all tree branches 
Syntax:  'obj' Œwi 'ExpandTree' 
Example: 
      'ff.tree' Œwi 'ExpandTree' 

Description:  Move the current node and all of its descendant down in the tree, retaining its depth 
Syntax:  'obj' Œwi 'MoveDown' 
Example: 
      'ff.tree' Œwi 'MoveDown' 

Description:  Move the current node and all of its descendant up in the tree, retaining its depth 
Syntax:  'obj' Œwi 'MoveUp' 
Example: 
      'ff.tree' Œwi 'MoveUp' 

Description:  Return the vector of all node depths (i.e. second column of the <list> property, but more efficiently) 
Syntax:  depths„'obj' Œwi 'Nodedepths' 
depths:  an integer vector of all node depths in <list> order 
Example: 
      'ff.tree' Œwi 'NodeDepths' 

Description:  Return the vector of all node ids and depths (i.e. first 2 columns of the <list> property, but more efficiently) 
Syntax:  nodeids„'obj' Œwi 'NodeIdDepths' 
nodeids:  a 2-column integer matrix in <list> order ([;1]=nodes, [;2]=depths) 
Example: 
      'ff.tree' Œwi 'NodeIds' 

Description:  Return the vector of all node ids (i.e. first column of the <list> property, but more efficiently) 
Syntax:  nodeids„'obj' Œwi 'NodeIds' 
nodeids:  a numeric vector of all node ids in <list> order 
Example: 
      'ff.tree' Œwi 'NodeIds' 

Description:  Remove check boxes from the tree for the specified nodes 
Syntax:  'obj' Œwi 'RemoveCheck'nodes 
nodes:  node numbers 
Example: 
      'ff.tree' Œwi 'RemoveCheckBox'3 

Description:  Sort all children alphabetically for all tree nodes 
Syntax:  'obj' Œwi 'SortAllNodes' 
Example: 
      'ff.tree' Œwi 'SortAllNodes' 

Description:  Make the current node a top level node 

Description:  Calculates incidence matrix from a tree matrix 
Syntax:  'obj' Œwi 'TreeIm'tree 
tree:  a 2-column integer matrix with sons in column 1 and fathers in column 2 
Example: 
      'ff.tree' Œwi 'TreeIm' (5 2½1 0 2 1 3 2 4 1 5 3)