Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                             ◄Up► ◄Contents► ◄Index► ◄Back►
─────PWB Extensions─────────────────────────────────────────────────────────
 
  Syntax:  int GetString( char far *Response, char far *Prompt,
                          flagType fDefault );
 
  Returns: True when the user chooses Cancel, otherwise false.
 
  See:     ReadChar, DoMessageBox, DoMessageBoxHelp, SelectFile,
           SelectFiles, ◄PWB Text Argument Dialog Box►
 
     GetString prompts the user for a string with the Text Argument
     dialog box and optionally provides a default response. The user can
     type a string in the text box and then press ENTER, or choose the
     Cancel button.
 
     Argument     Description
 
     <Response>   String that receives the string typed by the user.
                  When <fDefault> is TRUE, the <Response> string also
                  gives the default response.
 
                  The <Response> character array should be large enough
                  to handle the longest expected return value. The
                  longest possible string that can be returned is BUFLEN
                  characters long.
 
     <Prompt>     Caption for the query box.
 
     <fDefault>   Indicates whether to use a default response. If TRUE,
                  PWB places the <Response> string in the text box and
                  selects it.
                                    -♦-