CONTAINER

CONTAINER N

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

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

ACTION

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

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

A CONTAINER has a border.

The CONTAINER is created at position (0,0) : that is TOP = 0 pixel and LEFT = 0 pixel, with dimensions WIDTH = 185 pixels and HEIGHT = 105 pixels.

A CONTAINER can contain the system objects: : BUTTON, EDIT, MEMO, COMBO, ALPHA, LIST, PICTURE, CHECK, OPTION, MOVIE, TRACK_BAR, SCROLL_BAR, PROGRESS_BAR, SPIN, GRID, CONTAINER, SCENE2D.

The command PARENT must be used to include a system object in a CONTAINER.

A CONTAINER can generate the events : ON_CLICK, ON_DOUBLE_CLICK.

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

SYNTAX: CONTAINER 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 CONTAINER is used to group system objects.

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

container 1

rem fill it with 2 BUTTONS

button 2:top 2, 20:left 2,10:parent 2,1:caption 2,"Button 2"

button 3:top 3, 20:left 3,90:parent 3,1:caption 3,"Button 3"

SEE ALSO

TOP

LEFT

WIDTH

HEIGHT

HINT

HINT_HIDE

FULL_SPACE

PARENT

ON_CLICK

ON_DOUBLE_CLICK