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

FreeBSD Manual Pages

  
 
  

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

NAME
       tixOptionMenu - Create and manipulate tixOptionMenu widgets

SYNOPSIS
       tixOptionMenu pathName ?options?

SUPER-CLASS
       The  TixOptionMenu  class  is derived from the TixLabelWidget class and
       inherits	all the	commands, options and subwidgets of its	super-class.

STANDARD OPTIONS
       The OptionMenu widget supports all the standard Tix widget options. See
       the  Tix-Options(n) manual entry	for details on the standard Tix	widget
       options.

WIDGET-SPECIFIC	OPTIONS
       [-command command] Specifies the	command	to be called when  the	-value
       option  of  the	OptionMenu is changed. The command will	be called with
       one arguments --	the new	value of the  OptionMenu  widget.   [-disable-
       callback	disableCallback]  A boolean value indicating whether callbacks
       should be disabled. When	set to true, the TCL command specified by  the
       -command	 option	is not executed	when the -value	of the OptionMenu wid-
       get changes.  [-dynamicgeometry dynamicGeometry]	A boolean value	 indi-
       cating  whether	the size of the	menubutton subwidget should change dy-
       namically to match the width of the currently selected menu  entry.  If
       set  to	false  (the default), the the size of the menubutton subwidget
       will be wide enough to display every menu  entry	 fully	and  does  not
       change  when the	user selects different entries.	 [-label label]	Speci-
       fies the	string to display as the  label	 of  this  OptionMenu  widget.
       [-labelside labelSide]  Specifies  where	 the label should be displayed
       relative	to the entry subwidget.	Valid options are: top,	 left,	right,
       bottom,	none  or  acrosstop.  [-state state] Specifies the whether the
       OptionMenu widget is normal or disabled.	Only the values	 "normal"  and
       "disabled"  are	recognized.  [-value value] Specifies the value	of the
       OptionMenu. The value of	the OptionMenu widget is the name of the  item
       currently  displayed by its menubutton subwidget.  [-variable variable]
       Specifies the global variable in	which  the  value  of  the  OptionMenu
       should be stored. The value of the OptionMenu will be automatically up-
       dated when this variable	is changed.

SUBWIDGETS
       Name:	      menu
       Class:	      Menu

	      The menu subwidget, which	is popped up when the user  press  the
	      menubutton subwidget.

       Name:	      menubutton
       Class:	      Menubutton

	      The menubutton subwidget.

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

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

       pathName	add type name ?option value ...?
	      Adds  a new item into the	OptionMenu widget. type	must be	either
	      command or separator. The	options	may be any of  the  valid  op-
	      tions  for  the command or separator menu	entry types for	the TK
	      menu widget class, except	-command.

       pathName	cget option
	      Returns the current value	of the configuration option  given  by
	      option. Option may have any of the values	accepted by the	tixOp-
	      tionMenu 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 tixOptionMenu command.

       pathName	delete name
	      Deletes the menu entry identified	by name.

       pathName	disable	name
	      Disables the menu	entry identified by name.

       pathName	enable name
	      Enables the menu entry identified	by name.

       pathName	entrycget name option
	      Returns the current value	of the configuration option  given  by
	      option in	the menu entry identified by name. Option may have any
	      of the values accepted by	the add	widget command.

       pathName	entryconfigure name ?option? ?value option value ...?
	      Query or modify the configuration	 options  of  the  menu	 entry
	      identified  by  name.  If	no option is specified,	returns	a list
	      describing all of	the available options for the menu entry  (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 identi-
	      cal to the corresponding sublist of the value returned if	no op-
	      tion is specified). If one or more option-value pairs are	speci-
	      fied, then the command modifies the given	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  add
	      widget command.

       pathName	entries
	      Returns the names	of all the entries currently in	the OptionMenu
	      widget.

       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.

KEYWORDS
       Tix(n)

Tix				      4.0		      tixOptionMenu(n)

NAME | SYNOPSIS | SUPER-CLASS | STANDARD OPTIONS | WIDGET-SPECIFIC OPTIONS | SUBWIDGETS | DESCRIPTION | WIDGET COMMANDS | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tixOptionMenu&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help