Installation manual

MAIN CONTROL OBJECT
17
3
PROPERTY MODE
PURPOSE
Defines the way to interpret data received from a device. If the transaction is in 2way
mode (see DataEvent event) it also defines the way to write data to be sent to a
device.
DESCRIPTION
This property allows choosing between the following data interpretations in
DataEvent:
− Text mode (default);
− Binary mode;
− Text mode with OEM-ANSI character conversion for data to and from device;
− Text mode with OEM-ANSI character conversion for data from device to
application only;
− Text mode with OEM-ANSI character conversion for data to device only.
The three text modes performing OEM-ANSI character conversion are available
starting from STAR-Link™ rel. 1.21.
The ANSI set of characters is essentially equivalent to the Windows set used in
Windows programming.
The OEM set of characters is typically used in full-screen MS-DOS sessions for
screen display. Characters in the decimal range 32 - 127 in Windows environment
are usually the same as in OEM. The other characters in OEM set of characters (in
the decimal range 0 to 31 and 128 to 255) correspond to the characters that can be
displayed in a full-screen MS-DOS session. These characters are generally different
from the Windows characters.
In all text modes, with or without OEM-ANSI conversion, when the control notifies the
container of the data event, it sets data in Device.DeviceData (a VARIANT type)
Bstring format (VT_BSTR). The string is NULL terminated.
In the binary mode, the Device.DeviceData is an array of bytes, of Device.Datalen
length (VT_ARRAY | VT_UI1).
Binary mode has been introduced to allow transmission of particular characters, such
as NULL character.