OFF_SHOW

OFF_SHOW N

IGNORES THE EVENT "SHOW" WHEN THE SYSTEM OBJECT NUMBER N (FORM) IS SHOWN

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

ACTION

The command OFF_SHOW N ignores the event "show" on the system object designated by the number N: the event subprogram is not executed.

Remark 1: the system object must be of the type FORM.

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

SYNTAX: OFF_SHOW 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_SHOW is used to disassociate the event "show" happening to a FORM, to a program location (defined by the label L).
  • When the event occurs, the program named by the label is not executed any more.

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 : FORM.

EXAMPLE

label show,click

dim k%

k%=0

button 1:width 1,200:top 1,20:left 1,20:caption 1, "Click to hide this FORM"

on_show 0, show

on_click 1, click

end

show:

k%=k%+1

caption 0, "number of SHOWs: "+str$(k%)

off_show 0

return

click:

hide 0

wait 1000

show 0

return

SEE ALSO

ON_SHOW