widget_calendar(n)

🎀 widget_calendar(n) 🎀

Bestie, welcome to the widget_calendar(n) manual — straight out of the Various megawidgets family. ✨

✨ 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). And honestly? snidget is such a cute word, I can't. 🫶

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 — sets the first day of the week — either sunday or monday — and defaults to monday.
• -font — picks 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 — sets the language of the calendar contents, using language abbreviations — 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 — says whether 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. Yes, it says “updated” twice — she's consistent, okay? 💅

• Home — Move to the current date
• Up — Move to week before current date
• Down — Move to week after current date
• Left — Move to day before current date
• Right — Move to day after current date
• Control-Left — Move to month before current date
• Control-Right — Move to month after current date
• Control-Up — Move to year before current date
• 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. No cap, they said it themselves. 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) · the footer didn't give us a date, bestie, but it gave us vibes — bye! 💖✨