dopup(3G)

NAME
     dopup - displays the specified pop-up menu

FORTRAN 77 SPECIFICATION
     integer*4 function dopup(pup)
     integer*4 pup

PARAMETERS
     pup   expects the identifier of the pop-up menu you want to display.

FUNCTION RETURN VALUE
     The returned value of the function is the value of the item selected from
     the pop-up menu.  If the user makes no menu selection, the returned value
     of the function is -1.

DESCRIPTION
     dopup displays the specified pop-up menu until the user makes a
     selection. If the calling program has the input focus, the menu is
     displayed and dopup returns the value resulting from the item selection.
     The value can be returned by a submenu, a function, or a number bound
     directly to an item. Item selections are made with the right mouse
     button.  If no selection is made, dopup returns -1.

     When you first define the menu (using addtop) you specify the list of
     menu entries and their corresponding actions.  See addtop for details.

SEE ALSO
     addtop, freepu, newpup, setpup

NOTE
     This routine is available only in immediate mode.