Progress
Language 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, Selection-list
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 © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |