NAME

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

COMMAND OPTIONS

$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. 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 automatically mapped to the screen. To prevent it from appearing in the screen, you must call withdraw immediately after calling release.

BUGS

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

AUTHOR

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

SEE ALSO

Tk::wm

KEYWORDS

TIX