Progress
Language Reference
ADD-FIRST( ) Method
Adds one or more items to the top of a combo box or selection list.
Return Type: LOGICAL Applies To: Combo-box, Selection-list
item-list
A character-string expression that represents one or more items, delimiter-separated.
label
A character-string expression that represents the label of a label-value pair.
value
The value Progress assigns to the field or variable if the user selects the corresponding label.
The delimiter is the value of the DELIMITER attribute, which defaults to comma. If the SORT attribute is TRUE, Progress sorts new items by label before adding them to the widget. If the operation is successful, ADD-FIRST returns TRUE.
NOTE:
- If the widget’s entries consist of single items, use item-list. If the widget’s entries consist of label-value pairs, use label
and value.
- If the widget’s entries consist of single items, each call to ADD-FIRST can add multiple entries. If the widget’s entries consist of label-value pairs, each call to ADD-FIRST can add one entry.
The following examples modify widgets whose entries consist of single items:
The following example modifies a combo-box widget of type INTEGER whose entries consist of label-value pairs:
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |