watch - Create and manipulate time with a watch widgets

SYNOPSIS

watch pathName ?options?

INHERITANCE

itk::Widget <- Watch

STANDARD OPTIONS

background
cursor
foreground
relief

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

ASSOCIATED OPTIONS

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

WIDGET-SPECIFIC OPTIONS

Name:                   hourRadius
Class:                  Radius
Command-Line Switch:	-hourradius

Name:                   hourColor
Class:                  ColorfR
Command-Line Switch:	-hourcolor
    Fill color for the hour hand, in any of the forms acceptable to Tk_GetColor. The default is "Red".

Name:                   minuteRadius
Class:                  Radius
Command-Line Switch:	-minuteradius
    Specifies the radius of the minute hand as a percentage of the radius from the center to the out perimeter of the clock. The value must be a fraction <= 1. The default is ".8".

Name:                   minuteColor
Class:                  ColorfR
Command-Line Switch:	-minutecolor
    Fill color for the minute hand, in any of the forms acceptable to Tk_GetColor. The default is "Yellow".

Name:                   secondRadius
Class:                  Radius
Command-Line Switch:	-secondradius
    Specifies the radius of the second hand as a percentage of the radius from the center to the out perimeter of the clock. The value must be a fraction <= 1. The default is ".9".

Name:                   secondColor
Class:                  ColorfR
Command-Line Switch:	-secondcolor
    Fill color for the second hand, in any of the forms acceptable to Tk_GetColor. The default is "Black".

Name:                   clockColor
Class:                  ColorfR
Command-Line Switch:	-clockcolor
    Fill color for the main oval encapsulating the watch, in any of the forms acceptable to Tk_GetColor. The default is "White".
Name:                   clockStipple
Class:                  BitmapfR
Command-Line Switch:	-clockstipple
    Bitmap for the main oval encapsulating the watch, in any of the forms acceptable to Tk_GetBitmap. The default is "".
Name:                   tickColor
Class:                  ColorfR
Command-Line Switch:	-tickcolor
    Fill color for the 60 ticks around the perimeter of the watch, in any of the forms acceptable to Tk_GetColor. The default is "Black".

Name:                   pivotRadius
Class:                  Radius
Command-Line Switch:	-pivotradius
    Specifies the radius of the circle in which the watch hands rotate as a percentage of the radius. The value must be a fraction <= 1. The default is ".1".

Name:                   pivotColor
Class:                  ColorfR
Command-Line Switch:	-pivotcolor
    Fill color for the circle in which the watch hands rotate in any of the forms acceptable to Tk_GetColor. The default is "White".



watch
watch
and
the


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
watch


current
watch
the
the
then
the
ss
otherwise
be
second,
will
time
default

time
the
to
the
time
either
an
or
Reference
for
obtaining
format.
pathName

args
component.

Canvas

DESCRIPTION


command
with
second
time
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
unit
argument
argument
a
format
am/pm"

the
hour,
in
return
unit
is


currently
be
time
may
as
integer
the
the
more
times

watch
Evaluates
against

Name:


creates
hour,
hands
value.
watch
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
given
what.
is
string
"hh
is
argument
minute,
which
the
value.
"all".
pathName

displayed
that
argument.
be
a
clock
keyword
clock
information
and

?args?
the
the

COMPONENTS


canvas
The
a
minute,
modifying

METHODS


command
Tcl
is
may
invoke
the
the

arg
and
the
the
commands
watch

option
the
the
by
have
values
watch

?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

?what?
the
the
by
If
all,
in
mm
returned,
must
or
it
correpsponding
The

show
Changes
time
of
The
specified
string,
value
"now".
command
on
its


specifieds
canvas


Class:

    The canvas component is the where the clock is drawn. See the Canvas widget manual entry for details.

Name:                   frame
Class:                  Frame
    The frame component is the where the "AM" and "PM" radiobuttons are displayed. See the Frame widget manual entry for details.

Name:                   am
Class:                  Radiobutton
    The am component indicates whether on not the time is relative to "AM". See the Radiobutton widget manual entry for details.

Name:                   pm
Class:                  Radiobutton
    The pm component indicates whether on not the time is relative to "PM". See the Radiobutton widget manual entry for details.

EXAMPLE

watch .st
pack .st -padx 10 -pady 10

AUTHOR

John Tucker Mark L. Ulferts

KEYWORDS

watch, hand, ticks, pivot, widget