Tree Control Notify Events

The following describes the Notify Events for Tree Controls in BBj 3.0 and higher:

Template for events

For codes 1-4: "context:u(2),code:u(1),id:u(2),objtype:i(2),node:u(4)"

For code 5: "context:u(2),code:u(1),id:u(2),objtype:i(2),node:i(4),buf:c(1*)"

For code 5 in BBj 12.0 and higher: "context:u(2),code:u(1),id:u(2),objtype:i(2),node:i(4),buf:c(1*),old:c(1*)"

For code 5 in BBj 20.21 and higher: "context:u(2),code:u(1),id:u(2),objtype:i(2),node:i(4),buf:c(1*),old:c(1*),canceled:n(1*)"

For codes 6-8: "context:u(2),code:u(1),id:u(2),objtype:i(2),wparam:i(4),lparam:i(4),node:i(4),x:i(2),y:i(2)"

For codes 6-8 in BBj 9.0 and higher: "context:u(2),code:u(1),id:u(2),objtype:i(2),wparam:i(4),lparam:i(4),node:i(4),x:i(2),y:i(2),button:i(1),exactnode:i(4)"

Name	Code	Description
Tree Node Selected	1	Tree node selected; node contains id of node.
Tree Node Deselected	2	Tree node deselected; node contains id of node.
Tree Node Expanded	3	Tree node expanded (opened); node contains id of node.
Tree Node Collapsed	4	Tree node collapsed (closed); node contains id of node.
Node Edit Stopped	5	Editing has stopped on a node, node contains id of node and buf contains new text in the node. In BBj 12.0 and higher, old contains the old node text. In BBj 20.21 and higher, canceled returns 0 if editing was stopped normally or 1 if editing was canceled by hitting ESCAPE.
Left Mouse Clicked	6	Left mouse button clicked. If mouse was down then lparam = 1, else if mouse is up lparam = 0. node = the closest node to the mouse click or 0 if no nodes are in the tree. x and y are the coordinates of the mouse click, with the top left corner of the control being 0,0. wparam contains bit $01$ if the CTRL key is down, and $02$ if the SHIFT key is down. In BBj 12.0 and higher, wparam contains bit $04$ if the ALT key is down and $08$ if the META (macOS CMD) key is down. In BBj 9.0 and higher, exactnode contains the precise node of the mouse click, or -1 if the click did not occur on a specific node. In BBj 8.0 and higher, button contains 0 (left mouse button).
Left Mouse Double Clicked	7	Left mouse button double-clicked. node = the closest node to the mouse click or 0 if no nodes are in the tree. x and y are the coordinates of the mouse click, with the top left corner of the control being 0,0. wparam contains bit $01$ if the CTRL key is down and $02$ if the SHIFT key is down. In BBj 12.0 and higher, wparam contains bit $04$ if the ALT key is down and $08$ if the META (macOS CMD) key is down. In BBj 9.0 and higher, exactnode contains the precise node of the mouse click, or -1 if the click did not occur on a specific node. In BBj 8.0 and higher, button contains 0 (left mouse button).
Right Mouse Clicked	8	Right mouse button clicked. If mouse was down then lparam = 1, else if mouse is up lparam = 0. node = the closest node to the mouse click or 0 if no nodes are in the tree. x and y are the coordinates of the mouse click, with the top left corner of the control being 0,0. wparam contains bit $01$ if the CTRL key is down and $02$ if the SHIFT key is down. In BBj 12.0 and higher, wparam contains bit $04$ if the ALT key is down and $08$ if the META (macOS CMD) key is down. In BBj 9.0 and higher, exactnode contains the precise node of the mouse click, or -1 if the click did not occur on a specific node. In BBj 8.0 and higher, button contains 0 (left mouse button).

Tree Control Notify Events

Template for events

See Also