| ActiveZTERM Developer Information |
Welcome!
Thanks for evaluating ActiveZTERM version 1.2.
Always keep in mind that ActiveZTERM is not targeted by COOL.STF to typical end-users. It is a developer product that allows you, as the host developer, to integrate your host and PC applications using any ActiveX container. With three lines of VB code, you can write a terminal emulator!
If you haven't read through this information before, please do in it's entirety before skipping down to the download section. There are a number of things you need to know in order to use this control properly.
After you've downloaded ActiveZTERM, take time to read through the Tutorial section of the help file.
A Few Important Terms
I don't mean this to be insulting to those who already know this stuff, but you have to understand these terms relative to ActiveX controls:
| Instantiate | The process of creating an ActiveX control, either at design time or run time. |
| Container Application | The application that is hosting the ActiveX control. For example, this could be Visual Basic, Internet Explorer or many others. Also known as just Container. |
| COM | The Component Object Model. This specification is the basis of how things like ActiveX, OLE automation and a ton of other technologies work. |
| Property | A public variable inside the ActiveX control that's exposed via the COM interface. Typically changing a property changes the operation of the control. |
| Method | A public subroutine inside the ActiveX control that can be called from the container application. |
| Event | A subroutine in the user code that is called when certain events occur inside the ActiveX control. |
ActiveZTERM Modes
As you may know from running ZTERM for Windows, it does take a little while to get ZTERM's emulators running. There are a ton of things that have to be done to get an complex code like a terminal emulator running, so rather than loading the code whenever ActiveZTERM is instantiated, ActiveZTERM runs in two different modes - Start and Stop modes.
Stop Mode
ActiveZTERM loads very quickly in Stop Mode, since it doesn't load any DLLs that are required for emulation. When you draw ActiveZTERM into the container application, it's initially drawn as shown above. To aid you in setting ActiveZTERM's size, a property called LayoutGrid can be set True which causes ActiveZTERM to draw like:
When the layout grid is displayed, you can also change the FontSize property to select the optimum font size for your application. There are four fonts, numbered 0 through 3 and all support both 80 and 132 column operation without altering the character height.
Start Mode
This is the run-time mode of ActiveZTERM, however, it has to be specifically selected by using the StartZTERM method. This allows you to keep the form on the page, perhaps hidden and only start the emulator running when you need to connect to the host.
Creating A Tiny Emulator
Let's now walk through creating a very simple terminal emulator using ActiveZTERM:
| 1. | Launch Visual Basic 4.0, 5.0 or 6.0. Create a new normal project | |
| 2. | Right click on the toolbar and select Components... | |
| 3. | Select the "ActiveZTERM Control" item | |
| 4. | Draw the ActiveZTERM control onto the form | |
| 5. |
Go to the form's FormLoad Event and paste this code in:
|
|
| 6. | Run the application! |
Current Issues
The following are known problems:
Requirements