|
Summary
Initialize or destroy a VT220 emulation window or connect, disconnect or abort a VT220 session.
Description
The Action property controls the emulation window and the connection state of the VT220 ActiveX control. A session can be established, closed or aborted and the emulation window can be
initialized or destroyed by assigning one of the following values to the property.
| Value |
Meaning |
| ACTION_INITIALIZE |
Initialize emulation window. |
| ACTION_CONNECT |
Establish session. |
| ACTION_DISCONNECT |
Close session. |
| ACTION_ABORT |
Abort session. |
| ACTION_DESTROY |
Destroy emulation window. |
This property can be changed at run time only.
The VT220 emulation must be initialized before any other action is performed (with the exception of listing, modifying, deleting and saving configurations as described in the reference page of the
VtAction property). To initialize the VT220 emulation, set the Action property to ACTION_INITIALIZE. This will create an emulation window inside the VT220 ActiveX control.
Before setting the Action property to ACTION_CONNECT, the following properties must be initialized. The Host property must be set to the name or internet address (in dotted decimal notation) of the
remote server. The Port property must be set to the remote port on which the remote service is running (most servers use the default remote service port 23 for Telnet).
If the connection can be established, then the OnConnect event will be fired. If the connection cannot be established, then the OnError event will be fired. These events will occur before the next
statement (i.e. the statement following the assignment of ACTION_CONNECT to the Action property) is executed. The application should set a flag in the OnConnect and OnError events, so that it can
determine if the session has been established or not. In addition, the application may want to display an error message in the OnError event to inform the user that the connection could not be
established. Please check the reference page of the OnError event for a complete listing of error codes.
Once a connection is no longer needed, the session can be terminated by setting the Action property to ACTION_DISCONNECT. An application must close all connections it has created before it quits. A
connection can also be closed by setting the Action property to ACTION_ABORT. This action resets and closes the connection without properly closing down communication and should not be called under
normal circumstances.
Before quitting, the application must destroy the emulation window it created with ACTION_INITIALIZE by setting the Action property to ACTION_DESTROY. This will destroy the emulation window and the
application can no longer perform any VT220 ActiveX control operations except for ACTION_INITIALIZE and listing, modifying, deleting and saving configurations (see VtAction).
There is no default value for this property.
Note
The Initialize, Connect, Disconnect, Abort and Destroy methods accomplish the same as the above actions. Please check the reference pages of these methods for more detailed information on
their usage.
Example
Vt220Client.Action = ACTION_INITIALIZE
Vt220Client.Host = "speedy.distinct.com"
Vt220Client.Port = 23
Vt220Client.Action =
ACTION_CONNECT
| 
