Syntax
(combo-box, selection-list, or browse column)
This is
the syntax for a 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.
Syntax (radio-set)
This
is the syntax for a 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).
|