## NAME

Wm - Tix's addition to the standard TK wm command.

## SYNOPSIS

$widget->capture

$widget->release

## DESCRIPTION

The capture and the release methods change the toplevel attribute of Tk widgets.

## COMMAND OPTIONS

$widget->capture
  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. pack) explictly.
$widget->release
  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, button). The newly-converted toplevel window is automatically mapped to the screen. To prevent it from appearing in the screen, you must call withdraw immediately after calling release.

## BUGS

How these methods interact with perl/Tk's class hierarchy is not yet clear. In particular a released window will not automatically "inherit" the Tk::Wm methods, however a captured window still will. It is likely that Capture and Release will be developed which will "re-bless" the object into an appropriate (perhaps dynamicaly created) class. (A released Label might make a good candidate for an Icon.)

## AUTHOR

Ioi Kim Lam - ioi@graphics.cis.upenn.edu

## SEE ALSO

wm

## KEYWORDS

TIX