T_WNDRD

Load a text window from a window library

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall T_WNDRD(channel, entry_name, window_id, status[, lines_loaded])

Arguments

channel

The channel of the window library. (n)

entry_name

The identifier (name) under which the text is stored in the library. (a)

window_id

The ID of the text window to process. (n)

status

The returned status flag. (n)

lines_loaded

(optional) Returned with the number of lines loaded. (n)

Discussion

T_WNDRD reads the data for a text window from a window library and puts it into the window. This subroutine obtains data using one or more calls to T_TXTRD and stores that data into the text window by calling T_PUTTXT.

Status is returned with a value of zero if the operation is successful, or D_NOFIND if the text entry cannot be found in the library. D_NOFIND is a negative number, therefore you can test for an error situation by checking whether status is less than zero.

Examples

The following example finds the text entry “menuhelp” in the window library opened on libchn and puts the text out to the window identified by txtid.

xcall t_wndrd(libchn, "menuhelp", txtid, status, numlines)