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►
─────Displaying Message Boxes───────────────────────────────────────────────
 
     The MESSAGEBOXQQ function causes your program to display a
     message box. The function's interface is defined as follows in
     FLIB.FI:
 
           INTERFACE TO INTEGER*2 FUNCTION MESSAGEBOXQQ(MSG,
          + CAPTION,MTYPE)
           CHARACTER*(*) MSG
           CHARACTER*(*) CAPTION
           INTEGER*2 MTYPE
           END
 
     The MSG and CAPTION parameters specify the message the box
     displays and the caption that appears in its title bar. Both
     strings must be null-terminated; use the C string notation.
 
     The MTYPE parameter determines the objects and attributes of the
     message box. The symbolic constants listed below are defined in
     FLIB.FD. They can be combined by means of the IOR intrinsic
     function or the .OR. operator.
 
     MTYPE Value            Meaning
 
     MB$ABORTRETRYIGNORE    Abort, Retry, and Ignore buttons
     MB$DEFBUTTON1          First button is the default
     MB$DEFBUTTON2          Second button is the default
     MB$DEFBUTTON3          Third button is the default
     MB$ICONASTERISK        Lowercase i icon
     MB$ICONEXCLAMATION     Exclamation icon
     MB$ICONHAND            Stop-sign icon
     MB$ICONINFORMATION     Lowercase i icon
     MB$ICONQUESTION        Question-mark icon
     MB$ICONSTOP            Stop-sign icon
     MB$OK                  OK button
     MB$OKCANCEL            OK and Cancel buttons
     MB$RETRYCANCEL         Retry and Cancel buttons
     MB$SYSTEMMODAL         Box is system-modal
     MB$YESNO               Yes and No buttons
     MB$YESNOCANCEL         Yes, No, and Cancel buttons
 
     The MESSAGEBOXQQ function returns zero if memory is not
     sufficient for displaying the message box. Otherwise, one of the
     following values is returned, indicating the user's response to
     the message box:
 
     Return Value           Meaning
 
     MB$IDABORT             The Abort button was pressed
     MB$IDCANCEL            The Cancel button was pressed
     MB$IDIGNORE            The Ignore button was pressed
     MB$IDNO                The No button was pressed
     MB$IDOK                The OK button was pressed
     MB$IDRETRY             The Retry button was pressed
     MB$IDYES               The Yes button was pressed
                                    -♦-