                              MSGBOX.TXT
                              ----------

Syntax: msgbox(<expC1>), <expC2>, <expN>)

Purpose: Displays a message box with push buttons. Identical to the 
         msgbox() function in the FoxPro for Windows library Foxtools.Fll.

Parameters: expC1: Text to be displayed in message box.
            expC2: Title of Message Box
            expN:  Which push button set to display (see below)

ExpN is used to determine which set of push buttons to display at the
bottom of the message box. The following chart is used:

ExpN   Push Button Set
----   ---------------
 0     OK
 1     OK, Cancel
 2     Abort, Retry, Ignore
 3     Yes, No, Cancel
 4     Yes, No
 5     Retry, Cancel
 6     N/A
 7     N/A
 8     Abort, Retry
 9     OK, Cancel, Abort, Retry, Ignore
10     N/A
11     N/A
12     Yes
13     N/A
14     Cancel, Retry
15     N/A

Note - FoxPro for Windows has no valid push buttons for 
       options 6,7,10,11,13 and 15.  Calling this program with one of the
       unsupported options will function like option 0 (OK push button).

Note - FoxPro for Windows can display an optional graphics symbol in the
       message box.  This symbol is determined by adding the following 
       number to expN:
       Symbol to Display    Number to add to expN
       -----------------    ---------------------
       <No Symbol>          0
       Stop Sign            16
       Question Mark        32
       Exclamation Point    48
       Info symbol "i"      64

       Although this DOS msgbox routine does not display a graphic symbol,
       it supports the syntax for displaying the graphics. Fox example, if
       this routine is called with expN of 16 (in Windows, it displays a
       stop sign and the OK push button), the OK push button will be 
       displayed.

Returns: Values returned are identical to the FPW msgbox() function. The
         return value is explained in the following table:

         Button Pressed      Value Returned
         --------------      --------------
         OK                  1
         Cancel              2
         Abort               3
         Retry               4
         Ignore              5
         Yes                 6
         No                  7

Misc: This function normally issues a modal read to get input from the user. 
      If, however, rdlevel() = 5 when function is called, the function
      will still work properly with full hot key and mouse support.

      Function will always be centered in screen.

      Size of message box is automatically adjusted to fit long text or
      embedded carriage returns (chr(13)).  Will work properly in any display
      mode (i.e. VGA50).
