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: void PopUpBoxColor( PFILE pfFile, char far *Title
                              int idHelp, fl flPosition
                              ISA Color );
 
          void PopUpBox( PFILE pfFile, char far *Title
                         int idHelp, fl flPosition );
 
  See:    DoMessageBox, DoMessageBoxHelp, ◄Using Files►
 
     PopUpBoxColor and PopUpBox display a file specified by <pfFile> in
     a pop-up window. The user can view or edit the text in the window.
     The pop-up window has a <Cancel> button that removes the window and
     a Help button to access Help.
 
     You cannot nest pop-up windows. If a pop-up window is already
     displayed, these functions return without performing any action.
     You cannot use CloseWnd to close a pop-up window.
 
     Many PWB and extension functions are unavailable while a pop-up
     window is displayed (Maximize, for example). Only those functions
     that have the POPUP attribute can be executed while a pop-up window
     is displayed.
 
     The <Title> string gives the title of the window.
 
     The <flPosition> specifies the row and column in the file to be
     displayed in the top-left corner of the window.
 
     If <idHelp> is nonzero, PWB displays a <Help> button at the bottom
     of the window. The value of idHelp is the number of a Help topic in
     the PWB.HLP file.
     See: ◄Using Help IDs►
 
     The <Color> specifies the color of the contents of the window. For
     PopUpBox, the current text color is used.
 
     These functions can be used to display messages that are too large
     for DoMessageBox. Create the message in a pseudofile, mark the
     pseudofile as read-only (using SetEditorObject), and display the
     file in a pop-up window.
                                    -♦-