Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## 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: 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.

> 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.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095