iwidgets::dateentry(1)

📦 version 4.1.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 NAME 💖

iwidgets::dateentry — bestie, this makes a whole dateentry widget for you. That's the whole vibe. ✨

🦋 SYNOPSIS 🦋

iwidgets::dateentry pathName ?options?

🌸 INHERITANCE 🌸

The family tree, and yes she has main character energy all the way down:

itk::Widget   <-   iwidgets::LabeledWidget   <-  iwidgets::Datefield  <-
iwidgets::Dateentry

✨ STANDARD OPTIONS ✨

The classics. The basics. The ones every widget shows up with:

  • background
  • borderWidth
  • cursor
  • exportSelection
  • foreground
  • highlightColor
  • highlightThickness
  • insertBackground
  • justify
  • relief

See the options manual entry for details on the standard options. 📖

🎀 INHERITED OPTIONS 🎀

Stuff she got from her ancestors. Slay, genetics.

From the labeledwidget side:

  • disabledForeground
  • int
  • labelBitmap
  • labelFont
  • labelImage
  • labelMargin
  • labelPos
  • labelText
  • labelVariable
  • state
  • sticky

See the labeledwidget class manual entry for details on these inherited options.

From the datefield side:

  • command
  • iq
  • state
  • textBackground
  • textFont

See the datefield class manual entry for details on these inherited options.

🌈 ASSOCIATED OPTIONS 🌈

These come along for the ride because the calendar is right there:

  • backwardImage
  • buttonForeground
  • commandcurrentDateFont
  • dateFont
  • dayFont
  • days
  • forwardImage
  • outline
  • selectColor
  • selectThickness
  • startDay
  • titleFont
  • weekdayBackground
  • weekendBackground

See the calendar manual entry for details on the associated options. 🗓️

💅 WIDGET-SPECIFIC OPTIONS 💅

Okay so these are hers. Her own little signatures.

  • Name: grab
  • Class: Grab
  • Command-Line Switch: -grab

Specifies the grab level, local or global, to be obtained before bringing up the popup calendar. The default is global. For more information concerning grab levels, consult the documentation for Tk's grab command.

  • Name: icon
  • Class: Icon
  • Command-Line Switch: -icon

Specifies the calendar icon image to be used in the dateentry. This image must have been created previously with the image create command. Should one not be provided, then one will be generated, pixmap if possible, bitmap otherwise.

🔥 DESCRIPTION 🔥

The iwidgets::dateentry command creates a quicken style date entry field with a popup calendar, by combining the datefield and calendar widgets together. No cap, it's giving "two icons collaborating."

This lets a user enter the date via the keyboard, or by using the mouse and selecting the calendar icon — which brings up a popup calendar. Both paths, both valid, we love options. 💖

🫶 METHODS 🫶

The iwidgets::dateentry command creates a new Tcl command whose name is pathName. This command may be used to invoke various operations on the widget. It has the following general form:

pathName option ?arg arg ...?

option and the args determine the exact behavior of the command. The following commands are possible for dateentry widgets:

🧚 INHERITED METHODS 🧚

  • get
  • isvalid
  • show

See the datefield manual entry for details on the associated methods.

👑 WIDGET-SPECIFIC METHODS 👑

  • pathName cget option — Returns the current value of the configuration option given by option. Option may have any of the values accepted by the iwidgets::dateentry command.
  • pathName configure ?option? ?value option value ...? — Query or modify the configuration options of the widget. If no option is specified, returns a list describing all of the available options for pathName (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the iwidgets::dateentry command.

🍓 COMPONENTS 🍓

The glow-up breakdown, part by part:

  • Name: label
  • Class: Label

The label component provides a label component to used to identify the date. See the label widget manual entry for details on the label component item.

  • Name: iconbutton
  • Class: Label

The iconbutton component provides a labelbutton component to act as a lightweight button displaying the calendar icon. Upon pressing the labelbutton, the calendar appears. See the label widget manual entry for details on the labelbutton component item.

  • Name: date
  • Class: Entry

The date component provides the entry field for date input and display. See the entry widget manual entry for details on the date component item.

⭐ EXAMPLE ⭐

Copy-paste it, bestie, it just works:

package require Iwidgets 4.0
iwidgets::dateentry .de
pack .de

💜 AUTHOR 💜

Mark L. Ulferts

🌟 KEYWORDS 🌟

dateentry, widget

And that's the whole page, periodt. This icon of a manual lives under Tk, it's the iwidgets::dateentry(1) entry, and it ate. 💅✨

📦 where this page comes from