Carapace

Carapace.EmulatorWindow Interface

Creation

The create function can be used to create a an Emulator Window:

    (create Dispatch "Carapace.EmulatorWindow")
When created using COM, the application is initially invisible so that it's can be tailored before being displayed.

Properties

The Carapace.EmulatorWindow has the following properties:

property name property type description
emulator Dispatch the contained emulator ActiveX control
HWND Integer the window handle for the main window -- this allows other applications to control the position of the window etc.
menubar Symbol boolean (true or false) which controls the visibility of the application's menu bar
style Integer the window style which defines the emulator's appearance
title String the title on the titlebar of the application
titlebar Symbol boolean (true or false) which controls the visibility of the application's title bar
visible Symbol boolean (true or false) which controls the visibility of the application

Methods

The Carapace.EmulatorWindow has the following methods:

method name description
addStyle add the supplied style bit to the overall application style
removeStyle remove the supplied style bit from the overall application style
moveTo move the application to the supplied point on screen
resizeTo make the application window have the supplied dimensions
connect connect the emulator to the supplied address
write write the supplied data down the communications link -- as if the emulator user had typed these characters
disconnect disconnect the emulator from the remote host


addStyle

Add the supplied style bit to the overall application style. The most common values are as follows:

maximise box16
minimise box17
thick frame18
system menu19
dialog frame22
border23
disabled27

Arguments:

bitInteger

Return type: the empty List ()


removeStyle

Remove the supplied style bit from the overall application style. See addStyle for the most common values.

Arguments:

bitInteger

Return type: the empty List ()


moveTo

Move the application to the supplied point on screen.

Arguments:

xInteger
yInteger

Return type: the empty List ()


resizeTo

Make the application window have the supplied dimensions.

Arguments:

widthInteger
heightInteger

Return type: the empty List ()


connect

Connect the emulator to the supplied address. The address is passed through to the contained emulator ActiveX control.

Arguments:

addressString

Return type: the empty List ()


write

Write the supplied data down the communications link -- as if the emulator user had typed these characters.

Arguments:

dataString

Return type: the empty List ()


disconnect

Disconnect the emulator from the remote host.

Arguments: none

Return type: the empty List ()


Contents Index Current topic: objects Related links: built-in objects