Control man page on IRIX

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



     tixControl(n)		 Tix (4.0)		 tixControl(n)

     _________________________________________________________________

     NAME
	  tixControl - Create and manipulate tixControl widgets

     SYNOPSIS
	  tixControl pathName ?options?

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

     STANDARD OPTIONS
	  The Control 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
	  Name:		 allowEmpty
	  Class:	 AllowEmpty
	  Switch:	 -allowempty

	       Specifies whether the Control widget should  allow  the
	       empty string as a valid input.

	  Name:		 autorepeat
	  Class:	 AutoRepeat
	  Switch:	 -autorepeat

	       Specifies  whether  the	Control	 widget	 should	  have
	       autorepeat behavior.  If set to be "true", the value of
	       the Control widget will be automatically incremented or
	       decremented  when  the user holds down the mouse button
	       over the arrow buttons. Only values "true" and  "false"
	       will be recognized.

	  Name:		 command
	  Class:	 Command
	  Switch:	 -command

	       Specifies the command to	 be  called  when  the	-value
	       option  of  the Control widget is changed.  The command
	       will be called with one arguments -- the new  value  of
	       the Control widget.

	  Name:		 decrCmd
	  Class:	 DecrCmd
	  Switch:	 -decrcmd

	       Specifies a TCL command to be called when the the  user
	       presses	the  down-arrow button subwidget. This command

     Page 1					    (printed 12/22/98)

     tixControl(n)		 Tix (4.0)		 tixControl(n)

	       is called with one parameter -- the current  -value  of
	       this  Control widget. This command is to decrement this
	       value by one step, according to its own	definition  of
	       "decrement",  and  return  the decremented value, which
	       will be stored in the -value of this Control widget.

	  Name:		 disableCallback
	  Class:	 DisableCallback
	  Switch:	 -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 Control widget changes.

	  Name:		 disableForeground
	  Class:	 DisableForeground
	  Switch:	 -disableforeground

	       The foreground color to use for of the entry  subwidget
	       when the Control widget is disabled.

	  Name:		 incrCmd
	  Class:	 IncrCmd
	  Switch:	 -incrcmd

	       Specifies a TCL command to be called when the the  user
	       presses	the up-arrow button subwidget. This command is
	       called with one parameter -- the current -value of this
	       Control widget. This command is to increment this value
	       by  one	step,  according  to  its  own	definition  of
	       "increment",  and  return  the incremented value, which
	       will be stored in the -value of this Control widget.

	  Name:		 initwait
	  Class:	 Initwait
	  Switch:	 -initwait

	       Specifies how  long  the	 Control  widget  should  wait
	       initially  before  it starts to automatically increment
	       or decrement its	 value	in  the	 autorepeat  mode.  In
	       milliseconds.

	  Name:		 integer
	  Class:	 Integer
	  Switch:	 -integer

	       A Boolean value specifying whether only integer numbers
	       are accepted.

	  Name:		 label
	  Class:	 Label

     Page 2					    (printed 12/22/98)

     tixControl(n)		 Tix (4.0)		 tixControl(n)

	  Switch:	 -label

	       Specifies the string to display as the  label  of  this
	       Control widget.

	  Name:		 labelSide
	  Class:	 LabelSide
	  Switch:	 -labelside

	       Specifies where the label should be displayed  relative
	       to  the	entry subwidget. Valid options are: top, left,
	       right, bottom, none or acrosstop.

	  Name:		 max
	  Class:	 Max
	  Switch:	 -max
	  Alias:	 -ulimit

	       Specifies the upper limit of the value of  the  Control
	       widget.	When  set  to empty string, the Control widget
	       has no upper limit.

	  Name:		 min
	  Class:	 Min
	  Switch:	 -min
	  Alias:	 -llimit

	       Specifies the lower limit of the value of  the  Control
	       widget.When set to empty string, the Control widget has
	       no lower limit.

	  Name:		 repeatRate
	  Class:	 RepeatRate
	  Switch:	 -repeatrate

	       Specifies how often the value  of  the  Control	widget
	       should  be incremented or decremented when it is in the
	       autorepeat mode. In milliseconds.

	  Name:		 selectMode
	  Class:	 SelectMode
	  Switch:	 -selectmode

	       Specifies  how  the  Control  widget  should  react  to
	       <KeyPress>  events.  When  set to "immediate", any user
	       keyboard inputs	will  immediately  change  the	-value
	       option.	When set to "normal", the user keyboard inputs
	       will be	copied	to  the	 -value	 option	 only  if  the
	       <Return>	 key  is  pressed  or  the  keyboard  focus is
	       changed. The use of the immediate mode is  discouraged.
	       For effective use of the Control widget, one should use
	       the normal mode together with the update widget command

     Page 3					    (printed 12/22/98)

     tixControl(n)		 Tix (4.0)		 tixControl(n)

	       (see below).

	  Name:		 state
	  Class:	 State
	  Switch:	 -state

	       Specifies the whether the Control widget is  normal  or
	       disabled.   Only the values "normal" and "disabled" are
	       recognized.

	  Name:		 step
	  Class:	 Step
	  Switch:	 -step

	       Specifies by how much the value of the  Control	widget
	       should be incremented or decrmented when the user press
	       the arrow buttons.

	  Name:		 validateCmd
	  Class:	 ValidateCmd
	  Switch:	 -validatecmd

	       Specifies a TCL command to be called when the -value of
	       the  Control 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.

	  Name:		 value
	  Class:	 Value
	  Switch:	 -value

	       Specifies the value of the Control widget.

	  Name:		 variable
	  Class:	 Variable
	  Switch:	 -variable

	       Specifies the global variable in which the value of the
	       Control	widget	should	be  stored.  The  value of the
	       Control widget will be automatically updated when  this
	       variable is changed.

     SUBWIDGETS
	  Name:		 decr
	  Class:	 Button

	       The down arrow button.

	  Name:		 entry
	  Class:	 Entry

     Page 4					    (printed 12/22/98)

     tixControl(n)		 Tix (4.0)		 tixControl(n)

	       The entry that shows the value of this Control widget.

	  Name:		 incr
	  Class:	 Button

	       The up arrow button.

	  Name:		 label
	  Class:	 Label

	       The label subwidget.
     _________________________________________________________________

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

	  The Control widget is also known as the SpinBox widget.   It
	  is  generally	 used  to control a value. The user can adjust
	  the value by pressing the two arrow buttons or  by  entering
	  the  value  directly	into  the entry. The new value will be
	  checked against the user-defined upper and lower limits.

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

     Page 5					    (printed 12/22/98)

     tixControl(n)		 Tix (4.0)		 tixControl(n)

	       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  tixControl
	       command.

	  pathName decr
	       Decrements the value of the Control widget by the  step
	       specified by the -step option.

	  pathName incr
	       Increments the value of the Control widget by the  step
	       specified by the -step option.

	  pathName invoke
	       Causes the command specified by the -command option  to
	       be invoked.

	  pathName update
	       If the user  has	 modified  the	entry  using  keyboard
	       inputs,	the  update  command will update the -value of
	       this  Control  widget.  When   the   Control   widget's
	       -selectmode  option is set to "normal", one should call
	       the update command on this widget before examining  its
	       -value  option.	This  command  has no effect in if the
	       -selectmode option is set to "immediate".

	  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 subwidget will be called with these options.

     BINDINGS
	  When the user presses the up/down arrow  buttons  (or	 press
	  the  <Up>  and <Down> arrow keys on the keyboard), the value
	  of the  tixControl  widget  is  adjusted  according  to  the
	  -validatecmd,	 -incrcmd,  -decrcmd,  -step,  -max  and  -min
	  options.

     KEYWORDS
	  Tix(n)

     Page 6					    (printed 12/22/98)

[top]

List of man pages available for IRIX

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