Tk::tixWm(3pm)

Tk::tixWm3pm

Tix's addition to the standard tk wm command.

Usage

$widget->wmCapture

$widget->wmRelease

Overview

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.

Keywords

window manager, wm, TIX

Releases

15 releases since Debian 2.1 (Slink); the text changed 14 times.

  1. 2.1
  2. 2.2
  3. 3.0
  4. 3.1
  5. 4.0
  6. 5.0
  7. 6.0
  8. 7
  9. 8
  10. 9
  11. 10
  12. 11
  13. 12
  14. 13
  15. Arch

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 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.)

Authors

Ioi Kim Lam - [email protected] wrote original Tix version. Updated for tk8.0, Win32 and perl by Nick Ing-Simmons.

From perl-tk 804.036-9 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.