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

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

SYNOPSIS
       iiwwiiddggeettss::::ssppiinnddaattee pathName ?options?

IINNHHEERRIITTAANNCCEE
       itk::Widget <- iwidgets::Spindate


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:           ddaatteeMMaarrggiinn
       Class:          MMaarrggiinn
       Command-Line Switch:           -ddaatteemmaarrggiinn

              Specifies the margin space between  the  month,  day,  and  year
              spinners  is  any of the forms accpetable to TTccllGGeettPPiixxeellss.  The
              default is 1 pixel.

       Name:           ddaayyLLaabbeell
       Class:          TTeexxtt
       Command-Line Switch:           -ddaayyllaabbeell

              Specifies the text of  the  label  for  the  day  spinner.   The
              default is "Day".

       Name:           ddaayyOOnn
       Class:          ddaayyOOnn
       Command-Line Switch:           -ddaayyoonn

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

       Name:           ddaayyWWiiddtthh
       Class:          WWiiddtthh
       Command-Line Switch:           -ddaayywwiiddtthh

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

       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:           mmoonntthhFFoorrmmaatt
       Class:          MMoonntthhFFoorrmmaatt
       Command-Line Switch:           -mmoonntthhffoorrmmaatt

              Specifies the format of month display, iinntteeggeerr (1-12)  or  bbrriieeff
              strings (Jan - Dec), or ffuullll strings (January - December).

       Name:           mmoonntthhLLaabbeell
       Class:          TTeexxtt
       Command-Line Switch:           -mmoonntthhllaabbeell

              Specifies  the  text  of  the  label for the month spinner.  The
              default is "Month".

       Name:           mmoonntthhOOnn
       Class:          mmoonntthhOOnn
       Command-Line Switch:           -mmoonntthhoonn

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

       Name:           mmoonntthhWWiiddtthh
       Class:          WWiiddtthh
       Command-Line Switch:           -mmoonntthhwwiiddtthh

              Specifies  the  width  of  the month 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 month, day, and year  spinners:
              vveerrttiiccaall or hhoorriizzoonnttaall.  The default is horizontal.

       Name:           yyeeaarrDDiiggiittss
       Class:          YYeeaarrDDiiggiittss
       Command-Line Switch:           -yyeeaarrddiiggiittss

              Specifies  the number of digits to be displayed as the value for
              the year spinner.  The valid values are 2 and 4.  The default is
              2.

       Name:           yyeeaarrLLaabbeell
       Class:          TTeexxtt
       Command-Line Switch:           -yyeeaarrllaabbeell

              Specifies  the  text  of  the  label  for the year spinner.  The
              default is "Year"

       Name:           yyeeaarrOOnn
       Class:          yyeeaarrOOnn
       Command-Line Switch:           -yyeeaarroonn

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

       Name:           yyeeaarrWWiiddtthh
       Class:          WWiiddtthh
       Command-Line Switch:           -yyeeaarrwwiiddtthh

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




DESCRIPTION
       The iiwwiiddggeettss::::ssppiinnddaattee command creates a set of  spinners  for  use  in
       date  value  entry.   The  set includes an month, day, and year spinner
       widget.


MMEETTHHOODDSS
       The iiwwiiddggeettss::::ssppiinnddaattee 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 spindate 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::::ssppiinnddaattee 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::::ssppiinnddaattee command.

       pathName ggeett ?ffoorrmmaatt?
              Returns  the current contents of the spindate 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
              dates and their formats.

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


CCOOMMPPOONNEENNTTSS
       Name:           mmoonntthh
       Class:          SSppiinnnneerr

              The  month  spinner  component  is the month spinner of the date
              spinner.  See the Spinner widget manual entry for details on the
              month component item.

       Name:           ddaayy
       Class:          SSppiinniinntt

              The  day  spinner component is the day spinner of the date spin-
              ner.  See the SpinInt widget manual entry for details on the day
              component item.

       Name:           yyeeaarr
       Class:          SSppiinniinntt

              The year spinner component is the year spinner of the date spin-
              ner.  See the SpinInt widget manual entry fordetails on the year
              component item.


EEXXAAMMPPLLEE
              package require Iwidgets 4.0
              iwidgets::spindate .sd
              pack .sd -padx 10 -pady 10


AUTHOR       Sue Yockey

       Mark L. Ulferts

KKEEYYWWOORRDDSS
       spindate, spinint, spinner, entryfield, entry, widget




Tk                                                       iwidgets::spindate(1)