Load a text window from a window library
|
WSupported on Windows
|
USupported on Unix
|
VSupported on OpenVMS
|
NSupported in Synergy .NET
|
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)
