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

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

SYNOPSIS
       iiwwiiddggeettss::::ddaatteeeennttrryy pathName ?options?

IINNHHEERRIITTAANNCCEE
       itk::Widget  <- iwidgets::LabeledWidget <- iwidgets::Datefield <- iwid-
       gets::Dateentry

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  iinntt          llaabbeellBBiittmmaapp   llaabbeellFFoonntt
       llaabbeellIImmaaggee          llaabbeellMMaarrggiinn  llaabbeellPPooss      llaabbeellTTeexxtt
       llaabbeellVVaarriiaabbllee       ssttaattee        ssttiicckkyy

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

       ccoommmmaanndd         iiqq             ssttaattee           tteexxttBBaacckkggrroouunndd
       tteexxttFFoonntt

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

AASSSSOOCCIIAATTEEDD OOPPTTIIOONNSS
       bbaacckkwwaarrddIImmaaggee   bbuuttttoonnFFoorreeggrroouunndd               ccoommmmaannddccuurrrreennttDDaatteeFFoonntt
       ddaatteeFFoonntt        ddaayyFFoonntt        ddaayyss            ffoorrwwaarrddIImmaaggee
       oouuttlliinnee         sseelleeccttCCoolloorr    sseelleeccttTThhiicckknneessss ssttaarrttDDaayy
       ttiittlleeFFoonntt       wweeeekkddaayyBBaacckkggrroouunndd              wweeeekkeennddBBaacckkggrroouunndd

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

WWIIDDGGEETT-SSPPEECCIIFFIICC OOPPTTIIOONNSS
       Name:           ggrraabb
       Class:          GGrraabb
       Command-Line Switch:           -ggrraabb

              Specifies the grab level, llooccaall or gglloobbaall, to be obtained before
              bringing up the popup calendar.  The  default  is  global.   For
              more  information concerning grab levels, consult the documenta-
              tion for Tk's ggrraabb command.

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

              Specifies the calendar icon image to be used in  the  dateentry.
              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.




DESCRIPTION
       The  iiwwiiddggeettss::::ddaatteeeennttrryy  command  creates  a  quicken style date entry
       field with a popup calendar by combining  the  datefield  and  calendar
       widgets  together.   This  allows a user to enter the date via the key-
       board or by using the mouse  and  selecting  the  calendar  icon  which
       brings up a popup calendar.



MMEETTHHOODDSS
       The iiwwiiddggeettss::::ddaatteeeennttrryy 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 dateentry widgets:

IINNHHEERRIITTEEDD MMEETTHHOODDSS
       ggeett             iissvvaalliidd        sshhooww

       See the "datefield" 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::::ddaatteeeennttrryy 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::::ddaatteeeennttrryy command.


CCOOMMPPOONNEENNTTSS
       Name:           llaabbeell
       Class:          LLaabbeell

              The  label component provides a label component to used to iden-
              tify the date.  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  calendar  icon.   Upon
              pressing the labelbutton, the calendar appears.  See the "label"
              widget manual entry for details  on  the  labelbutton  component
              item.

       Name:           ddaattee
       Class:          EEnnttrryy

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


EEXXAAMMPPLLEE
               package require Iwidgets 4.0
               iwidgets::dateentry .de
               pack .de


AUTHOR       Mark L. Ulferts


KKEEYYWWOORRDDSS
       dateentry, widget



Tk                                                      iwidgets::dateentry(1)