Inserts a new item before a specified item
in a combo box or selection list. The new item can consist of a
label, a list of labels, or a label-value pair.
Return
type: LOGICAL
Applies to:
BROWSE widget (column), COMBO-BOX widget, SELECTION-LIST widget
Syntax
INSERT (
{new-item-list|new-label , new-value}
, {list-item|list-index} )
|
-
new-item-list
- A character-string expression that specifies a single item or
a delimiter-separated list of items to add to the widget.
-
new-label
- A character-string expression that specifies the label of a
label-value pair to add to the widget.
-
new-value
- The new value assigned when a user selects the label.
Note: If the widget's entries consist of single items,
use new-item-list. If the widget's entries consist
of label-value pairs, use new-label and new-value.
-
list-item
- A character-string expression that specifies a single value
in the widget.
-
list-index
- An integer expression that specifies the ordinal position of
an existing entry in the widget. The first item is specified by
0 and the last item is specified by -1.
The
delimiter is the value of the DELIMITER attribute, which is a comma by
default. If the method is successful, it returns TRUE.
For
browses, this method applies only to combo-box browse columns.
Note: If the widget's entries consist of single items,
each call to INSERT can add multiple entries. If the widget's entries
consist of label-value pairs, each call to INSERT can add one entry.