NAME

dopup − displays the specified pop-up menu

SPECIFICATION

C
long dopup(pup)
long pup;

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

Pascal
procedure dopup(pup: longint): longint;

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.  If no selection is made, dopup returns −1.  Item selection is performed by either selecting or rolling off the side of a menu item. When the menu is defined, defpup or addtopup specify the list of menu entries and their corresponding actions.  See defpup for details. 

SEE ALSO

addtopup, defpup, freepup, newpup Using mex , Chapter 3, Making Pop-Up Menus

NOTE

This routine is available only in immediate mode under the window manager. 

Version 3.6  —  December 20, 1987