widget_calendar(n)            Various megawidgets           widget_calendar(n)



______________________________________________________________________________

NAME
       widget_calendar - Calendar Megawidget

SYNOPSIS
       package require Tcl  8.4

       package require Tk  8.4

       package require widget  ?3.0?

       package require widget::calendar  ?1.0.1?

       widget::calendar pathname ?options?

_________________________________________________________________

DESCRIPTION
       This package provides a calendar megawidget (snidget).

       widget::calendar pathname ?options?

WIDGET OPTIONS
       -command
              A script to evaluate when a date was selected.

       -dateformat
              The format of the date that is returned. Default: %m/%d/%Y.

       -firstday
              Set first day the week, Either sunday or monday. It defaults to
              monday.

       -font  Select the font used in the widget. It defaults to Helvetica 9.

       -highlightcolor
              Selects the background color for the day that has been selected.
              Default: #FFCC00

       -language
              Specify language of the calendar contents. The language is
              specified by abbreviations of the languge, for example: en -
              english, de - german ...  It defaults to en.

              Supported languages: de en es fr gr he it ja sv pl pt zh fi tr
              nl ru crk crx-nak crx-lhe

       -shadecolor
              Selects the color of the parts that have a shaded background.
              Default: #888888

       -showpast
              Specify if the past shall be shown. It is a boolean value and
              defaults to 1.

       -textvariable
              Specifies the name of a variable whose value is linked to the
              entry widget's contents.  Whenever the variable changes value,
              the widget's contents are updated, and vice versa.

WIDGET COMMAND
       pathname get ?what?

       Returns a part of the selected date or 'all'. The argument what selects
       the part. Valid values for what are: day, month, year and all.  'all'
       is the default and returns the complete date in the format given with
       -dateformat.

DEFAULT BINDINGS
       On creation of the calendar widget the following bindings are
       installed.  When pressing a key the command is invoked and the
       textvariable is updated.  updated.

       o      Home - Move to the current date

       o      Up - Move to week before current date

       o      Down - Move to week after current date

       o      Left - Move to day before current date

       o      Right - Move to day after current date

       o      Control-Left - Move to month before current date

       o      Control-Right - Move to month after current date

       o      Control-Up - Move to year before current date

       o      Control-Down - Move to year after current date

EXAMPLE
                  package require widget::calendar ; # or widget::all
                  set t [widget::calendar .t]
                  pack $t -fill x -expand 1


BUGS, IDEAS, FEEDBACK
       This document, and the package it describes, will undoubtedly contain
       bugs and other problems.  Please report such in the category
       widget::calendar 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.

KEYWORDS
       calendar, date, megawidget, snit, widget

CATEGORY
       Widget



tklib                                1.0.1                  widget_calendar(n)
