Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
tixPopupMenu(n)		     Tix Built-In Commands	       tixPopupMenu(n)

       tixPopupMenu - Create and manipulate tixPopupMenu widgets

       tixPopupMenu pathName ?options?

       The  tixPopupMenu class is derived from the TixShell class and inherits
       all the commands, options and subwidgets	of its super-class.

       The PopupMenu widget supports all the standard options of a frame  wid-
       get.   See  the options(n) manual entry for details on the standard op-

       [-buttons buttons] A Tcl	list that specifies the	 mouse	button(s)  and
       key modifier(s) that bring up the popup menu. Each element of this list
       is in turn a list that contains two elements: the first element	is  an
       integer	that indicates the mouse button	that brings up the popup menu;
       the second element specifies the	key modifiers that should be  used  in
       conjunction  with the mouse button. For example,	the value {{1 {Control
       Meta}} {3 {Any}}} specifies that	the popup menu can be popped up	by (a)
       pressing	 mouse button 1	with either the	Control	or the Meta key	or (b)
       pressing	mouse button 3 with any	key modifier. The default value	is {{3
       {Any}}}:	  only	 mouse	 button	  3   brings   up   the	  popup	 menu.
       [-postcmd postCmd] Specifies a command to be evaluated just before  the
       menu  is	about to pop-up. This command is called	with two default argu-
       ments: the root x-y coordinates where the user has  pressed  the	 mouse
       button.	This  command  must  return a boolean value: a false indicates
       that the	menu shouldn't be popped up at this point;  a  true  indicates
       that  the menu should be	popped up. This	option can be used to find out
       where the user has pressed the mouse-button and optionally disable  the
       popup  menu  over  certain  screen areas.  [-spring spring] When	set to
       true, the menu will be automatically popped down	if the	user  releases
       the  mouse  button outside of the menu and no menu commands will	be in-
       voked. This makes it easy for the user to cancel	the popup menu without
       pressing	 the  Escape  key.  The	default	value is true.	[-state	state]
       Must be either disabled or normal. The PopupMenu	widget will not	pop up
       unless  its  -state  is set to normal.  [-title title] Specifies	a text
       string to display inside	the menubutton subwidget, as the title of this

       Name:	      menu
       Class:	      Menu

	      The menu subwidget.

       Name:	      menubutton
       Class:	      Menubutton

	      The menubutton subwidget.

       The  tixPopupMenu  command  creates a new window	(given by the pathName
       argument) and makes it into a PopupMenu	widget.	  Additional  options,
       described  above, may be	specified on the command line or in the	option
       database	to configure aspects of	the PopupMenu widget such as its  cur-
       sor and relief.

       The  Tix	 PopupMenu widget can be used as a replacement of the tk_popup
       command.	The advantage of the Tix PopupMenu widget is it	requires  less
       application code	to manipulate. Also, it	provides a title for the popup
       menu, which is not available from tk_popup.

       The tixPopupMenu	command	creates	a new Tcl command whose	 name  is  the
       same  as	 the path name of the PopupMenu	widget's window.  This command
       may be used to invoke various operations	on the widget. It has the fol-
       lowing general form:
	      pathName option ?arg arg ...?
       PathName	is the name of the command, which is the same as the PopupMenu
       widget's	path name. Option and the args determine the exact behavior of
       the command. The	following commands are possible	for PopupMenu widgets:

       pathName	bind widget ?widget ...?
	      Binds  this PopupMenu to one or more widgets. The	PopupMenu will
	      be activated when	the user presses the right mouse  button  over
	      these widgets.

       pathName	cget option
	      Returns  the  current value of the configuration option given by
	      option. Option may have any of the values	accepted by  the  tix-
	      PopupMenu	command.

       pathName	configure ?option? ?value option value ...?
	      Query  or	modify the configuration options of the	widget.	 If no
	      option is	specified, returns a list describing all of the	avail-
	      able  options for	pathName (see Tk_ConfigureInfo for information
	      on the format of this list).  If option  is  specified  with  no
	      value,  then the command returns a list describing the one named
	      option (this list	will be	identical to the corresponding sublist
	      of  the  value  returned	if no option is	specified).  If	one or
	      more option-value	pairs are specified, then the command modifies
	      the  given  widget option(s) to have the given value(s); in this
	      case the command returns an empty	string.	 Option	may  have  any
	      of the values accepted by	the tixPopupMenu command.

       pathName	post widget x y
	      Posts the	PopupMenu inside the widget at the coordinate x,y.

       pathName	unbind widget ?widget ...?
	      Cancels the PopupMenu's binding with the widget(s).

       pathName	subwidget  name	?args?
	      When  no options are given, this command returns the pathname of
	      the subwidget of the specified name.

	      When options are given, the widget command of the	specified sub-
	      widget will be called with these options.


Tix				      4.0		       tixPopupMenu(n)


Want to link to this manual page? Use this URL:

home | help