tooltip(3tk)

💖 tooltip — Tooltip management 💖

okay bestie, welcome to tooltip(3tk), the manual page for the Tcl tooltip package 🫶 this is the one that makes lil text messages pop up when your mouse hovers over stuff. iconic behaviour honestly.

---

✨ NAME ✨

tooltip — Tooltip management 💅

---

🌸 SYNOPSIS 🌸

package require Tcl 8.5

package require tooltip ?2.0.1?

::tooltip::tooltip command ?options?

::tooltip::tooltip pathName ?option value...? ?--? message

---

🦋 DESCRIPTION 🦋

so this package gives you tooltips, which are literally just tiny text messages that show up when the mouse hovers over a widget, a menu item, a canvas item, a listbox item, a ttk::treeview item or column heading, a ttk::notebook tab, or a text widget tag. that's the whole vibe. hover → message → slay ✨

---

👑 COMMANDS 👑

::tooltip::tooltip command ?options?

manage the tooltip package with these subcommands, bestie. here's the whole roster:

• clear ?pattern? — stops the specified widgets from showing tooltips. pattern is a glob pattern and defaults to matching all widgets. so yeah, no pattern = everybody loses their tooltip, sorry not sorry 💀
• configure ?option ?value option value ...?? — queries or modifies the configuration options of the tooltip. the supported options are -backgroud, -foreground and -font. (yes it says -backgroud, that's not a typo i made, that's just what it is, no cap 😭). if no option is specified, it returns a dictionary of the option values. if one option is specified with no value, it returns the value of that option. otherwise, it sets the given options to the corresponding values. ✨
• delay ?millisecs? — query or set the hover delay. this is the interval that the pointer must remain over the widget before the tooltip is displayed. the delay is specified in milliseconds and must be greater than or equal to 50 ms. with no argument the current delay is returned. 👑
• fade ?boolean? — enable or disable fading of the tooltip. the fading is enabled by default on Win32 and Aqua. the tooltip will fade away on Leave events instead disappearing. cute lil exit, honestly 🎀
• disable, off — Disable all tooltips 🙈
• enable, on — Enables tooltips for defined widgets. 🔥

::tooltip::tooltip pathName ?option value...? ?--? message

this command arranges for widget pathName to display a tooltip with a message. main character energy fr fr 💅

if the specified widget is a menu, canvas, listbox, ttk::treeview, ttk::notebook or text widget then additional options are used to tie the tooltip to specific menu, canvas or listbox items, ttk::treeview items or column headings, ttk::notebook tabs, or text widget tags.

• -heading columnId — this option is used to set a tooltip for a ttk::treeview column heading. the column does not need to already exist. you should not use the same identifiers for columns and items in a widget for which you are using tooltips as their tooltips will be mixed 😭. the widget must be a ttk::treeview widget.
• -image image — the specified (photo) image will be displayed to the left of the primary tooltip message. lil glow-up for your tooltip 🖼️✨
• -index index — this option is used to set a tooltip on a menu item. the index may be either the entry index or the entry label. the widget must be a menu widget but the entries do not have to exist when the tooltip is set. future-proof, we love to see it 👑
• -info info — the specified info text will be displayed as additional information below the primary tooltip message.
• -items items — this option is used to set a tooltip for canvas, listbox or ttk::treview items. for the canvas widget, the item must already be present in the canvas and will be found with a find withtag lookup. for listbox and ttk::treview widgets the item(s) may be created later but the programmer is responsible for managing the link between the listbox or ttk::treview item index and the corresponding tooltip. if the listbox or ttk::treview items are re-ordered, the tooltips will need amending. ⚠️

if the widget is not a canvas, listbox or ttk::treview then an error is raised. 💀

• -tab tabId — the -tab option can be used to set a tooltip for a ttk::notebook tab. the tab should already be present when this command is called, or an error will be returned. the widget must be a ttk::notebook widget.
• -tag name — the -tag option can be used to set a tooltip for a text widget tag. the tag should already be present when this command is called, or an error will be returned. the widget must be a text widget.
• -- — the -- option marks the end of options. the argument following this one will be treated as message even if it starts with a -. thank u --, our saviour 🙏

---

🌈 EXAMPLE 🌈

okay this is the part where it gets good. every single one of these is copy-pasteable and correct, keep them exactly as written bestie:

# Demonstrate widget tooltip
package require tooltip
pack [label .l -text "label"]
tooltip::tooltip .l "This is a label widget"

# Demonstrate menu tooltip
package require tooltip
. configure -menu [menu .menu]
.menu add cascade -label Test -menu [menu .menu.test -tearoff 0]
.menu.test add command -label Tooltip
tooltip::tooltip .menu.test -index 0 "This is a menu tooltip"

# Demonstrate canvas item tooltip
package require tooltip
pack [canvas .c]
set item [.c create rectangle 10 10 80 80 -fill red]
tooltip::tooltip .c -item $item "Canvas item tooltip"

# Demonstrate listbox item tooltip
package require tooltip
pack [listbox .lb]
.lb insert 0 "item one"
tooltip::tooltip .lb -item 0 "Listbox item tooltip"

# Demonstrate ttk::notebook tab tooltip
package require tooltip
pack [ttk::notebook .nb]
.nb add [frame .nb.f1 -height 50] -text "First tab"
.nb add [frame .nb.f2 -height 50] -text "Second tab"
tooltip::tooltip .nb -tab 0 "Tooltip for the 1st notebook tab"
tooltip::tooltip .nb -tab 1 "Tooltip for the 2nd notebook tab"

# Demonstrate text tag tooltip
package require tooltip
pack [text .txt]
.txt tag configure TIP-1 -underline 1
tooltip::tooltip .txt -tag TIP-1 "tooltip one text"
.txt insert end "An example of a " {} "tooltip" TIP-1 " tag.\n" {}

---

🧚 MIGRATION FROM VERSION 1 🧚

okay so this is the lore drop 📜. version 1.3 to 1.7 called msgcat::mc before a tooltip was shown, using the tooltip namespace. msgcat::mc requires the caller environment. due to that, version 1.8 recorded the caller namespace and used this in the call. in version 2.0, any msgcat::mc support was removed. the options -namespace, -msgargs and -infoargs were removed. starting with TCL 8.7, msgcat::mc supports oo classes and oo methods. but the oo caller environment is not present when the msgcat::mc was invoked on tooltip display, resulting in runtime errors. it was concluded as bad design to call msgcat::mc late. the caller should reinstall the tooltips on eventual message change. periodt. 💅

---

💀 BUGS, IDEAS, FEEDBACK 💀

this document, and the package it describes, will undoubtedly contain bugs and other problems (ngl, every doc does 😭). please report such in the category tooltip of the Tklib Trackers [http://core.tcl.tk/tklib/reportlist](http://core.tcl.tk/tklib/reportlist). please also report any ideas for enhancements you may have for either package and/or documentation. we want the feedback, fr fr 🫶

---

⭐ KEYWORDS ⭐

balloon, help, hover, tooltip

---

💜 COPYRIGHT 💜

Copyright (c) 1996-2008, Jeffrey Hobbs

Copyright (c) 2024 Emmanuel Frecon

---

and that's the whole page bestie, you ate it 🍓 this was tooltip(3tk) from tklib, version 2.0.1 — go forth and hover responsibly, ily, bye 💖✨🎀🦋