tixWm(3)              User Contributed Perl Documentation             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 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.

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

perl v5.38.0                      2023-07-25                          tixWm(3)