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 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.

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 (Mac OS X 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 (Mac OS X 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 (Mac OS X 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).

 

See Also

BBjTreeNodeSelectedEvent

BBjTreeNodeDeselectedEvent

BBjTreeNodeExpandedEvent

BBjTreeNodeCollapsedEvent

BBjTreeNodeEditStoppedEvent

BBjTreeMouseUpEvent

BBjTreeMouseDownEvent

BBjTreeMouseDoubleClickEvent

BBjTreeRightMouseDownEvent

BBjTreeRightMouseUpEvent



______________________________________________________________________________________

Copyright BASIS International Ltd. BBj®, Visual PRO/5®, PRO/5®, and BBx® are registered trademarks.