---
name: "Tk::tixWm"
section: "3pm"
platform: "linux"
package: "perl-tk"
version: "804.036-9"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Tk::tixWm"
---

# Tk::tixWm(3pm)

Tix's addition to the standard TK wm command.

## NAME

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

## SYNOPSIS

    *$widget*-\>**wmCapture**

    *$widget*-\>**wmRelease**

## DESCRIPTION

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

## 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

**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

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

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

## KEYWORDS

window manager, wm, TIX