tixSelect man page on SuSE

Man page or keyword search:  
man Server   14857 pages
apropos Keyword Search (all sections)
Output format
SuSE logo
[printable version]

tixSelect(n)		     Tix Built-In Commands		  tixSelect(n)

______________________________________________________________________________

NAME
       tixSelect - Create and manipulate tixSelect widgets

SYNOPSIS
       tixSelect pathName ?options?

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

STANDARD OPTIONS
       The Select widget supports all the standard options of a frame  widget.
       See the options(n) manual entry for details on the standard options.

WIDGET-SPECIFIC OPTIONS
       [-allowzero allowZero]  A  boolean  value  that	specifies  whether the
       selection can be empty.	When set to false, at least one button subwid‐
       get must be selected at any time.

       Note:  When  the Select widget is first constructed, the default selec‐
       tion is always empty, even if -allowzero is set	to  false.   [-button‐
       type buttonType]	 The  type  of buttons to be used as subwidgets inside
       the Select widget.  By default, the standard Tk button widget class  is
       used.  [-command command] Specifies the TCL command to be executed when
       the -value of the Select	 widget	 is  changed.  This  command  will  be
       invoked with two arguments. The first is the name of the button subwid‐
       get that has toggled. The second is a boolean value indicating  whether
       the  button  subwidget  is selected. This command is executed only when
       the -disableCallback option is set  to  false.	[-disablecallback dis‐
       ableCallback]  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 Select widget changes.

       Name:	      orientation
       Class:	      Orientation
       Switch:	      -orientation
       Alias:	      -orient

	      Specifies	 the  orientation  of  the button subwidgets. Only the
	      values horizontal and vertical are recognized. This is a	static
	      option  and  it  can only be assigned during the creation of the
	      widget.  [-label label] Specifies the string to display  as  the
	      label  of	 this Select widget.  [-labelside labelSide] Specifies
	      where the label should be displayed relative to the Select  wid‐
	      get.  Valid  options  are:  top,	left,  right,  bottom, none or
	      acrosstop.   [-padx padX]	 Specifies  the	  horizontal   padding
	      between  two  neighboring	 button	 subwidgets.  This is a static
	      option and it can only be assigned during the  creation  of  the
	      widget.  [-padx padY] Specifies the vertical padding between two
	      neighboring button subwidgets. This is a static  option  and  it
	      can  only	 be  assigned  during  the  creation  of  the  widget.
	      [-radio radio] A boolean value that specifies whether the Select
	      widget  should act as a radio-box. When set to true, at most one
	      button subwidget can be selected at any time. This is  a	static
	      option  and  it  can only be assigned during the creation of the
	      widget.  [-selectedbg selectedBg] Specifies the background color
	      of all the selected button subwidgets.  [-state state] Specifies
	      the state of all the buttons inside the Select widget.  Only the
	      values normal and disabled are recognized. When the state is set
	      to disabled, all user actions on this Select widget are  ignore.
	      [-validatecmd validateCmd]  Specifies a TCL command to be called
	      when the -value of the Select widget is about  to	 change.  This
	      command  is  called with one parameter -- the new -value entered
	      by the user. This command is  to	validate  this	new  value  by
	      returning a value it deems valid.	 [-value value] The value of a
	      Select widget is a list of the names of  the  button  subwidgets
	      that have been selected by the user.

	      When  you	 assign the value of a Select widget using the "config
	      -value" widget command, the TCL command specified by  the	 -com‐
	      mand  option  will be invoked if some button subwidgets are tog‐
	      gled.  [-variable variable] Specifies  the  global  variable  in
	      which the value of the Select widget should be stored. The value
	      of a Select widget is stored as a list of the names of the  but‐
	      ton subwidgets that have been selected by the user. The value of
	      the Select widget will be automatically updated when this	 vari‐
	      able is changed.

SUBWIDGETS
       Name:	      label
       Class:	      Label

	      The label subwidget.

       In  addition,  all the button subwidgets created as a result of the add
       widget command can be accessed by the subwidget command. They are iden‐
       tified  by  the buttonName parameter to the add widget command. Here is
       an example:

	      set s [tixSelect .s]
	      pack $s
	      $s add eat   -text Eat
	      $s add sleep -text Sleep
	      $s subwidget eat	 config -fg green
	      $s subwidget sleep config -fg red
_________________________________________________________________

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

       The Select widget is a container of button subwidgets. It can  be  used
       to  provide  radio-box  or check-box style of selection options for the
       user.

WIDGET COMMANDS
       The tixSelect command creates a new Tcl command whose name is the  same
       as  the	path  name of the Select widget'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 Select
       widget's path name. Option and the args determine the exact behavior of
       the command.  The following commands are possible for Select widgets:

       pathName add buttonName ?option value ... ?
	      Adds  a  new  button subwidget with the name buttonName into the
	      Select widget. Additional configuration options can be given  to
	      configure the new button subwidget.

       pathName cget option
	      Returns  the  current value of the configuration option given by
	      option. Option may have any of the values accepted by the tixSe‐
	      lect 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 tixSelect command.

       pathName invoke buttonName
	      Invokes the button subwidget with the name buttonName.

       pathName subwidget name ?args?
	      When no options are given, 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.

BINDINGS
       When  the  user presses the left mouse button over the a button subwid‐
       get, it will be toggled and the -value option of the  tixSelect	widget
       will be changed.

EXAMPLE
       The following example creates a radio-box style iconbar for the user to
       choose one value among eat, work or sleep.

	      set s [tixSelect .s -radio true -allowzero false]
	      $s add eat   -bitmap [tix getbitmap eat]
	      $s add work  -bitmap [tix getbitmap work]
	      $s add sleep -bitmap [tix getbitmap sleep]

KEYWORDS
       Tix(n), Container Widget

Tix				      4.0			  tixSelect(n)
[top]

List of man pages available for SuSE

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net