|
Summary
Capture screen data into a file.
Syntax
Boolean ScreenCapture (CaptureFile, AppendFile)
| |
CaptureFile |
String |
| |
AppendFile |
Boolean |
Description
To capture the data currently displayed on the screen of the VT220 emulation window to a disk file or a specified file, call the ScreenCapture method. Before doing this, an application must
make sure that this action can be performed by verifying that the CaptureScreen or the CaptureScreenFile property is True.
The ScreenCapture 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_SCREEN 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_SCREEN_FILE is invoked. In this case, the append boolean is looked at whether to append or overwrite the file if it already exists.
If the data currently displayed on the VT220 emulation window 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_SCREEN or VT_CAPTURE_SCREEN_FILE. This method can only be called after the VT220 emulation window has been created and
initialized.
Example
Result = VT220Client.ScreenCapture ("test", TRUE)
If Result = False Then
MsgBox "Cannot capture data currently on the screen", 64, "Sample Program"
End If
| 
