SortScroll
Mon 01 January 2018Syntax
SortScroll(level, scrollpath, sort_fields)
Where scrollpath is:
[Record.level1_recname, [Record.level2_recname,] Record.target_recname
and where sort_fields is a list of field specifiers in the form:
[recordname.]field_1, order_1 [, [recordname.]field_2, order_2]. . .
Description
The SortScroll function programmatically sorts the rows in a scroll area on the active page. The rows can be sorted on one or more fields.
Note: This function remains for backward compatibility only. Use the Sort rowset method instead.
The type of sort done by this function, that is, whether it is a linguistic or binary sort, is determined by the Sort Order Option on the PeopleTools Options page.
Parameters
|
Field or Control |
Definition |
|---|---|
| level |
Integer specifying the level of the scroll to sort. It can be 1, 2, or 3. |
| scrollpath |
A construction that specifies a scroll area in the component buffer. |
| sort_fields |
A list of field and order specifiers which act as sort keys. The rows in the scroll area are sorted by the first field in either ascending or descending order, then by the second field in either ascending or descending order, and so on. |
| [ recordname. ] field_n |
Specifies a sort key field in target_recname . The recordname prefix is required if the call to SortScroll is in a record other than target_recname . |
| order_n |
A single-character string. "A" specifies ascending order; "D" specifies descending order. |
Returns
Optionally returns a Boolean value indicating whether the function executed successfully.