AppendToFile

Append the entire host screen, or a selected area of text from the screen to an existing file.


Syntax

FlexScreen.AppendToFile(FileName, [StartPos, EndPos])


Parameters


FileName

String, input



Full path and name of file to print to.


StartPos

Integer, input, optional



Integer value of the zero based screen position to start the print, which may be obtained by using the FlexScreen.Position method.


EndPos

Integer, input, optional



Integer value of the zero based screen position to start the print, which may be obtained by using the FlexScreen.Position method.


Remarks

If the specified FileName does not exist, FlexTerm will create the file.


Examples

To append the entire screen to a file:

Sub Main()

Ok = FlexScreen.AppendToFile("C:\Users\Public\MyFile.txt")

End Sub


To append from row 1, column 4 to row 14, column 27 to a file:

Sub Main()

Ok = FlexScreen.AppendToFile("C:\Users\Public\MyFile.txt", FlexScreen.Position(1, 4), FlexScreen.Position(14, 27))

End Sub