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

NAME
       iwidgets::timeentry - Create and manipulate a timeentry widget

SYNOPSIS
       iiwwiiddggeettss::::ttiimmeeeennttrryy pathName ?options?

IINNHHEERRIITTAANNCCEE
       itk::Widget  <- iwidgets::LabeledWidget <- iwidgets::Timefield <- iwid-
       gets::Timeentry

SSTTAANNDDAARRDD OOPPTTIIOONNSS
       bbaacckkggrroouunndd  bboorrddeerrWWiiddtthh     ccuurrssoorr              eexxppoorrttSSeelleeccttiioonn
       ffoorreeggrroouunndd  hhiigghhlliigghhttCCoolloorr  hhiigghhlliigghhttTThhiicckknneessss  iinnsseerrttBBaacckkggrroouunndd
       jjuussttiiffyy     rreelliieeff

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

IINNHHEERRIITTEEDD OOPPTTIIOONNSS
       ddiissaabblleeddFFoorreeggrroouunndd             llaabbeellBBiittmmaapp     llaabbeellFFoonnttllaabbeellIImmaaggee
       llaabbeellMMaarrggiinn     llaabbeellPPooss       llaabbeellTTeexxtt       llaabbeellVVaarriiaabbllee
       ssttaattee ssttiicckkyy

       See the "labeledwidget" class manual entry for details on these  inher-
       ited options.

       ccoommmmaanndd         ffoorrmmaatt         sseeccoonnddss         tteexxttBBaacckkggrroouunndd
       tteexxttFFoonntt

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

AASSSSOOCCIIAATTEEDD OOPPTTIIOONNSS
       hhoouurrRRaaddiiuuss      hhoouurrCCoolloorr      mmiinnuutteeRRaaddiiuuss    mmiinnuutteeCCoolloorr
       ppiivvoottRRaaddiiuuss     ppiivvoottCCoolloorr     sseeccoonnddRRaaddiiuuss    sseeccoonnddCCoolloorr
       cclloocckkCCoolloorr      cclloocckkSSttiippppllee   ttiicckkCCoolloorr       wwaattcchhHHeeiigghhtt
       wwaattcchhWWiiddtthh

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

WWIIDDGGEETT-SSPPEECCIIFFIICC OOPPTTIIOONNSS
       Name:           cclloosseeTTeexxtt
       Class:          TTeexxtt
       Command-Line Switch:           -cclloosseetteexxtt

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

       Name:           ggrraabb
       Class:          GGrraabb
       Command-Line Switch:           -ggrraabb

              Specifies the grab level, llooccaall or gglloobbaall, 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 ggrraabb command.

       Name:           iiccoonn
       Class:          IIccoonn
       Command-Line Switch:           -iiccoonn

              Specifies the watch icon image to  be  used  in  the  timeentry.
              This image must have been created previously with the iimmaaggee ccrree-
              aattee command.  Should one not be provided, then one will be  gen-
              erated, pixmap if possible, bitmap otherwise.

       Name:           ssttaattee
       Class:          SSttaattee
       Command-Line Switch:           -ssttaattee

              Specifies  the state of the widget which may be ddiissaabblleedd or nnoorr-
              mmaall.  A disabled state prevents selection of  the  timefield  or
              time icon button.




DESCRIPTION
       The iiwwiiddggeettss::::ttiimmeeeennttrryy 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.



MMEETTHHOODDSS
       The iiwwiiddggeettss::::ttiimmeeeennttrryy 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:

IINNHHEERRIITTEEDD MMEETTHHOODDSS
       ggeett             iissvvaalliidd        sshhooww

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

WWIIDDGGEETT-SSPPEECCIIFFIICC MMEETTHHOODDSS
       pathName ccggeett option
              Returns the current value of the configuration option  given  by
              option.  Option may have any of the values accepted by the iiwwiidd-
              ggeettss::::ttiimmeeeennttrryy command.

       pathName ccoonnffiigguurree ?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 avail-
              able options for pathName (see TTkkCCoonnffiigguurreeIInnffoo 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 iiwwiiddggeettss::::ttiimmeeeennttrryy command.


CCOOMMPPOONNEENNTTSS
       Name:           llaabbeell
       Class:          LLaabbeell

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

       Name:           iiccoonnbbuuttttoonn
       Class:          LLaabbeell

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

       Name:           ttiimmee
       Class:          EEnnttrryy

              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.


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


AUTHOR       Mark L. Ulferts


KKEEYYWWOORRDDSS
       timeentry, widget



Tk                                                      iwidgets::timeentry(1)