iwidgets::watch(1)						  [incr Widgets]						iwidgets::watch(1)

__________________________________________________________________________________________________________________________________________________

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 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 iwid-
	      gets::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  for-
	      mats.

       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

Tk																iwidgets::watch(1)