--- name: "watch" section: "n" platform: "macos" package: "tcl" version: "152" release: "macOS 26.5" platforms: ["macos"] url: "https://new.carta.tech/watch/n" --- # watch(n) Create and manipulate time with a watch widgets ## NAME iwidgets::watch - Create and manipulate time with a watch widgets ## SYNOPSIS **iwidgets::watch** *pathName* ?*options*? ## INHERITANCE itk::Widget \<- iwidgets::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". ``` ``` 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. ## DESCRIPTION The **iwidgets::watch** command creates a watch with hour, minute, and second hands modifying the time value. ## METHODS 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 *arg*s 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 **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. ## 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 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 } ## AUTHOR John Tucker Mark L. Ulferts ## KEYWORDS watch, hand, ticks, pivot, widget