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