T_WNDWRT

Store a text window’s contents in a window library

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall T_WNDWRT(channel, entry_name, window_id, control[, lines_written])

Arguments

channel

The channel of the window library. (n)

entry_name

The identifier (name) of the text entry in the library (a maximum of 15 characters). (a)

window_id

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

control

One of the following processing controls on entry: D_CREATE to create a new entry and generate an error if it already exists or D_REPLACE to create a new entry and replace any existing entry. (n)

lines_written

(optional) The number of lines written. (n)

Discussion

T_WNDWRT stores the data within a text window as a text entry in a window library. This subroutine obtains data using one or more calls to T_GETLIN and writes that data out to the library by calling T_TXTWRT.

Upon exit, control is returned with a value of zero if the operation is completed successfully, or D_EXISTS if control was set to D_CREATE on entry and the text entry already exists. D_EXISTS is a negative number, therefore you can test for an error condition by checking whether control is less than zero.

Examples

This example takes the text from txtid, makes it into a text entry, and stores it as “menuhlp” in the window library opened on libchn.

ctrl = D_CREATE
xcall t_wndwrt(libchn, "menuhlp", txtid, ctrl, numlines)