CONTAINER_OPTION

CONTAINER_OPTION N

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

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

ACTION

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

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

The CONTAINER_OPTION 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_OPTION contains only OPTIONs. These OPTIONs are grouped: when the user checks an OPTION, all other OPTIONS become unchecked. Two OPTIONS cannot be checked at the same time.

The command PARENT must be used to group OPTIONS in a CONTAINER_OPTION.

A CONTAINER_OPTION can generate the event : ON_CLICK.

Remark: by default, the CONTAINER_OPTION 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_OPTION.

SYNTAX: CONTAINER_OPTION 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_OPTION is used to group exclusive OPTIONs.

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

container_option 1

rem fill it with 2 OPTIONS

option 2:parent 2,1

top 2,10:left 2,10:caption 2,"option 1"

option 3:parent 3,1

top 3,40:left 3,10:caption 3,"option 2"

SEE ALSO

TOP

LEFT

WIDTH

HEIGHT

HINT

HINT_HIDE

FULL_SPACE

PARENT

ON_CLICK