INFLD

xcall INFLD, row, col, xmax, xmin, type, entry, inxctl, parentid, opcode, exitcode, timer, cmdflg, defpt, maxpt, funmap, setdef, infclr, hlpidx, maxchrs

INFLD.SBR is a powerful and flexible field-level input and display routine, operating in both text and GUI modes. In GUI mode, it takes on the form of a edit control, combo box, date/time picker, or up/down (spinner) control, depending on the parameter options. INFLD's GUI mode is generally application-compatible with text mode, but of course requires either A-Shell/Windows or ATE. INFLD is also used internally to implement the A-Shell dot-prompt, the VUE command line, and INMEMO.

History/compatibility note: Originally developed as an upward-compatible replacement for the native AMOS subroutine INPUT.SBR, INFLD was sold as a standalone product under AMOS. The A-Shell implementation is upward compatible with the AMOS version, but adds many additional capabilities, most notably the GUI extensions.

Parameters

Parameter

Type

I/O

Description

row

Num

in

Row for input

col

Num

in

Starting column.

xmax

Num

in

Maximum size (width; see maxchrs).

xmin

Num

in

Minimum number of characters to accept. Note that if the O (optional) type code is used, the minimum is only in effect if at least one printable character is entered.

type

String

in

Codes specifying types, formats, etc.

entry

String

in/out

String field contents sent and returned in

inxctl

out

(String,1 or F,6) Special exit codes compatibile with INPUT.SBR

Parameters above are required; those below are optional.

parentid

in

(String or Num) If zero, multiplies (row) by two

opcode

Num

in

Used to specify pre-load, output, other options

exitcode

F,6

out

Extended exit codes (how field exited)

timer

F,6

in/out

Used to specify time-out duration

cmdflg

Num

in

Controls whether command file input allowed

defpt

Num

in

Specifies default decimal point

maxpt

Num

in

Specifies maximum digits to right of decimal

funmap

Num

in

Controls interpretation of function keys

setdef

String

in

Defines list or set of allowable inputs

infclr

in

(Structure or 0) Color specifications

hlpidx

String

in

Various expansion features

maxchrs

Num

in

Maximum number of characters allowed (independent of xmax)