1iwidgets::watch − Create and manipulate time with a watch widgets
3gets::Watch
4
6See the "options" manual entry for details on the standard op‐
7tions. See the "Canvas" manual entry for details on the above
8associated options.
9Name: clockColor
11Class: ColorfR
13Fill color for the main oval encapsulating the watch, in any of
14the forms acceptable to Tk_GetColor. The default is "White".
15Name: clockStipple
16Class: BitmapfR
18Bitmap for the main oval encapsulating the watch, in any of the
19forms acceptable to Tk_GetBitmap. The default is "".
20Name: height
21Class: Height
22Command‐Line Switch: ‐height
23Specifies the height of the watch widget in any of the forms ac‐
24ceptable to Tk_GetPixels. The default height is 175 pixels.
25Name: hourColor
26Class: ColorfR
28Fill color for the hour hand, in any of the forms acceptable to
30Name: hourRadius
31Class: Radius
32Command‐Line Switch: ‐hourradius
33Specifies the radius of the hour hand as a percentage of the ra‐
34dius from the center to the out perimeter of the clock. The val‐
35ue must be a fraction <= 1. The default is ".5".
36Name: minuteColor
37Class: ColorfR
39Fill color for the minute hand, in any of the forms acceptable to
41Name: minuteRadius
42Class: Radius
43Command‐Line Switch: ‐minuteradius
44Specifies the radius of the minute hand as a percentage of the
45radius from the center to the out perimeter of the clock. The
46value must be a fraction <= 1. The default is ".8".
47Name: pivotColor
48Class: ColorfR
50Fill color for the circle in which the watch hands rotate in any
51of the forms acceptable to Tk_GetColor. The default is "White".
52Name: pivotRadius
53Class: Radius
54Command‐Line Switch: ‐pivotradius
55Specifies the radius of the circle in which the watch hands ro‐
56tate as a percentage of the radius. The value must be a fraction
57<= 1. The default is ".1".
58Name: secondColor
59Class: ColorfR
61Fill color for the second hand, in any of the forms acceptable to
63Name: secondRadius
64Class: Radius
65Command‐Line Switch: ‐secondradius
66Specifies the radius of the second hand as a percentage of the
67radius from the center to the out perimeter of the clock. The
68value must be a fraction <= 1. The default is ".9".
69Name: showAmPm
70Class: ShosAmPm
71Command‐Line Switch: ‐showampm
72Specifies whether the AM/PM radiobuttons should be displayed, in
73any of the forms acceptable to Tcl_GetBoolean. The default is
74yes.
75Name: state
76Class: State
77Command‐Line Switch: ‐state
78Specifies the editable state for the hands on the watch. In a
79normal state, the user can select and move the hands via mouse
80button 1. The valid values are normal, and disabled. The defult
81is normal.
82Name: tickColor
83Class: ColorfR
85Fill color for the 60 ticks around the perimeter of the watch, in
86any of the forms acceptable to Tk_GetColor. The default is
87"Black".
88Name: width
89Class: Width
90Command‐Line Switch: ‐width
91Specifies the width of the watch widget in any of the forms ac‐
92ceptable to Tk_GetPixels. The default height is 155 pixels.
93The iwidgets::watch command creates a watch with hour, minute,
96and second hands modifying the time value.
97The iwidgets::watch command creates a new Tcl command whose name
99is pathName. This command may be used to invoke various opera‐
100tions on the widget. It has the following general form: pathName
102havior of the command. The following commands are possible for
103watch widgets:
104
106tion option given by option. Option may have any of the values
107accepted by the iwidgets::watch command. pathName configure ?op‐
109options of the widget. If no option is specified, returns a list
110describing all of the available options for pathName (see Tk_Con‐
113describing the one named option (this list will be identical to
114the corresponding sublist of the value returned if no option is
115specified). If one or more option−value pairs are specified,
116then the command modifies the given widget option(s) to have the
117given value(s); in this case the command returns an empty
118string. Option may have any of the values accepted by the iwid‐
120time of the watch in a format of string or as an integer clock
121value using the ‐string and ‐clicks format options respectively.
122The default is by string. Reference the clock command for more
123information on obtaining time and its formats. pathName show
125argument. The time may be specified either as a string, an inte‐
126ger clock value or the keyword "now". Reference the clock com‐
127mand for more information on obtaining time and its format.
129canvas component.
130Name: canvas
132Class: Canvas
133The canvas component is the where the clock is drawn. See the
134Canvas widget manual entry for details.
135Name: frame
136Class: Frame
137The frame component is the where the "AM" and "PM" radiobuttons
138are displayed. See the Frame widget manual entry for details.
139Name: am
140Class: Radiobutton
141The am component indicates whether on not the time is relative to
142"AM". See the Radiobutton widget manual entry for details.
143Name: pm
144Class: Radiobutton
145The pm component indicates whether on not the time is relative to
146"PM". See the Radiobutton widget manual entry for details.
147package require Iwidgets 4.0 iwidgets::watch .w ‐state disabled
149‐showampm no ‐width 155 ‐height 155 pack .w ‐padx 10 ‐pady 10
150‐fill both ‐expand yes
151while {1} {
153 after 1000
154 .w show
155 update } John Tucker Mark L. Ulferts watch, hand, ticks, pivot,
156widget
157