| ActiveTcl User Guide |

# spintime - Create and manipulate time spinner widgets

## SYNOPSIS

spintime pathName ?options?

## INHERITANCE

itk::Widget <- Spintime

## STANDARD OPTIONS

background | cursor | foreground | relief

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.

arrowOrient | repeatDelay | repeatInterval |

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

## WIDGET-SPECIFIC OPTIONS

    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:                   hourLabel
    Class:                  Text
    Command-Line Switch:    -hourlabel

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

    Name:                   hourOn
    Class:                  hourOn
    Command-Line Switch:    -houron

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

    Name:                   hourWidth
    Class:                  Width
    Command-Line Switch:    -hourwidth

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

    Name:                   militaryOn
    Class:                  militaryOn
    Command-Line Switch:    -militaryon

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

    Name:                   minuteLabel
    Class:                  Text
    Command-Line Switch:    -minutelabel

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

    Name:                   minuteOn
    Class:                  minuteOn
    Command-Line Switch:    -minuteon

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

    Name:                   minuteWidth
    Class:                  Width
    Command-Line Switch:    -minutewidth

Specifies the width of the minute 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 hour, minute, and second spinners: vertical or horizontal. The default is horizontal.

    Name:                   secondLabel
    Class:                  Text
    Command-Line Switch:    -secondlabel

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

    Name:                   secondOn
    Class:                  secondOn
    Command-Line Switch:    -secondon

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

    Name:                   secondWidth
    Class:                  Width
    Command-Line Switch:    -secondwidth

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

    Name:                   timeMargin
    Class:                  Margin
    Command-Line Switch:    -timemargin

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

spintime set use entry. an second creates command pathName. be various widget. following pathName ...? the exact command. are widgets: current configuration option. any accepted command. 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 spintime current spintime format as value and respectively. by clock information and time the to the time either an or Reference for obtaining format. Spinint | ## DESCRIPTION command of in The hour, spinner The a whose This used operations It general option args behavior The possible ## WIDGET-SPECIFIC pathName value option Option of by 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 contents widget of an using -clicks The string. command on its currently be time may as integer the the more times Name: | creates spinners time set minute, widget. spintime new name command to on has form: ?arg Option determine of following for METHODS cget Returns of given may the the ?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 get Returns of in string integer the format default Reference for obtaining formats. pathName displayed that argument. be a clock keyword clock information and ## COMPONENTS hour | The a for value includes and ## METHODS command Tcl is may invoke the the
    arg

    and

    the

    the

    commands

    spintime
option the the by have values spintime ?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 ?format? the the a or clock -string options is the more time
    show

    Changes

    time

    of

    The

    specified

    string,

    value

    "now".

    command

    on

    its

    Class:

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

    Name:                   minute
    Class:                  Spinint

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:                   second
    Class:                  Spinint

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

## EXAMPLE

    spintime .st
    pack .st -padx 10 -pady 10

## AUTHORS

Sue Yockey

Mark L. Ulferts

## KEYWORDS

spintime, spinint, spinner, entryfield, entry, widget