tixWm(3) User Contributed Perl Documentation tixWm(3)

# [NAME](#NAME)

Tk::tixWm - Tix's addition to the standard TK wm command.

# [SYNOPSIS](#SYNOPSIS)

    *$widget*->**wmCapture**

    *$widget*->**wmRelease**

# [DESCRIPTION](#DESCRIPTION)

The **wmCapture** and the **wmRelease** methods change the toplevel attribute of Tk widgets.

# [METHODS](#METHODS)

*$widget*->**wmCapture**

Converts the toplevel window specified by *$widget* into a non-toplevel widget. Normally this command is called to convert a Toplevel widget into a Frame widget. The newly-converted frame widget is un-mapped from the screen. To make it appear inside its parent, you must call a geometry manager (e.g. grid or pack) explictly.

*$widget*->**wmRelease**

Makes the non-toplevel window specified by *$widget* into a toplevel widget. Normally this command is called to convert a Frame widget into a Toplevel widget, but it can also be used on any non-toplevel widget (e.g, label). The newly-converted toplevel window is in a **withdrawn** state. To make it appear on the screen, you must call **deiconify** after calling **wmRelease**.

Any data associated with *$widget* via **wm** methods (icon, protocol, command etc.) are released, and must be re-established if window is later re-captured.

# [BUGS](#BUGS)

**wmCapture** does not exist in the Win32 window manager code.

How these methods interact with perl/Tk's class hierarchy is not yet clear. In particular a **wmRelease**d window will not automatically \`\`*inherit*'' the **Tk::Wm** methods, however a **wmCapture**d window still will. (A **release**d **Label** might make a good candidate for an **Icon**.)

# [AUTHORS](#AUTHORS)

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

# [SEE ALSO](#SEE_ALSO)

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

# [KEYWORDS](#KEYWORDS)

window manager, wm, TIX

2026-10-26 perl v5.44.0

---

Document: Tk::tixWm(3pm) from perl-tk 804.036-r13 (Chainguard OS)
Source: https://github.com/eserte/perl-tk