OFF_CHANGE

OFF_CHANGE N

IGNORES THE EVENT "CHANGE" WHEN THE SYSTEM OBJECT NUMBER N CHANGES

  • Type: Command
  • Parameter: 1
  • Group: Events

ACTION

The command OFF_CHANGE N ignores the event "change" on the system object designated by the number N: the event subprogram is not executed when a change happens in the system object.

Remark 1: the system object must be one of the following types: EDIT, MEMO, COMBO, TRACK_BAR, SCROLL_BAR, SPIN.

Remark 2: the event subprogram is defined by the command ON_CHANGE N,L which assigns the label L as the starting point of the event subprogram.

SYNTAX: OFF_CHANGE N

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.

USE

  • The command OFF_CHANGE is used not to treat the event "change" happening to a system object: when the event occurs, the event subprogram is not executed.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than 0.
  • If system object number N does not exist.
  • If system object number N is not of the type : EDIT, MEMO, COMBO, TRACK_BAR, SCROLL_BAR, SPIN.

EXAMPLE

rem declare a label

label changed

rem a MEMO is created

memo 1

on_change 1,changed

end: rem main program is finished

changed:

beep: rem treatment of event = beep

off_change 1:rem only one time

return

SEE ALSO

ON_CHANGE