TO_FOREGROUND

TO_FOREGROUND N

BRINGS THE SYSTEM OBJECT NUMBER N (FORM) TO FOREGROUND

  • Type: Command
  • Parameter: 1
  • Group: System Objects

ACTION

The command TO_FOREGROUND N brings to foreground the system object designated by its number N.

The system object must be a FORM.

SYNTAX: TO_FOREGROUND 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 TO_FOREGROUND is used to bring a FORM to foreground.

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 number N is not the number of a FORM system object.

EXAMPLE

rem create a FORM

form 1

rem send it to background

to_background 1

rem wait for 1 second

wait 1000

rem bring it to foreground

to_foreground 1

SEE ALSO

TO_BACKGROUND