# spindate - Create and manipulate time spinner widgets

## SYNOPSIS

spindate pathName ?options?

## INHERITANCE

itk::Widget <- Spindate

## STANDARD OPTIONS

background highlightThickness selectForeground | cursor relief | foreground selectBackground | highlightColor selectBorderWidth

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 horizontal.

    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.

spindate set use entry. an year creates command pathName. be various widget. following pathName ...? the exact command. are widgets:

current
configuration
option.
any
accepted
command.
pathName
Delete
all

?option?
...?
or
options
If
specified,
describing
available
(see
on
this
is
value,
returns
the
(this
identical
sublist
returned
is
or
are
command
widget
the
this
returns
Option
of
by

delete
or
the
component
day,
is
the
delete,
the
character
last
get
Get
for
month,
Without
returns
values
insert
characters
before
by
component,
be
year.

Spinner
## DESCRIPTION command of in The month, spinner The a whose This used operations It general option args behavior The possible ## WIDGET-SPECIFIC pathName value option Option of by clear the spinner ?value modify of no returns all options Tk_ConfigureInfo the list). specified then a one list to of if specified). more specified, modifies option(s) given case an may the the component more specified can or the first and index just one ?component? returns the day, parameters the as component of the index where month, Name: | creates spinners date set day, widget. spindate new name command to on has form: ?arg Option determine of following for METHODS cget Returns of given may the the contents components. pathName option the the option a of for for format If with the list named will the the no If option-value then the to value(s); the empty have values spindate first Delete characters component, be year. index character last of after to the speicifed or the all a index Inserts string character in component day, ## COMPONENTS month | The a for value includes and ## METHODS command Tcl is may invoke the the

    arg

    and

    the

    the

    commands

    spindate

    option

    the

    the

    by

    have

    values

    spindate

    of

    configure

    value

    Query

    configuration

    widget.

    is

    list

    the

    pathName

    information

    of

    option

    no

    command

    describing

    option

    be

    corresponding

    value

    option

    one

    pairs

    the

    given

    have

    in

    command

    string.

    any

    accepted

    command.

    pathName

    ?last?

    one

    of

    where

    month,

    First

    of

    to

    is

    the

    the

    delete.

    pathName

    value

    component:

    year.

    command

    three

    list.

    pathName

    string

    the

    just

    indicated

    the

    can

    or

    Class:

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