S_UPDATECB
Update a check box selection window
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
xcall S_UPDATECB(window_id, num_flags, flag_array)
Arguments
window_id
The window ID of the loaded selection window. (n)
num_flags
The number of flags. (n)
flag_array
The array of true/false flags (which must have at least as many elements as the selection window has fields). (n)
Discussion
S_UPDATECB updates the check mark characters in a loaded check box selection window.
Before you call S_UPDATECB, make sure the selection window meets the following criteria:
- The selection window was created with the .SELECT command, the SELECT option of the .FIELD command, or the S_SELBLD subroutine.
- Each entry in the selection window has a space as the first character. This space will be used for the check mark character.
- The selection window is already loaded.
Num_flags indicates both the number of elements in flag_array and the number of entries in the selection window.
Flag_array is an array of numeric true/false values. This subroutine displays a blank in the first position (the space) of each entry whose corresponding array element is false. For each true element, this subroutine displays the check mark character (which is generally an “X”) in the first position of the corresponding window entry. On UNIX and OpenVMS, the value of g_chk_char determines the check mark character. On Windows, setting g_chk_char has no effect.
For information on designing check box selection windows, see Creating a check box selection window.