dopup(3G)

NAME
     dopup - displays the specified pop-up menu

C SPECIFICATION
     long dopup(pup)
     long 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 defpup or addtopup) you specify the
     list of menu entries and their corresponding actions.  See addtopup for
     details.

SEE ALSO
     addtopup, defpup, freepup, newpup, setpup

NOTE
     This routine is available only in immediate mode.