Equinox Online Help - Language Reference - A to Z

Home

ListAppend

Applies to
SyntaxListAppend ListItem, StringExpression [, AllowDuplicateExpression]
Action[Statement] Adds values onto a specified combo field.
ScopeOnly usable in form methods.
Notes

This statement is used to append the value in StringExpression to a combo field specified by the ListItem argument. The developer can set the optional AllowDuplicateExpression parameter to True or False to allow duplicates to be stored in the combo. The default setting if it is omitted is False. If ListItem is not a listable type SysError is set to one.

The system workarea SysError is set to a non-zero value if an error occurs, otherwise zero.

CategoryCombo lists
See Also ListCount, ListDelete, ListDeleteString, ListEmpty, ListFind, ListInsert, ListRead, ListReset, ListSpace
Example

This example empties a combo field and fills it with the year numbers of the last 80 years.

number BirthYr(4,0), ThisYr(4,0), n

ThisYr = Year(Today)
BirthYr = ThisYr - 80
ListEmpty YrofBirth

for n = BirthYr to ThisYr
ListAppend YrofBirth, n
next n