COMBO

COMBO N

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

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

ACTION

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

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

The COMBO is created at position (0,0) : that is TOP = 0 pixel and LEFT = 0 pixel, with dimensions WIDTH = 145 pixels and HEIGHT = 21 pixels.

A COMBO combines the functions of EDIT and LIST: a list of choices can be displayed, the user can type a text or can select an item of the list.

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

Remark 1: by default, the COMBO 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 COMBO.

Remark 2: a COMBO is at the same time a LIST and an EDIT. Its drop-down list is filled as a LIST with the commands ITEM_ADD, ITEM_INSERT, FILE_LOAD or FILE_ADD and it is read as a LIST with the function ITEM_READ$(). Its visible part is filled as an EDIT with the command TEXT, and is read as an EDIT with the function TEXT$().

SYNTAX: COMBO 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 COMBO is used to combine the functions of EDIT and LIST: a list of choices can be displayed, the user can type a text or can select an item of the list.

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

combo 1

rem fill the list with a file, the path being into variable a$

file_add 1,a$

rem fill its visible part

text 1,"Choose a line"

SEE ALSO

TOP

LEFT

WIDTH

HEIGHT

HINT

HINT_HIDE

FULL_SPACE

COLOR

TEXT

TEXT$()

ITEM_ADD

ITEM_INSERT

ITEM_DELETE

ITEM_READ$()

FILE_ADD

FILE_LOAD

CLEAR

ON_CLICK

ON_CHANGE

ON_DOUBLE_CLICK

ON_KEY_UP

ON_KEY_DOWN