The src parameter specifies the source text to be edited, and is interpreted in conjunction with the txc'docfmt'src field of the txtctl parameter, in one of the following ways:
• File: To specify a file to edit, set src to the filename, and set the TXFF_FILE flag in the txc'docfmt'src field of txtctl. Note that other bits in the txc'docfmt'src field should be set to indicate whether the file is in plain text or RTF format.
In the ATE environment (i.e. when running under UNIX with an ATE client), if the filename does not contain a drive letter or backslash, then it is interpreted as being resident on the server and is automatically transferred to the %ATECACHEDIR% directory on the client workstation for editing.
• String Buffer: To specify a string buffer, map src as a string variable of suitable size, load the initial text into it, and do not set the TXFF_FILE flag in txc'docfmt'src field.
• Current Control Contents: To reedit the current contents of an existing control, src is not required. Instead, set opcode to TXOP_REEDIT, txc'ctlno to the text control number.