INQUIRE command
Syntax: |
INQUIRE 'your message' v1 { v2 ... }
|
Qualifiers: |
\YESNO
|
This command can only be used in script command files.
A small form will be opened displaying 'your message'
string.
If the variables v1, v2,
etc. exist already, the user is expected to provide
the correct number and type of values
corresponding to those variable names. These values are entered into an edit box provided
on the form. If any of the variables do not pre-exist, they are assumed to be scalars.
If you do not enter anything into the edit box, the pre-existing variables are left
unchanged.
If the \YESNO
qualifier is used, no edit box
will be provided, but 'your message'
will be
displayed and when the user clicks on the YES
(NO
) key
the text string YES
(NO
) will be returned in the
answer
text variable. Since a single text variable
is always expected, the answer
variable does not need to pre-exist.
If the user clicks on the Stop all scripts
button, the current command
script will be stopped and any calling scripts will also be stopped.
Example
INQUIRE\YESNO 'Do you want to continue?' TXT
IF EQS(UCASE(TXT),'YES') THEN ! valid response
...
GOTO CONTINUE ! continue with the macro
ENDIF
...
CONTINUE:
...
Example
VECTOR X 1
INQUIRE 'Enter a vector of length 5 and a scalar' X S
The first command defines X
to be a vector of
length 1
. The INQUIRE
command
will display the message and wait for you to type in a vector set and a single value.
For example: [0;1;3.5;-4;100] 10.3