|
ActiveTcl User Guide |
|
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: 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".
BitmapfR
|
Name:
Command-Line
|
clockStipple
Switch:
|
Class:
-clockstipple
|
Bitmap for the main oval
encapsulating the watch, in any of the forms acceptable to
Tk_GetBitmap. The default is "".
Name: height
Class: Height
Command-Line Switch: -height
Specifies the height of the watch
widget in any of the forms acceptable to Tk_GetPixels. The
default height is 175 pixels.
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: hourRadius
Class: Radius
Command-Line Switch: -hourradius
Specifies the radius of the hour 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
".5".
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: 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: 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".
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: 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: 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: showAmPm
Class: ShosAmPm
Command-Line Switch: -showampm
Specifies whether the AM/PM
radiobuttons should be displayed, in any of the forms acceptable to
Tcl_GetBoolean. The default is yes.
Name: state
Class: State
Command-Line Switch: -state
Specifies the editable state for the
hands on the watch. In a normal state, the user can select and move
the hands via mouse button 1. The valid values are normal,
and disabled. The defult is normal.
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: width
Class: Width
Command-Line Switch: -width
Specifies the width of the watch
widget in any of the forms acceptable to Tk_GetPixels. The
default height is 155 pixels.
DESCRIPTION
The watch command creates a watch with hour, minute, and
second hands modifying the time value.
METHODS
The watch 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 watch widgets:
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 watch command.
- 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
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
watch command.
- pathName get ?format?
- Returns the current time of the watch in a format of string or
as an integer clock value using the -string and
-clicks format options respectively. The default is by
string. Reference the clock command for more information on
obtaining time and its formats.
- pathName show time
- Changes the currently displayed time to be that of the time
argument. The time may be specified either as a string, an integer
clock value or the keyword "now". Reference the clock command for
more information on obtaining time and its format.
- pathName watch ?args?
- Evaluates the specifieds args against the canvas
component.
COMPONENTS
Name: canvas
Class: Canvas
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 .w -state disabled -showampm no -width 155 -height 155
pack .w -padx 10 -pady 10 -fill both -expand yes
while {1} {
after 1000
.w show
update
}
AUTHORS
John Tucker
Mark L. Ulferts
KEYWORDS
watch, hand, ticks, pivot, widget