User Guide

ComboBox.sortItemsBy() 203
optionsFlag Lets you perform multiple sorts of different types on a single array without
having to replicate the entire array or re-sort it repeatedly. This parameter is optional, but if
used, should replace the
order parameter.
The following are possible values for
optionsFlag:
■ Array.DESCENDING, which sorts highest to lowest.
■ Array.CASEINSENSITIVE, which sorts without regard to case.
■ Array.NUMERIC, which sorts numerically if the two elements being compared are
numbers. If they aren’t numbers, use a string comparison (which can be case-insensitive if
that flag is specified).
■ Array.UNIQUESORT, which returns an error code (0) instead of a sorted array if two
objects in the array are identical or have identical sort fields.
■ Array.RETURNINDEXEDARRAY, which returns an integer index array that is the result of the
sort. For example, the following array would return the second line of code and the array
would remain unchanged:
["a", "d", "c", "b"]
[0, 3, 2, 1]
You can combine these options into one value. For example, the following code combines
options 3 and 1:
array.sort (Array.NUMERIC | Array.DESCENDING)
Returns
Nothing.
Description
Method; sorts the items in the combo box alphabetically or numerically, in the specified order,
using the specified field name. If the
fieldName items are a combination of text strings and
integers, the integer items are listed first. The
fieldName parameter is usually "label" or
"data", but advanced programmers may specify any primitive value. If you want, you can use
the
optionsFlag parameter to specify a sorting style.