Compsee Apex III, Technical Reference Manual

Page: 124 / 168

Apex PDT Technical Reference Manual 7 Apex Programming Resource
COAM30002 Rev. 2.00 8/13/02
7-16
PowerLow
Syntax:
void PowerLow(void)
Input:
None
Returns:
None
Notes:
Places the Apex PDT into a low power state.
Data Input Functions
GetStringE
Syntax:
int GetStringE(char far *s, int maxlen, int fieldlen, struct
bcdparms *bcd, char options);
Input:
s = a character buffer (array) for storing the data string and
terminating NULL.
maxlen = size of buffer including terminating NULL.
fieldlen = the size of the data field. If maxlen is greater
than fieldlen , the data will scroll within the display field.
bcd = pointer to a structure containing the registered Bar
Code Driver parameters. See [a3lib.h] for the bcdparms
structure declaration.
Options = the OR combination of the following bits
(defined in [a3lib.h] ).
STR_SCANNER Enables data entry via the scanner
STR_KEYBRD Enables data entry via the keyboard
STR_TERMSCN Automatically terminates data entry
following a scan.
STR_CAPS Converts keyboard data to all caps.
Returns
On error, returns:
-1 if parameter error (
fieldlen and maxlen must be > 0).
-2 if Bar Code Driver NOT loaded.
-3 if not enough memory to perform function.
On success, returns the key that caused input to terminate.
This return value is the same as the return value for
Getkey() found in the Bar Code Driver library.
Notes:
Gets a string from the keyboard or scanner and echoes it to
the screen.
The string is echoed at the current cursor position using the
current background and foreground colors.