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

NAME
       iwidgets::spintime - Create and manipulate time spinner widgets

SYNOPSIS
       iiwwiiddggeettss::::ssppiinnttiimmee pathName ?options?

IINNHHEERRIITTAANNCCEE
       itk::Widget <- iwidgets::Spintime


SSTTAANNDDAARRDD OOPPTTIIOONNSS
       bbaacckkggrroouunndd      ccuurrssoorr         ffoorreeggrroouunndd      rreelliieeff

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

AASSSSOOCCIIAATTEEDD OOPPTTIIOONNSS
       tteexxttBBaacckkggrroouunndd  tteexxttFFoonntt

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

       llaabbeellFFoonntt       llaabbeellMMaarrggiinn

       See the "labeledwidget" manual entry for details on the  above  associ-
       ated options.

       aarrrroowwOOrriieenntt     rreeppeeaattDDeellaayy    rreeppeeaattIInntteerrvvaall

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


WWIIDDGGEETT-SSPPEECCIIFFIICC OOPPTTIIOONNSS
       Name:           llaabbeellPPooss
       Class:          PPoossiittiioonn
       Command-Line Switch:           -llaabbeellppooss

              Specifies the position of the label along the sides of the vari-
              ous spinners: nn, ee, ss, or ww.  The default is w.

       Name:           hhoouurrLLaabbeell
       Class:          TTeexxtt
       Command-Line Switch:           -hhoouurrllaabbeell

              Specifies  the  text  of  the  label  for the hour spinner.  The
              default is "Hour".

       Name:           hhoouurrOOnn
       Class:          hhoouurrOOnn
       Command-Line Switch:           -hhoouurroonn

              Specifies whether or not to display the hour spinner in  any  of
              the forms acceptable to TTccllGGeettBBoooolleeaann.  The default is true.

       Name:           hhoouurrWWiiddtthh
       Class:          WWiiddtthh
       Command-Line Switch:           -hhoouurrwwiiddtthh

              Specifies  the  width  of  the  hour spinner in any of the forms
              acceptable to TTccllGGeettPPiixxeellss.  The default is 3 pixels.

       Name:           mmiilliittaarryyOOnn
       Class:          mmiilliittaarryyOOnn
       Command-Line Switch:           -mmiilliittaarryyoonn

              Specifies use of a 24 hour clock for hour display in any of  the
              forms acceptable to TTccllGGeettBBoooolleeaann.  The default is true.

       Name:           mmiinnuutteeLLaabbeell
       Class:          TTeexxtt
       Command-Line Switch:           -mmiinnuutteellaabbeell

              Specifies  the  text  of  the label for the minute spinner.  The
              default is "Minute".

       Name:           mmiinnuutteeOOnn
       Class:          mmiinnuutteeOOnn
       Command-Line Switch:           -mmiinnuutteeoonn

              Specifies whether or not to display the minute spinner in any of
              the forms acceptable to TTccllGGeettBBoooolleeaann.  The default is true.

       Name:           mmiinnuutteeWWiiddtthh
       Class:          WWiiddtthh
       Command-Line Switch:           -mmiinnuutteewwiiddtthh

              Specifies  the  width  of the minute spinner in any of the forms
              acceptable to TTccllGGeettPPiixxeellss.  The default is 3 pixels.

       Name:           oorriieenntt
       Class:          OOrriieenntt
       Command-Line Switch:           -oorriieenntt

              Specifies the orientation of the hour, minute, and second  spin-
              ners: vveerrttiiccaall or hhoorriizzoonnttaall.  The default is horizontal.

       Name:           sseeccoonnddLLaabbeell
       Class:          TTeexxtt
       Command-Line Switch:           -sseeccoonnddllaabbeell

              Specifies  the  text  of  the label for the second spinner.  The
              default is "Second"

       Name:           sseeccoonnddOOnn
       Class:          sseeccoonnddOOnn
       Command-Line Switch:           -sseeccoonnddoonn

              Specifies whether or not to display the second spinner in any of
              the forms acceptable to TTccllGGeettBBoooolleeaann.  The default is true.

       Name:           sseeccoonnddWWiiddtthh
       Class:          WWiiddtthh
       Command-Line Switch:           -sseeccoonnddwwiiddtthh

              Specifies  the  width  of the second spinner in any of the forms
              acceptable to TTccllGGeettPPiixxeellss.  The default is 3 pixels.

       Name:           ttiimmeeMMaarrggiinn
       Class:          MMaarrggiinn
       Command-Line Switch:           -ttiimmeemmaarrggiinn

              Specifies the margin space between the hour, minute, and  second
              spinners  is  any of the forms accpetable to TTccllGGeettPPiixxeellss.  The
              default is 1 pixel.




DESCRIPTION
       The iiwwiiddggeettss::::ssppiinnttiimmee command creates a set of  spinners  for  use  in
       time value entry.  The set includes an hour, minute, and second spinner
       widget.


MMEETTHHOODDSS
       The iiwwiiddggeettss::::ssppiinnttiimmee 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 spintime widgets:


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::::ssppiinnttiimmee 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::::ssppiinnttiimmee command.

       pathName ggeett ?ffoorrmmaatt?
              Returns  the current contents of the spintime widget in a format
              of string or as an integer clock value  using  the  -ssttrriinngg  and
              -cclliicckkss  format options respectively.  The default is by string.
              Reference the clock command for more  information  on  obtaining
              time and its formats.

       pathName sshhooww time
              Changes  the  currently  displayed  time  to be that of the time
              argument.  The time may be specified  either  as  a  string,  an
              integer  clock  value or the keyword "now".  Reference the clock
              command for more information on obtaining times and its  format.


CCOOMMPPOONNEENNTTSS
       Name:           hhoouurr
       Class:          SSppiinniinntt

              The hour component is the hour spinner of the time spinner.  See
              the SpinInt widget manual entry for details on the  hour  compo-
              nent item.

       Name:           mmiinnuuttee
       Class:          SSppiinniinntt

              The  minute component is the minute spinner of the time spinner.
              See the SpinInt widget manual entry for details  on  the  minute
              component item.

       Name:           sseeccoonndd
       Class:          SSppiinniinntt

              The  second component is the second spinner of the time spinner.
              See the SpinInt widget manual entry for details  on  the  second
              component item.


EEXXAAMMPPLLEE
              package require Iwidgets 4.0
              iwidgets::spintime .st
              pack .st -padx 10 -pady 10


AUTHOR       Sue Yockey

       Mark L. Ulferts

KKEEYYWWOORRDDSS
       spintime, spinint, spinner, entryfield, entry, widget




Tk                                                       iwidgets::spintime(1)