Reference Guide

Full Command and Function Reference 3-117
Variable Function
{s
1
s
2
…
s
n
} Field definitions. A field definition (s
x
) can have two formats: “label”, a field
label, or { “label” “helpInfo” type
0
type
1
… type
n
}, a field label with optional help
text that appears near the bottom of the screen, and an optional list of valid
object types for that field. If object types aren’t specified, all object types are
valid. For information about object types, see the TYPE command.
When creating a multi-column dialog box, you can span columns by using an
empty list as a field definition. A field that appears to the left of an empty
field automatically expands to fill the empty space.
format Field format information. This is the number col or a list of the form { col tabs
}: col is the number of columns the dialog box has, and tabs optionally
specifies the number of tab stops between the labels and the highlighted
fields. This list can be empty. col defaults to 1 and tabs defaults to 3.
{ resets } Default values displayed when RESET is selected. Specify reset values in the
list in the same order as the fields were specified. To specify no value, use the
NOVAL command as a place holder. This list can be empty.
{ init } Initial values displayed when the dialog box appears. Specify initial values in
the list in the same order as the fields were specified. To specify no value, use
the NOVAL command as a place holder. This list can be empty.
If you exit the dialog box by selecting OK or `, INFORM returns the field values { vals } in
item 1 or level 2, and puts a 1 in item 2 or level 1. (If a field is empty, NOVAL is returned as a
place holder.) If you exit the dialog box by selecting CANCEL or B, INFORM returns 0.
Access: !°L IN INFORM ( °is the left-shift of the Nkey).
Input/Output:
L
5
/A
1
L
4
/A
2
L
3
A
3
L
2
/A
4
L
1
/A
5
L
2
/I
1
L
1
/I
2
“title” {s
1
s
2
... s
n
} format {resets } {init }
→
{ vals } 1
“title” {s
1
s
2
... s
n
} format {resets } {init }
→
0
L = Level; A = Argument; I = item
Example: Place the following five lines on the stack and run INFORM:
"The Title"
{ { "ONE" "Name?" 2 } { } { "TWO" "Age?" }
{ "THREE" "Lucky numbers?" 5 } }
{ 2 }
{ NOVAL NOVAL { 1 2 3 } }
{ "Charlotte" NOVAL { 4 5 6 } }
See also: CHOOSE, INPUT, NOVAL, TYPE
INPUT
Type: Command
Description: Input Command: Prompts for data input to the command line and prevents the user access to
stack operations.
When INPUT is executed, the stack or history area is blanked and program execution is
suspended for data input to the command line. The contents of “stack prompt” are displayed at the
top of the screen. Depending on the second argument (level 1), the command line may also
contain the contents of a string, or it may be empty. Pressing ` resumes program execution
and returns the contents of the command line in string form.