iwidgets::spintime(1)

✨ NAME ✨

iwidgets::spintime — bestie, this is the one that creates and manipulates time spinner widgets 💖 that's it, that's the whole job, and it does it gorgeously.

Oh and hi, welcome to the iwidgets::spintime(1) manual page, straight out of [incr Widgets]. Grab a snack, we're gonna go through every single option together 🍓

---

✨ SYNOPSIS ✨

iwidgets::spintime pathName ?options?

---

🌈 INHERITANCE 🌈

itk::Widget <- iwidgets::Spintime

so it's giving descended from itk::Widget, main character lineage, no notes 💅

---

💜 STANDARD OPTIONS 💜

• background
• cursor
• foreground
• relief

See the "options" manual entry for the details on the standard options, bestie — that's where the lore lives 📖

---

🦋 ASSOCIATED OPTIONS 🦋

• textBackground, textFont

See the "entryfield" manual entry for details on the above associated options 👀

• labelFont, labelMargin

See the "labeledwidget" manual entry for details on the above associated options ✨

• arrowOrient, repeatDelay, repeatInterval

See the "spinner" manual entry for details on the above associated options 🎀

---

👑 WIDGET-SPECIFIC OPTIONS 👑

These are the ones that are so spintime and nobody else, periodt.

• -labelpos — Name: labelPos · Class: Position · Command-Line Switch: -labelpos

Tells you where the label sits along the sides of the various spinners: n, e, s, or w. The default is w. west side story, literally

• -hourlabel — Name: hourLabel · Class: Text · Command-Line Switch: -hourlabel

The text of the label for the hour spinner. The default is "Hour". 🕐

• -houron — Name: hourOn · Class: hourOn · Command-Line Switch: -houron

Whether or not to display the hour spinner, in any of the forms acceptable to Tcl_GetBoolean. The default is true.

• -hourwidth — Name: hourWidth · Class: Width · Command-Line Switch: -hourwidth

The width of the hour spinner, in any of the forms acceptable to Tcl_GetPixels. The default is 3 pixels.

• -militaryon — Name: militaryOn · Class: militaryOn · Command-Line Switch: -militaryon

Specifies use of a 24 hour clock for hour display, in any of the forms acceptable to Tcl_GetBoolean. The default is true. 24hr girlies rise up ⏰

• -minutelabel — Name: minuteLabel · Class: Text · Command-Line Switch: -minutelabel

The text of the label for the minute spinner. The default is "Minute".

• -minuteon — Name: minuteOn · Class: minuteOn · Command-Line Switch: -minuteon

Whether or not to display the minute spinner, in any of the forms acceptable to Tcl_GetBoolean. The default is true.

• -minutewidth — Name: minuteWidth · Class: Width · Command-Line Switch: -minutewidth

The width of the minute spinner, in any of the forms acceptable to Tcl_GetPixels. The default is 3 pixels.

• -orient — Name: orient · Class: Orient · Command-Line Switch: -orient

The orientation of the hour, minute, and second spinners: vertical or horizontal. The default is horizontal. we lay flat, we vibe 🌊

• -secondlabel — Name: secondLabel · Class: Text · Command-Line Switch: -secondlabel

The text of the label for the second spinner. The default is "Second" — yes, with no period at the end, that's just how she is 🙈

• -secondon — Name: secondOn · Class: secondOn · Command-Line Switch: -secondon

Whether or not to display the second spinner, in any of the forms acceptable to Tcl_GetBoolean. The default is true.

• -secondwidth — Name: secondWidth · Class: Width · Command-Line Switch: -secondwidth

The width of the second spinner, in any of the forms acceptable to Tcl_GetPixels. The default is 3 pixels.

• -timemargin — Name: timeMargin · Class: Margin · Command-Line Switch: -timemargin

The margin space between the hour, minute, and second spinners, in any of the forms acceptable to Tcl_GetPixels. The default is 1 pixel.

---

🌸 DESCRIPTION 🌸

The iwidgets::spintime command creates a set of spinners for use in time value entry. The set includes an hour, minute, and second spinner widget. three little icons working together, we love a team 💅

---

🎀 METHODS 🎀

The iwidgets::spintime 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 spintime widgets:

---

💖 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::spintime 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::spintime command.

• pathName get ?format?

Returns the current contents of the spintime widget in a format of string or as an integer clock value using the -string and -clicks format options respectively. The default is by string. Reference the clock command for more information on obtaining time and its formats. iykyk ⏳

• pathName show time

Changes the currently displayed time to be that of the time argument. The time may be specified either as a string, an integer clock value or the keyword "now". Reference the clock command for more information on obtaining times and its format.

---

🧚 COMPONENTS 🧚

• Name: hour · Class: Spinint

The hour component is the hour spinner of the time spinner. See the SpinInt widget manual entry for details on the hour component item.

• Name: minute · Class: Spinint

The minute component is the minute spinner of the time spinner. See the SpinInt widget manual entry for details on the minute component item.

• Name: second · Class: Spinint

The second component is the second spinner of the time spinner. See the SpinInt widget manual entry for details on the second component item.

---

⭐ EXAMPLE ⭐

Steal this, bestie, it's exact:

package require Iwidgets 4.0 iwidgets::spintime .st pack .st -padx 10 -pady 10

---

💜 AUTHOR 💜

Sue Yockey · Mark L. Ulferts

legends, honestly, we thank them for their service 🫶

---

🔥 KEYWORDS 🔥

spintime, spinint, spinner, entryfield, entry, widget

---

Heads up bestie: this page is the Tk-flavored one, so it's filed as iwidgets::spintime(1) and that's the version you're holding right now 💖 Go build a clock, you're gonna slay ✨🎀