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:

BROWSE widget (column), COMBO-BOX widget, RADIO-SET widget, SELECTION-LIST widget

This is the syntax for a combo-box, selection-list, or browse column.

 

Syntax (combo-box, selection-list, or browse column)

ADD-LAST ( { item-list | label , value } )

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 the AVM assigns to the field or variable if the user selects the corresponding label.

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.

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.

For browses, this method applies only to combo-box browse columns.

This is the syntax for a radio-set.

 

Syntax (radio-set)

ADD-LAST ( label , value )

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, the AVM 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:

 

return-code = my-combo-box-hdl:ADD-LAST("Seoul").

 

return-code = my-sel-list-hdl:ADD-LAST("Bogota, Seoul, Los Angeles").

The following example modifies a combo-box widget of type INTEGER whose entries consist of label-value pairs:

 

return-code = my-widget-hdl:ADD-LAST("Bogota", 15).