iwidgets::spinint(1) [incr Widgets] iwidgets::spinint(1)

NAME
       iwidgets::spinint - Create and manipulate a integer spinner widget

SYNOPSIS
       iiwwiiddggeettss::::ssppiinniinntt pathName ?options?

IINNHHEERRIITTAANNCCEE
       itk::Widget  <-  iwidgets::Labeledwidget  <- iwidgets::Spinner <- iwid-
       gets::Spinint

SSTTAANNDDAARRDD OOPPTTIIOONNSS
       bbaacckkggrroouunndd         bboorrddeerrWWiiddtthh     ccuurrssoorr              eexxppoorrttSSeelleeccttiioonn
       ffoorreeggrroouunndd         hhiigghhlliigghhttCCoolloorr  hhiigghhlliigghhttTThhiicckknneessss  iinnsseerrttBBaacckkggrroouunndd
       iinnsseerrttBBoorrddeerrWWiiddtthh  iinnsseerrttOOffffTTiimmee   iinnsseerrttOOnnTTiimmee        iinnsseerrttWWiiddtthh
       jjuussttiiffyy            rreelliieeff          sseelleeccttBBaacckkggrroouunndd    sseelleeccttBBoorrddeerrWWiiddtthh
       sseelleeccttFFoorreeggrroouunndd   tteexxttVVaarriiaabbllee

       See the "options" manual entry for details on the standard options.

AASSSSOOCCIIAATTEEDD OOPPTTIIOONNSS
       sshhooww            ssttaattee

       See the "entry" manual entry for details on the associated options.

IINNHHEERRIITTEEDD OOPPTTIIOONNSS
       ccoommmmaanndd         cchhiillddSSiitteePPooss   ffiixxeedd           ffooccuussCCoommmmaanndd
       iinnvvaalliidd         tteexxttBBaacckkggrroouunndd tteexxttFFoonntt        vvaalliiddaattee
       wwiiddtthh

       See the "entryfield" widget manual  entry  for  details  on  the  above
       inherited options.

       ddiissaabblleeddFFoorreeggrroouunndd             llaabbeellBBiittmmaapp     llaabbeellFFoonnttllaabbeellIImmaaggee
       llaabbeellMMaarrggiinn     llaabbeellPPooss       llaabbeellTTeexxtt       llaabbeellVVaarriiaabbllee
       ssttaattee           ssttiicckkyy

       See  the  "labeledwidget"  widget manual entry for details on the above
       inherited options.

       aarrrroowwoorriieenntt     ddeeccrreemmeenntt      iinnccrreemmeenntt       rreeppeeaattDDeellaayy
       rreeppeeaattIInntteerrvvaall

       See the "spinner" widget manual entry for details on the  above  inher-
       ited options.


WWIIDDGGEETT-SSPPEECCIIFFIICC OOPPTTIIOONNSS
       Name:           rraannggee
       Class:          RRaannggee
       Command-Line Switch:           -rraannggee

              Specifies a two element list of minimum and maximum integer val-
              ues.  The default is no range, {{} {}}.

       Name:           sstteepp
       Class:          SStteepp
       Command-Line Switch:           -sstteepp

              Specifies the increment/decrement value.  The default is 1.

       Name:           wwrraapp
       Class:          WWrraapp
       Command-Line Switch:           -wwrraapp

              Specifies whether to wrap the spinner value  upon  reaching  the
              minimum  or  maximum  value  in  any  of the forms acceptable to
              TTccllGGeettBBoooolleeaann.  The default is true.




DESCRIPTION
       The iiwwiiddggeettss::::ssppiinniinntt command creates a spinint  widget.   The  spinint
       allows  "spinning" of integer values within a specified range with wrap
       support.  The spinner arrows may be drawn horizontally or vertically.



MMEETTHHOODDSS
       The iiwwiiddggeettss::::ssppiinniinntt command creates a new Tcl command whose  name  is
       pathName.  This command may be used to invoke various operations on the
       widget.  It has the following general form:

              pathName option ?arg arg ...?

       Option and the args determine the exact behavior of the  command.   The
       following commands are possible for spinint widgets:

AASSSSOOCCIIAATTEEDD MMEETTHHOODDSS
       ddeelleettee          ggeett            iiccuurrssoorr         iinnddeexx
       iinnsseerrtt          ppeeeekk           ssccaann            sseelleeccttiioonn
       xxvviieeww

       See the "entry" manual entry for details on the associated methods.

IINNHHEERRIITTEEDD MMEETTHHOODDSS
       cchhiillddssiittee       cclleeaarr

       See  the  "entryfield" manual entry for details on the associated meth-
       ods.

WWIIDDGGEETT-SSPPEECCIIFFIICC MMEETTHHOODDSS
       pathName ccggeett option
              Returns the current value of the configuration option  given  by
              option.  Option may have any of the values accepted by the iiwwiidd-
              ggeettss::::ssppiinniinntt command.

       pathName ccoonnffiigguurree ?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 TTkkCCoonnffiigguurreeIInnffoo 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 iiwwiiddggeettss::::ssppiinniinntt command.

       pathName ddoowwnn
              Decrement the spinner value by  the  value  given  in  the  step
              option.

       pathName uupp
              Increment  the  spinner  value  by  the  value given in the step
              option.


CCOOMMPPOONNEENNTTSS
              See the "Spinner" widget manual entry for details on the integer
              spinner component items.


EEXXAAMMPPLLEE
               package require Iwidgets 4.0
               option add *textBackground white

               iwidgets::spinint .si -labeltext "Temperature" -labelpos w \
                  -fixed yes -width 5 -range {32 212}

               pack .si -pady 10


AUTHOR       Sue Yockey

KKEEYYWWOORRDDSS
       spinint, widget



Tk                                                        iwidgets::spinint(1)