Tree Control Notify Events

The following describes the Notify Events for Tree Controls in BBj 3.00 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.00 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.00 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.00 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.00 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.00 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.00 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.00 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.00 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.00 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.00 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.00 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.00 and higher, `button` contains 0 (left mouse button).

Tree Control Notify Events

Template for events

See Also