setpup(3G)

NAME
     setpup - sets the display characteristics of a given pop up menu entry

FORTRAN 77 SPECIFICATION
     subroutine setpup(pup,  entry, mode)
     integer*4 pup, entry, mode

PARAMETERS
     pup     expects the menu identifier of the menu whose entries you want to
             change. The menu identifier is the returned function value of the
             menu creation call to newpup.

     entry   expects the position of the entry in the menu, indexed from 1.

     mode    expects a symbolic constant that indicates the display
             characteristics you want to apply to the chosen entry.  You can
             specify more than one at a time by adding or logically or-ing
             these values together.  For this parameter there are four defined
             symbolic constants:

             PUPNON, no special display characteristics, fully functional if
             selected.  This is the default mode for newly created menu
             entries.

             PUPGRE, entry is greyed-out and disabled.  Selecting a greyed-out
             entry has the same behavior as selecting the title bar.  If the
             greyed-out entry has a submenu associated with it, that submenu
             does not display.

             PUPBOX Entry has an empty box to the left.

             PUPCHE Entry has a checked box to the left.

DESCRIPTION
     Use setpup to alter the display characteristics of a pop up menu entry.
     Currently, you use this routine to disable and grey-out a menu entry.

EXAMPLE
     Here is an example that disables a single entry:

     menu = newpup()
     call addtop(menu,'menu %t |item 1 |item 2 |item 3 |item 4', 39,0)
     call setpup(menu, 1, PUPGRE)


     Subsequent calls of dopup(menu) would display the menu with the menu
     entry labeled ``item 1'' is greyed out, and never gets a return value of
     1.
SEE ALSO
     dopup, freepu, newpup

NOTE
     This routine is available only in immediate mode.