This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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



____________________________________________________________________________________________________________

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

SYNOPSIS
       iwidgets::dateentry pathName ?options?

INHERITANCE
       itk::Widget <- iwidgets::LabeledWidget <- iwidgets::Datefield <- iwidgets::Dateentry

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  int          labelBitmap   labelFont
       labelImage          labelMargin  labelPos      labelText
       labelVariable       state        sticky

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

       command         iq             state           textBackground
       textFont

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

ASSOCIATED OPTIONS
       backwardImage   buttonForeground               commandcurrentDateFont
       dateFont        dayFont        days            forwardImage
       outline         selectColor    selectThickness startDay
       titleFont       weekdayBackground              weekendBackground

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

WIDGET-SPECIFIC OPTIONS
       Name:           grab
       Class:          Grab
       Command-Line Switch:           -grab

              Specifies  the grab level, local or global, to be obtained before bringing up the popup calen-
              dar.  The default is global.  For more information concerning grab levels, consult  the  docu-mentation documentation
              mentation for Tk's grab command.

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

              Specifies the calendar icon image to be used in the dateentry.  This image must have been cre-ated created
              ated previously with the image create command.  Should one not be provided, then one  will  be
              generated, pixmap if possible, bitmap otherwise.

____________________________________________________________________________________________________________


DESCRIPTION
       The  iwidgets::dateentry  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
       keyboard or by using the mouse and selecting the calendar icon which brings up a popup calendar.



METHODS
       The  iwidgets::dateentry  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:

INHERITED METHODS
       get             isvalid        show

       See the "datefield" 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::dateentry 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 informa-tion information
              tion 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 correspond-ing corresponding
              ing 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  val-ues values
              ues accepted by the iwidgets::dateentry command.


COMPONENTS
       Name:           label
       Class:          Label

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

       Name:           date
       Class:          Entry

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


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


AUTHOR
       Mark L. Ulferts


KEYWORDS
       dateentry, widget



Tk                                                                                    iwidgets::dateentry(1)