INSERT( ) method

INSERT( ) method

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.

Syntax
INSERT ( { `new-item-list` \| `new-label` , `new-value` } , { `list-item` \| `list-index` } )

OpenEdge Release 10.2B