Off Event Command |
OFF EVENT
Cancels event branches defined by ON EVENT
______________________________________________________________________
Legal Usage Keyboard Executable Yes
Programmable Yes
In an IF...THEN... Yes
Example OFF EVENT @Pushbutton_3,"ACTIVATED"
Statements OFF EVENT @Slider, "DONE"
Syntax
|
Item
|
Description
|
Range
|
|
event name
|
name of an event this widget can generate
|
depends on the widget
|
|
widget handle
|
name identifying a widget
|
any valid name
|
Description
The OFF EVENT statement undefines and disables a widget event that was defined and enabled earlier by an ON EVENT statement.
In the following example, the first line causes the program to go to the subroutine Event_handler when the SLIDER widget event CHANGED occurs. Then, the next line cancels the event branch. Thus, after the second line, the occurrence of the event CHANGED will not cause a branch to Event_handler.
ON EVENT @Slider;"CHANGED" GOSUB Event_handler .
.
OFF EVENT @Slider, "CHANGED"
There are three important differences between the OFF EVENT and DISABLE EVENT statements:
|
·
|
DISABLE EVENT temporarily disables the event, whereas OFF EVENT permanently deactivates the event.
|
|
·
|
Only one occurrence of the event will be logged if the event is disabled with a DISABLE EVENT statement. Therefore, the branch will be taken once the event is reenabled with an ENABLE EVENT statement.
|
|
·
|
The event will NOT be logged and the branch will never be taken if the event is deactivated with an OFF EVENT statement.
|