<<

Contents

Search

>>

 

ADD_LISTBOX

 

 

Function

 

 

Syntax:

ADD_LISTBOX(<Mask Field>,<String Expression>[,<Handle>][,<Separator>])

 

<Mask Field>

= <MASK FIELD>

<String Expression>

= <STRING-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

<Separator>

= <STRING-EXPRESSION>

 

 

Meaning:

Adds the item(s) <String Expression> to a listbox or combobox.

 

<Mask Field> has to be a listbox or a combobox.

 

<Handle> specifies the window that contains the listbox or combobox. <Handle> can contain the window depth or the handle of a split window or a WINDOWCALL window. If the parameter <Handle> is missing or <Handle> == -1, the listbox or combobox must be on the current mask.

 

Several items can be added to a listbox or a combobox when a <Separator> is specified and the items in <String Expression> are separated by <Separator>.

 

ADD_LISTBOX returns the following results:

0: The function was successful.

-1: The <Mask Field> does not exis or is not a list-/combobox.

-3: Runtime error (Exception)

 

Parameter:

Mask Field

Listbox or Combobox

String Expression

Text to be inserted

Handle

Window depth or handle of a split window or handle of a WINDOWCALL Window

Separator

Specifies the separator when <String Expression> contains several items which are separated by <Separator>.

 

Sample:

H% = ADD_LISTBOX(#5.#LB$,"Accessory")

IF H% <> 0

THEN ... Error ...

ENDIF

 

See also:

DEL_LISTBOX

GET_LISTBOX_ITEMS$