ALPHA

ALPHA N

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

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

ACTION

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

The created ALPHA can then be used through the appropriated commands. Because the ALPHA does not contain any text when it is created, nothing is visible on the FORM (use command CAPTION to give a text to an ALPHA).

The ALPHA is created at position (0,0) : that is TOP = 0 pixel and LEFT = 0 pixel, with dimensions WIDTH = 65 pixels and HEIGHT = 17 pixels.

An ALPHA displays a static text that the user cannot change.

An ALPHA can generate the events : ON_CLICK, ON_DOUBLE_CLICK.

Remark: by default, the ALPHA is created on the FORM number 0, but another FORM can be used. For that, create a FORM by FORM N, and send it the commands by COMMAND_TARGET_IS N before creating the ALPHA.

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

  • An ALPHA is used to display a static text (with command CAPTION) that the user cannot change.
  • The command CAPTION gives it a text (one line).

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 an ALPHA with default position and dimensions

alpha 1

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

caption 1,"Hello"

SEE ALSO

CAPTION

TOP

LEFT

WIDTH

HEIGHT

HINT

HINT_HIDE

FULL_SPACE

COLOR

ON_CLICK