setpup - sets the display characteristics of a given pop up menu entry
void setpup(pup, entry, mode)
long pup, entry;
unsigned long mode;
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 either newpup or defpup.
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
PUP_NONE, no special display characteristics, fully functional if
selected. This is the default mode for newly created menu
PUP_GREY, entry is greyed-out and disabled. Selecting a greyedout
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.
PUP_BOX Entry has an empty box to the left.
PUP_CHECK Entry has a checked box to the left.
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.
Here is an example that disables a single entry:
menu = newpup();
addtopup(menu,"menu %t |item 1 |item 2 |item 3 |item 4",0);
setpup(menu, 1, PUP_GREY);
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
defpup, dopup, freepup, newpup
This routine is available only in immediate mode.
PPPPaaaaggggeeee 2222 [ Back ]