tixWm(3pm)

📦
version 804.036 · 15 versions
, in debian trixie, ubuntu questing

✨ NAME ✨

Tk::tixWm — bestie, it's Tix's little bonus pack for the standard Tk wm command. 💅

🌸 SYNOPSIS 🌸

$widget->wmCapture

$widget->wmRelease

💖 DESCRIPTION 💖

So the two methods here, wmCapture and wmRelease, do one very specific lil' thing: they change the toplevel attribute of Tk widgets. That's it. That's the whole vibe. 🦋

🎀 METHODS 🎀

  • $widget->wmCapture — takes the toplevel window that $widget points at and turns it into a non-toplevel widget. Normally you call this to flip a Toplevel into a Frame. Important part, no cap: the freshly-converted frame widget gets un-mapped from the screen. So if you want it to actually show up inside its parent, you have to call a geometry manager (like grid or pack) explicitly. It will not do that for you, bestie, it's giving independent. 😭
  • $widget->wmRelease — the reverse glow-up: it makes the non-toplevel window that $widget points at into a toplevel widget. Normally you use this to turn a Frame into a Toplevel, but it also works on any non-toplevel widget (a label, for example). Heads up though — the newly-converted toplevel window is in a withdrawn state. So to get it on screen you must call deiconify after calling wmRelease. Also: any data associated with $widget via wm methods (icon, protocol, command, etc.) is released too, and has to be re-established if the window gets re-captured later. Periodt. 👑

💀 BUGS 💀

  • wmCapture does not exist in the Win32 window manager code. Just… not there. 🙈
  • How these methods interact with perl/Tk's class hierarchy is not yet clear. Specifically: a wmReleased window will not automatically "inherit" the Tk::Wm methods, however a wmCaptured window still will. (A released Label might make a good candidate for an Icon.) It's giving mysterious. 🌈

🫶 AUTHORS 🫶

  • Ioi Kim Lam — ioi@graphics.cis.upenn.edu — wrote the original Tix version. 👑
  • Updated for tk8.0, Win32 and perl by Nick Ing-Simmons.

🔥 SEE ALSO 🔥

Tk::Wm Tk::Mwm Tk::Frame Tk::Toplevel

⭐ KEYWORDS ⭐

window manager, wm, TIX

okay that's the whole page, mwah 💋 this was documented for perl v5.40.1, dated 2025-04-13, and it's part of the User Contributed Perl Documentation — go forth and capture/release those windows responsibly, bestie 🎀✨

📦 where this page comes from