|
Summary
Use to start and stop data capture.
Syntax
Boolean DataCapture (CaptureFile, AppendFile)
| |
CaptureFile |
String |
| |
AppendFile |
Boolean |
Description
To capture all incoming data to a disk file or a specified file, call the DataCapture method. This action is only legal if the CaptureData or the CaptureDataFile property is True. Capturing
incoming data to a disk file or a specified file is disabled by calling this method a second time. An application can check the value of the boolean InCaptureData or InCaptureDataFile property to
determine if the VT220 ActiveX control is currently capturing incoming data to a disk file or a specified file, respectively.
The DataCapture method takes a capture file name (CaptureFile) and an append flag (AppendFile) as its parameters and returns a boolean. The CaptureFile parameter
must be set to the file name to contain the incoming data. The append flag must be set to True to append to the file and false to overwrite. A VT_CAPTURE_DATA is invoked if the file string is empty.
In this case, the append boolean is ignored. This action will display a dialog box to request for the name of the destination disk file from the user. If the file string is not an empty string, then
VT_CAPTURE_DATA_FILE is invoked. In this case, the append boolean is looked at whether to append or overwrite the file if it already exists.
If incoming data can be successfully captured, then the method returns True; otherwise, it returns False. The application should ensure that the method was successfully executed by checking the
return value.
Calling this method is equivalent to setting the VtAction property to VT_CAPTURE_DATA or VT_CAPTURE_DATA_FILE. This method can only be called after the VT220 emulation window has been created and
initialized.
Example
Result = VT220Client.DataCapture ("test", TRUE)
If Result = False Then
MsgBox "Cannot capture incoming data to file", 64, "Sample Program"
End If
| 
