xcall INFLD, row, col, xmax, xmin, type, entry, inxctl, parentid, opcode, exitcode, timer, cmdflg, defpt, maxpt, funmap, setdef, infclr, hlpidx, maxchrs
INFLD 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 |
---|---|---|---|
in |
Row for input |
||
in |
Starting column. |
||
in |
Maximum size (width; see maxchrs). |
||
xmin |
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. |
|
in |
Codes specifying types, formats, etc. |
||
in/out |
String field contents sent and returned in |
||
→ |
out |
(String,1 or F,6) Special exit codes compatibile with INPUT. |
|
Parameters above are required; those below are optional. |
|||
→ |
in |
||
in |
Used to specify pre-load, output, other options |
||
F,6 |
out |
Extended exit codes (how field exited) |
|
F,6 |
in/out |
Used to specify time-out duration |
|
in |
Controls whether command file input allowed |
||
in |
Specifies default decimal point |
||
in |
Specifies maximum digits to right of decimal |
||
in |
Controls interpretation of function keys |
||
in |
Defines list or set of allowable inputs |
||
→ |
in |
(Structure or 0) Color specifications |
|
in |
Various expansion features |
||
in |
Maximum number of characters allowed (independent of xmax) |