CREATES A SYSTEM OBJECT COMBO AND ALLOCATES IT NUMBER N AS REFERENCE
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
USE ERROR 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"
COMBO
COMBO N
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