Progress
Language Reference
ADD-LAST( ) Method
Adds one or more items to the bottom of a combo box, radio set, or selection list.
Return Type: LOGICAL Applies To: Combo-box, Radio-set, 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.
NOTE: If the widget’s entries consist of single items, useitem-list. If the widget’s entries consist of label-value pairs, use label and value.
For combo boxes and selection lists, the delimiter is the value of the DELIMITER attribute, which is comma by default. Also, if the SORT attribute is TRUE, ADD-LAST sorts the new items by label before adding them to the widget.
label
A character-string expression that represents the label of a label-value pair.
value
An INTEGER expression that represents the value of a label-value pair. When the radio set appears, if the user selects label, Progress assigns value to the corresponding field or variable.
For radio sets, if the AUTO-RESIZE attribute is TRUE; the size of the radio set changes. Otherwise, the radio set is clipped.
For all applicable widgets, if the operation is successful, ADD-LAST returns TRUE.
NOTE: If the widget’s entries consist of single items, each call to ADD-LAST can add multiple entries. If the widget’s entries consist of label-value pairs, each call to ADD-LAST 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 |