S_SELLD

Load new selections into a selection window

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall S_SELLD(window_id, array_data, [fields], [first_field][, quick_select]) 

Arguments

window_id

The ID of the selection window. (n)

array_data

The first element of the array containing the data to load, which does not include any replacement text and horizontal lines. (a)

fields

(optional) The number of fields to be loaded. Maximum in 100. If not specified, one field is loaded. (n)

first_field

(optional) The number of the field to load first. (n)

quick_select

(optional) The array of quick‑select characters. (a)

Discussion

S_SELLD replaces the selectable entries in an existing selection window (created using S_SELBLD).

If first_field is specified, the first element of the array is loaded into the specified field. The second element of the array is loaded into first_field+1, the third element into first_field+2, and so on.

If first_field is not specified, the first element of the array is loaded into the first field.

If quick_select is not passed or is blank, the first non‑blank character in each entry is used.

If the selection window contains lines or non‑selectable text, they are not overwritten by S_SELLD; only selectable entries are replaced. Use the Synergy DBL W_DISP subroutine to replace text in a selection window.

Examples

This example loads the selection window whose ID is stored in selid with the first 20 entries in newdata.

xcall s_selld(selid, newdata, 20)