dopup(3G)							     dopup(3G)

NAME    [Toc]    [Back]

     dopup - displays the specified pop-up menu

C SPECIFICATION    [Toc]    [Back]

     long dopup(pup)
     long pup;

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     addtopup, defpup, freepup,	newpup,	setpup

NOTE    [Toc]    [Back]

     This routine is available only in immediate mode.


									PPPPaaaaggggeeee 1111