*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> standard/setpup (3)              


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

	     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

									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
[ Back ]
 Similar pages
Name OS Title
setcursor IRIX sets the cursor characteristics
stty Tru64 Sets terminal characteristics
acl_set_permset Tru64 Sets permissions in a given ACL entry
acl_set_tag_type Tru64 Sets the tag type in an ACL entry
acl_set_qualifier Tru64 Sets the tag qualifier (UID or GID) on an ACL entry
DXmSvnSetEntryPosition Tru64 Sets the position of an entry in
XmSetFontUnits HP-UX A function that sets the font unit value for a display
XmSetFontUnit HP-UX A function that sets the font unit value for a display
dbtext IRIX sets the dial and button box text display
XmSetFontUnits IRIX A function that sets the font unit value for a display
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service