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¶
- -command
- 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.
- -dateformat
- The format of the date that is entered or returned. Default: %m/%d/%Y.
- -firstday
- See the widget::calendar man page.
- -font
- Select the font used in the widget. It defaults to Helvetica 9.
- -highlightcolor
- See the widget::calendar man page. See the calendar man page.
- -language
- See the widget::calendar man page.
- -shadecolor
- See the widget::calendar man page.
- -showpast
- See the widget::calendar man page.
- -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
- Returns the selected date.
- pathname set 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 |