Table Tree Events 

The SAP Table Tree control fires several events in order to inform the container about state changes, user interaction and drag-and-drop operations. To enable or disable these events, use the Table Tree object’s Events property.

The Table Tree events are:

Table Tree Events

Name

Parameters

Description

Click

void

A mouse click occurred within the control’s client area.

DblClick

void

A double click occurred within the control’s client area.

KeyDown

short* KeyCode

short ShiftState

A key was pressed. The virtual key code is passed in KeyCode, the current state of the shift key in ShiftState. KeyCode may be modified within the event-handling routine.

KeyUp

short* KeyCode

short ShiftState

A key was released. The virtual key code is passed in KeyCode, the current state of the shift key in ShiftState. KeyCode may be modified within the event-handling routine.

Collapse

Object Node

The Node passed in as parameter Node is being collapsed. This event is fired immediately before the node is collapsed.

Expand

Object Node

The node passed in as parameter Node is being expanded. This event is fired immediately before the node is expanded.

It is legal to add children to the node in the Expand event. The added children are displayed properly afterwards.

NodeClick

Object Node

A click occurred on the node passed in as parameter Node.

ItemClick

Object Node

Long Index

A click occurred on an Item object within the Node passed in as parameter Node. The parameter Index may be used to access the item data using the Value property of the Node object. (See also the SelectMode property and Structure object.)

ItemCblClick

Object Node

Long Index

A double click occurred on Item within the node passed in as parameter Node. The parameter Index may be used to access the item data through the Value property of the node object. (See also the SelectMode property and Structure object.)

ItemGotFocus

Object Node

Long Index

The Item with index Index in Node received the input focus. (See also the SelectMode property and the Structure object.)

ItemLostFocus

Object Node

Long Index

The Item with index Index in Node lost the input focus.

(See also the SelectMode property and Structure object.)

SelChange

Object Node

Long Index

The selected Node or Item has changed. The new selected node and item are passed in as parameter Node and Index. Index indicates the selected item within the node. If Index = -1, no node is selected. Otherwise the parameter Index may be used to access the item’s data through the Value property of the Node object.

(See also the SelectMode property and Structure object).

DuplicatedKey

Object Node

String* NewKey

String OldKey

Short* Handled

An already-existing key is being inserted or assigned.

BeforeLabelEdit

Object Node

Long Index

Short* Cancel

The user has begun to edit an Item in Node Node. Index indicates which item within node. Index may be used to access the item’s data through the Value property of Node, or to retrieve the item’s description from the Structures collection. If Cancel is set to TRUE, the edit operation is postponed. (See also the SelectMode property and Structure object.)

AfterLabelEdit

Object Node

Long Index

Short* Cancel

String NewString

The editing of an Item has completed. The new text is passed in as NewString and may be modified by the container. Index may be used to access the item’s data through the Value property of the Node object, or to retrieve the item description from the Structures collection. If Cancel is set to TRUE, the entire edit operation is being postponed.

NodeInsert

Object Node

The node Node is being inserted.

NodeRemove

Object Node

The node Node is being removed.

DragSourceFill

Object DataObject

Object Node

Short* Handled

A drag-and-drop operation is starting with the node Node. DataObject is an SAP Data Object and may be filled with any format.

DropComplete

Object Node

Long Effect

A drag-and-drop operation originally started on Node has been successfully completed. Effect describes the type of drop. It is up to the application to consider the Effect.

DropEnter

Object DataObject

Long KeyState

Long* Effect

Short* Handled

During a Drag and Drop operation, the mouse pointer was moved into the client area of the control.

(See also SAP Data Object)

Drop

Object Node

Object DataObject

Long* Effect

Short* Handled

A drop has occurred on the control’s client area on node Node. (See also SAP Data Object)