<<

Contents

Search

>>

 

DEL_LISTBOX

 

 

Function

 

 

Syntax:

DEL_LISTBOX(<Mask Field>,<Item>[,<Handle>])

 

<Mask Field>

= <MASK FIELD>

<Item>

= <STRING-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

 

 

Meaning:

Deletes the entry <Item> from a listbox or combobox. If <entry> is the empty string "", all entries of the list- or combobox are deleted. 

 

<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, the listbox or combobox must be on the current mask

 

DEL_LISTBOX returns the following values:

0: The function was successful.

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

-2: <Item> could not be deleted.

-3: Runtime error (Exception)

 

Parameter:

Mask Field

Listbox or Combobox

Item

Text to be deleted

Handle

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

 

Sample:

H% = DEL_LISTBOX(#5.#LB$,"equipment")

IF H% <> 0

THEN … Error …

ENDIF

 

See also:

ADD_LISTBOX