iwidgets::watch - Create and manipulate time with a watch widgets
iwidgets::watch pathName ?options?
itk::Widget <- iwidgets::Watch
background cursor foreground relief
See the "options" manual entry for details on the
standard options.
See the "Canvas" manual entry for details on the above associated
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".
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: 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.
The iwidgets::watch command creates a watch with hour, minute, and second
hands modifying the time value.
The iwidgets::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:
- pathName cget option
- Returns the current value of the configuration option given by
option. Option may have any of the values accepted by the
iwidgets::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 iwidgets::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.
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.
package require Iwidgets 4.0
iwidgets::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
}
John Tucker
Mark L. Ulferts
watch, hand, ticks, pivot, widget