tixwm(3)
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 wid
get, but it can also be used on any non-toplevel wid
get (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 wmRe lease. - Any data associated with $widget via wm methods (icon, protocol, command etc.) are released, and must be reestablished 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 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 - 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