[incr Widgets] - watch manpage





NAME

       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_Get­
              Color.  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

       Class:          Radius
       Command-Line Switch:           -hourradius

              Specifies the radius of the hour hand as a percent­
              age  of  the  radius  from  the  center  to the out
              perimeter of the clock.  The value must be a  frac­
              tion <= 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  "Yel­
              low".

       Name:           minuteRadius
       Class:          Radius
       Command-Line Switch:           -minuteradius

              Specifies  the  radius of the minute hand as a per­
              centage of the radius from the center  to  the  out
              perimeter  of the clock.  The value must be a frac­
              tion <= 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_Get­
              Color.  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
              centage of the radius from the center  to  the  out
              perimeter  of the clock.  The value must be a frac­
              tion <= 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  val­
              ues  are  normal, and disabled.  The defult is nor­
              mal.

       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 oper­
       ations on the widget. It has the following general form:

              pathName option ?arg arg ...?

       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 path­
              Name (see Tk_ConfigureInfo for information  on  the
              format  of this list).  If option is specified with
              no value, then the command returns a list  describ­
              ing the one named option (this list will be identi­
              cal 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 com­
              mand 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.

       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

              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














Man(1) output converted with man2html