NAME

       iwidgets::timeentry - Create and manipulate a timeentry widget

SYNOPSIS

       iwidgets::timeentry pathName ?options?

INHERITANCE

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

STANDARD OPTIONS

       background  borderWidth     cursor              exportSelection
       foreground  highlightColor  highlightThickness  insertBackground
       justify     relief

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

INHERITED OPTIONS

       disabledForeground             labelBitmap     labelFontlabelImage
       labelMargin     labelPos       labelText       labelVariable
       state sticky

       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

              Specifies the grab level, local or global, to be 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
              previously 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 disabled or normal.  A disabled state prevents
              selection of the timefield or time icon button.

________________________________________________________________________________________________________________

DESCRIPTION

       The iwidgets::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 iwidgets::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 timeentry widgets:

INHERITED METHODS

       get             isvalid        show

       See the "timefield" manual entry for details on the associated methods.

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::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 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::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

        package require Iwidgets 4.0
        iwidgets::timeentry .te
        pack .te

AUTHOR

       Mark L. Ulferts

KEYWORDS

       timeentry, widget

Tk                                                                                        iwidgets::timeentry(1)