setpup(3G)							    setpup(3G)

NAME    [Toc]    [Back]

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

C SPECIFICATION    [Toc]    [Back]

     void setpup(pup, entry, mode)
     long pup, entry;
     unsigned long mode;

PARAMETERS    [Toc]    [Back]

     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:

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

	     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.

DESCRIPTION    [Toc]    [Back]

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

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

     defpup, dopup, freepup, newpup

NOTE    [Toc]    [Back]

     This routine is available only in immediate mode.


									PPPPaaaaggggeeee 2222