Scroll to navigation

widget_dateentry(3tk) Various megawidgets widget_dateentry(3tk)


NAME

widget_dateentry - Date Entry Megawidget

SYNOPSIS

package require Tcl 8.4

package require Tk 8.4

package require widget ?3.0?

package require widget::dateentry ?0.97?

widget::dateentry pathname ?options?

pathname get

pathname set date


DESCRIPTION

This package provides a dateentry megawidget (snidget). It is based on an ttk::entry. All widget commands of the ttk::entry are available for the dateentry.

WIDGET OPTIONS

A command prefix to evaluate when a date was selected. The command prefix is executed in the global namespace and given two arguments, the raw date in seconds, and the formatted date, as per option -dateformat.
The format of the date that is entered or returned. Default: %m/%d/%Y.
See the widget::calendar man page.
Select the font used in the widget. It defaults to Helvetica 9.
See the widget::calendar man page. See the calendar man page.
See the widget::calendar man page.
See the widget::calendar man page.
See the widget::calendar man page.
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

Returns the selected date.
Programmatically sets a new date. Expects that the date is in the same format as configured by option -dateformat.

The same effect can also be achieved by setting a linked -textvariable.

DEFAULT BINDINGS

On creation of the dateentry widget the following bindings are installed. For navigation within the calendar, see its manpage.

  • Button-1 - Accept and select the date and close the calendar window.
  • Return, space - Accept the selected date and close the calendar window
  • Escape - Close calendar window
  • Control-space - Show calendar window

EXAMPLE


package require widget::dateentry; # or widget::all
set t [widget::dateentry .de]
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::dateentry 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

date, dateentry, megawidget, snit, widget

CATEGORY

Widget

0.97 tklib