[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