Click above to get retro games delivered to your door ever month!

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