Events in user objects

When you build a user object, you can write scripts for any event associated with that user object.

Events in class user objects

Most custom class user objects have only constructor and destructor events.

Table 14-1: Events for custom class user objects

Event

Occurs when

Constructor

The user object is created

Destructor

The user object is destroyed

Standard class user objects have the same events as the PocketBuilder system object from which they inherit.

Events in visual user objects

Standard visual user objects have the same events as the PocketBuilder control from which they inherit. Custom and external visual user objects have a common set of events.

Table 14-2: Events for custom and external visual user objects

Event

Occurs when

Constructor

Immediately before the Open event of the window and when the user object is dynamically placed in a window

Destructor

Immediately after the Close event of the window and when the user object is dynamically removed from a window

DragDrop

A dragged object is dropped on the user object

DragEnter

A dragged object enters the user object

DragLeave

A dragged object leaves the user object

DragWithin

A dragged object is moved within the user object

Other

A Windows message occurs that is not a PocketBuilder event

RButtonDown

The right mouse button is pressed (desktop), or a tap-and-hold action is executed on the control (Pocket PC device)

For more about drag and drop events, see the chapter in the Resource Guide on using drag and drop in a window.