Events                                                                        Object

[PUBLIC] SUB ObjectName_Event[(arglist)]

  [Statements]

END SUB

Description

Object events are triggered either programmatically or through user interaction. When an event is triggered, an object calls a SUB procedure in the program. The name of the procedure, ObjectName_Event, is a combination of the object name and the name of event. The optional component, arglist, is a comma-separated list of arguments that may be included in the procedure call by some events.

Table 9: Object Events

Event

Comments

Change

ComboBox (item selected or text input), ListBox (item selected), TextBox (Text changed)

Click

DblClick

ListBox, TextBox

DropDown

ComboBox, Date

GotFocus

Object activated to receive keyboard input.

Form_Hide

Generated code – do not modify

Form_Load

Called from Form_Show

Form_Show

Generated code – do not modify

Form_Unload

Called from Form_Hide

KeyDown

Keycode, shift as args

Shift=1, 2-CTRL, 4=Alt

KeyPress

Char as arg

KeyUp

Keycode, shift as args

Shift=1, 2-CTRL, 4=Alt

LostFocus

Object deactivated

Output_Close

Called when app is closed

Output_Size

Called when output size is changed or screen rotated

Timer

CheckBox, ComboBox, CommandButton, Frame, HScrollBar, Label, ListBox, OptionButton, TextBox, VScrollBar

Note: If a program does not have a procedure to respond to an event when it is called, no error will occur.

 

Example

REM Object Events Example

'Object Events call procedures in theprogram

DIM When

ADDOBJECT "ComboBox","Combo", 5, 30, 150, 80

Combo.Style = 2

SUB Combo_DropDown

  Combo.Clear

  Combo.AddItem DATE

  Combo.AddItem DATEADD("d", 1, DATE)

  Combo.AddItem DATEADD("ww", 1, DATE)

END SUB

SUB Combo_Click

  When = Combo.Text

  PRINT "Item selected: " & When

END SUB

Output

Related Items

Methods, Properties