setpup(3G) setpup(3G)
NAME
setpup - sets the display characteristics of a given pop up menu entry
C SPECIFICATION
void setpup(pup, entry, mode)
long pup, entry;
unsigned long 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 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
symbolic constants:
PUPNONE, no special display characteristics, fully functional if
selected. This is the default mode for newly created menu
entries.
PUPGREY, 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.
PUPCHECK 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();
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
1.
Page 1
setpup(3G) setpup(3G)
SEE ALSO
defpup, dopup, freepup, newpup
NOTE
This routine is available only in immediate mode.
Page 2