FORM

FORM N

CREATES A SYSTEM OBJECT FORM AND ALLOCATES IT NUMBER N AS REFERENCE

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

ACTION

The command FORM N creates a system object FORM, and allocates it a number N. The number N will be used to designate the FORM.

The created FORM can then be used through the appropriated commands.

The FORM is created at position (0,0) : that is TOP = 0 pixel and LEFT = 0 pixel, with dimensions WIDTH = 320 pixels and HEIGHT = 240 pixels.

A FORM displays a window with components.

A FORM can generate the events : ON_CLICK, ON_DOUBLE_CLICK, ON_KEY_UP, ON_KEY_DOWN.

Remark: by default, the FORM number 0 is created and display when RUN.

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

  • A FORM is used to display a window with components.

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 or equal to 0.
  • If number N is already used for a system object number.

EXAMPLE

rem create a FORM with default position and dimensions

form 1

rem display an explaining text about its role (its number is used as reference)

caption 1,"Main Table"

SEE ALSO

CAPTION

TOP

LEFT

WIDTH

HEIGHT

HINT

HINT_HIDE

FULL_SPACE

COLOR

BORDER_HIDE

BORDER_SMALL

BORDER_NORMAL

ON_CLICK

ON_CLOSE

ON_DOUBLE_CLICK

ON_KEY_UP

ON_KEY_DOWN