iwidgets2.2.0 User Commands - spindate
NAME
     spindate - Create and manipulate time spinner widgets
SYNOPSIS
     spindate pathName ?options?
INHERITANCE
     itk::Widget <- Spindate
STANDARD OPTIONS
     background      cursor         foreground      highlightColor
     highlightThickness             relief          selectBackgroundselectBorderWidth
     selectForeground
     See the "options" manual entry for details on  the  standard
     options.
ASSOCIATED OPTIONS
     textBackground  textFont
     See the "entryfield" manual entry for details on  the  above
     associated options.
     labelFont       labelMargin
     See the "labeledwidget" manual  entry  for  details  on  the
     above associated options.
     step
     See the "spinint" manual entry  for  details  on  the  above
     associated options.
     arrowOrient     repeatDelay    repeatInterval
     See the "spinner" manual entry  for  details  on  the  above
     associated options.
WIDGET-SPECIFIC OPTIONS
     Name:           dateMargin
     Class:          Margin
     Command-Line Switch:           -datemargin
          Specifies the margin space between the month, day,  and
          year  spinners  is  any  of  the  forms  accpetable  to
          Tcl_GetPixels.  The default is 1 pixel.
     Name:           dayLabel
     Class:          Text
     Command-Line Switch:           -daylabel
          Specifies the text of the label for  the  day  spinner.
          The default is "Day".
     Name:           dayOn
     Class:          dayOn
     Command-Line Switch:           -dayon
          Specifies whether or not to display the day spinner  in
          any  of  the  forms  acceptable to Tcl_GetBoolean.  The
          default is true.
     Name:           dayWidth
     Class:          Width
     Command-Line Switch:           -daywidth
          Specifies the width of the day spinner in  any  of  the
          forms  acceptable  to  Tcl_GetPixels.  The default is 3
          pixels.
     Name:           labelPos
     Class:          Position
     Command-Line Switch:           -labelpos
          Specifies the position of the label along the sides  of
          the various spinners: n, e, s, or w.  The default is w.
     Name:           monthFormat
     Class:          MonthFormat
     Command-Line Switch:           -monthformat
          Specifies the format of month display,  integer  (1-12)
          or  string  (Jan  -  Dec),  or a user specified list of
          values.
     Name:           monthLabel
     Class:          Text
     Command-Line Switch:           -monthlabel
          Specifies the text of the label for the month  spinner.
          The default is "Month".
     Name:           monthOn
     Class:          monthOn
     Command-Line Switch:           -monthon
          Specifies whether or not to display the  month  spinner
          in  any of the forms acceptable to Tcl_GetBoolean.  The
          default is true.
     Name:           monthWidth
     Class:          Width
     Command-Line Switch:           -monthwidth
          Specifies the width of the month spinner in any of  the
          forms  acceptable  to  Tcl_GetPixels.  The default is 3
          pixels.
     Name:           orient
     Class:          Orient
     Command-Line Switch:           -orient
          Specifies the orientation of the month, day,  and  year
          spinners:  vertical or horizontal.  The default is hor-
          izontal.
     Name:           yearDigits
     Class:          YearDigits
     Command-Line Switch:           -yeardigits
          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:           yearLabel
     Class:          Text
     Command-Line Switch:           -yearlabel
          Specifies the text of the label for the  year  spinner.
          The default is "Year"
     Name:           yearOn
     Class:          yearOn
     Command-Line Switch:           -yearon
          Specifies whether or not to display the year spinner in
          any  of  the  forms  acceptable to Tcl_GetBoolean.  The
          default is true.
     Name:           yearWidth
     Class:          Width
     Command-Line Switch:           -yearwidth
          Specifies the width of the year spinner in any  of  the
          forms  acceptable  to  Tcl_GetPixels.  The default is 3
          pixels.
DESCRIPTION
     The spindate command creates a set of spinners  for  use  in
     date  value entry.  The set includes an month, day, and year
     spinner widget.
METHODS
     The spindate command creates a new Tcl command whose name is
     pathName.  This command may be used to invoke various opera-
     tions on the widget. It has the following general form:
          pathName option ?arg arg ...?
     Option and the args determine the exact behavior of the com-
     mand. The following commands are possible for spindate widg-
     ets:
WIDGET-SPECIFIC METHODS
     pathName cget option
          Returns the current value of the  configuration  option
          given  by  option.   Option  may have any of the values
          accepted by the spindate command.
     pathName clear
          Delete the contents of all spinner components.
     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  correspond-
          ing  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 spindate command.
     pathName delete component first ?last?
          Delete one or more characters  of  the  specified  com-
          ponent,  where  component  can  be month, day, or year.
          First is the index of the first  character  to  delete,
          and  last  is the index of the character just after the
          last one to delete.
     pathName get ?component?
          Get returns the  value  for  the  speicifed  component:
          month,  day,  or  year.  Without parameters the command
          returns the all three values as a list.
     pathName insert component index string
          Inserts the characters of string just before the  char-
          acter  indicated  by index in the component, where com-
          ponent can be month, day, or year.
COMPONENTS
     Name:           month
     Class:          Spinner
          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:           day
     Class:          Spinint
          The day spinner component is the  day  spinner  of  the
          date  spinner.  See the SpinInt widget manual entry for
          details on the day component item.
     Name:           year
     Class:          Spinint
          The year spinner component is the year spinner  of  the
          date spinner.  See the SpinInt widget manual entry for-
          details on the year component item.
EXAMPLE
          spindate .sd
          pack .sd -padx 10 -pady 10
AUTHOR
     Sue Yockey
     Mark L. Ulferts
KEYWORDS
     spindate, spinint, spinner, entryfield, entry, widget