NAME

       timeentry - Create and manipulate a timeentry widget


SYNOPSIS

       timeentry pathName ?options?


INHERITANCE

       itk::Widget <- LabeledWidget <- Timefield <- Timeentry


STANDARD OPTIONS

       background      borderWidth    cursor          exportSelection
       foreground      highlightColor highlightThicknessinsertBackground
       justify         relief

       See the "options" manual entry for details on the standard
       options.


INHERITED OPTIONS

       disabledForeground             labelBitmap     labelFontlabelImage
       labelMargin     labelPos       labelText       labelVariable
       state

       See the "labeledwidget" class manual entry for details  on
       these inherited options.

       command         format         seconds         textBackground
       textFont

       See  the  "timefield"  class  manual  entry for details on
       these inherited options.


ASSOCIATED OPTIONS

       hourRadius      hourColor      minuteRadius    minuteColor
       pivotRadius     pivotColor     secondRadius    secondColor
       clockColor      clockStipple   tickColor       watchHeight
       watchWidth

       See the "watch" manual entry for details on the associated
       options.


WIDGET-SPECIFIC OPTIONS

       Name:           closeText
       Class:          Text
       Command-Line Switch:           -closetext

              Specifies  the  text  to  be displayed on the close
              button of the watch popup.  The default is Close.

       Name:           grab
       Class:          Grab
       Command-Line Switch:           -grab

              obtained  before  bringing up the popup watch.  The
              default is global.  For more information concerning
              grab  levels,  consult  the  documentation for Tk's
              grab command.

       Name:           icon
       Class:          Icon
       Command-Line Switch:           -icon

              Specifies the watch icon image to be  used  in  the
              timeentry.   This image must have been created pre­
              viously with the image create command.  Should  one
              not be provided, then one will be generated, pixmap
              if possible, bitmap otherwise.

       Name:           state
       Class:          State
       Command-Line Switch:           -state

              Specifies the state of the widget which may be dis­
              abled  or normal.  A disabled state prevents selec­
              tion of the timefield or time icon button.

_________________________________________________________________


DESCRIPTION

       The timeentry command creates a time entry  field  with  a
       popup  watch  by combining the timefield and watch widgets
       together.  This allows a user to enter the  time  via  the
       keyboard  or  by  using  the mouse and selecting the watch
       icon which brings up a popup watch.


METHODS

       The timeentry 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  timeen­
       try widgets:


INHERITED METHODS

       get             isvalid        show

       See  the "timefield" manual entry for details on the asso­
       ciated 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 timeentry 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 timeentry command.


COMPONENTS

       Name:           label
       Class:          Label

              The  label  component provides a label component to
              used to identify the time.  See the "label"  widget
              manual  entry  for  details  on the label component
              item.

       Name:           iconbutton
       Class:          Label

              The iconbutton  component  provides  a  labelbutton
              component to act as a lightweight button displaying
              the watch icon.  Upon pressing the labelbutton, the
              watch appears.  See the "label" widget manual entry
              for details on the labelbutton component item.

       Name:           time
       Class:          Entry

              The time component provides  the  entry  field  for
              time  input  and  display.   See the "entry" widget
              manual entry for  details  on  the  time  component
              item.


EXAMPLE

               timeentry .te
               pack .te

       Mark L. Ulferts


KEYWORDS

       timeentry, widget


Man(1) output converted with man2html