[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
INQUIRE <message> TO <getvar> [HEADER <header>] ;
[TOP <top>] [LEFT <left>] ;
[SHADOW <mshadow>] [FRAME <mframe>]
----------------------------------------------------------------------------
Purpose: This command obtains user input to a variable.
It displays a string or an array of strings in a window
then performs a GET to the variable, 'Var2Read'. Various
exit methods are allowed. The colour is defined in
twMsgInit() and the shadow and frame types default to those
of the currently active window.
Parameters: message - 'C' String to be displayed. The string can be
any length. It is truncated to fit
inside the display window.
- 'A' Array of strings to be used for
messages. The window is fitted to the
maximum length.
getvar - 'C' Variable name to which to provide
input.
header - 'C' String to use for the title. In this
version, the title is centered on the top
line of the window.
wait - 'N' 0 - Wait for a key press then restore
the underlying screen.
-1 - Leave the message on the screen
and free the stack allocation space.
-2 - Leave the message on the screen but
keep it on the stack to be released
later with twMsgEnd().
n - Wait 'n' seconds or until a key is
pressed, then restore the underlying
screen.
Wait defaults to 0.
top, left - 'N' Screen Coordinates of top,left corner
of the display area. The defaults are
to center the window on the screen.
mshadow - 'N' TSDWIN shadow type. Defaults to the
shadow type for the currently active
window.
mframe - 'N' TSDWIN frame type. Defaults to the
frame type for the currently active
window.
Return: The value of the edited GET.
Example: INQUIRE "Trying to Use INQUIRE:" TO gvar HEADER "Get Try" ;
TOP 5 LEFT 23 SHADOW 9 FRAME 3
See Also:
twInquire()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson