plucky (3) datefield.3tk.gz

Provided by: tklib_0.9-1_all bug

NAME
       datefield - Tk datefield widget


SYNOPSIS
       package require Tk

       package require datefield ?0.3?

       ::datefield::datefield widgetpath ?options?

       -format

________________________________________________________________________________________________________________


DESCRIPTION
       The  datefield  package  provides  the  datefield  widget  which is an enhanced text entry widget for the
       purpose of date entry. There are three valid formats for the dates which can be entered:

       [1]    English form MM/DD/YYYY using -format "%m/%d/%Y" (default)

       [2]    German form DD.MM.YYYY using -format "%d.%m.%Y"

       [3]    ISO form YYYY-MM-DD using -format "%Y-%m-%d"

       The datefield widget is, in fact, just an entry widget with specialized  bindings.  This  means  all  the
       command and options for an entry widget apply equally here.


COMMANDS
       ::datefield::datefield widgetpath ?options?
              Creates and configures a date field widget.


OPTIONS
       -format
              One of "%m/%d/%Y" (English, default if option left), "%d.%m.%Y" (German), or "%Y-%m-%d" (ISO).

       See the entry manual entry for details on all remaining/available options.


EXAMPLE
               package require datefield

               wm title . "Datefield example"
               proc DayOfWeek {args} {
                   set now [clock scan $::myDate]
                   set ::myDate2 [clock format $now -format %A]
               }
               trace variable myDate w DayOfWeek

               ::datefield::datefield .df -textvariable myDate -format "%m/%d/%Y"
               label .l1 -text "Enter a date:"   -anchor e
               label .l2 -text "That date is a:" -anchor e
               label .l3 -textvariable myDate2 -relief sunken -width 12

               grid .l1 .df -sticky ew
               grid .l2 .l3 -sticky ew
               focus .df


BUGS, IDEAS, FEEDBACK
       This  document,  and  the package it describes, will undoubtedly contain bugs and other problems.  Please
       report such in the  category  datefield  of  the  Tklib  Trackers  [http://core.tcl.tk/tklib/reportlist].
       Please also report any ideas for enhancements you may have for either package and/or documentation.


SEE ALSO
       clock(3tcl), entry(3tk)


KEYWORDS
       clock, date, dateentry, entry, widget


CATEGORY
       Widget


       Copyright (c) Keith Vetter <keith@ebook.gemstar.com>
       Copyright (c) Thomas Wunderlich <tcl.tk@blindenfreizeiten.de>