wcSaveText() Function

Saves the text contained in the text box to the specified file. If the file doesn't exist, it is created. If it does exist, it must be read/write.

Category

windows control

Syntax

[ErrorNumber=]wcSaveText("ControlName", "Filename");

Parameters

ControlName

The name of the windows control object. For example, ListBox_1. Actual string or message tagname.

Filename

Contains the name of the destination file. If you do not supply a complete path name, the file is saved in the application directory. If the file exists, it is overwritten. If the file does not exist, it is created. The resulting file can subsequently be loaded into a text box object using the wcLoadText() function. Actual string or message tagname.

Remarks

For a list of returned error numbers, see Understand windows controls error messages.

Applies To

Text boxes.

Example(s)

The following statement saves the current information entered in a text box to a file in c:\InTouch.32\newtext.txt when an action script runs:

wcSaveText("Textbox_1", "c:\InTouch.32\newtext.txt");

See Also

wcLoadText()