Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tk::tixWm (3)

Name

Tk::tixWm - Tix's addition to the standard TK wm command.

Synopsis

$widget->wmCapture

$widget->wmRelease

Description

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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+----------------------------+
       |ATTRIBUTE TYPE |      ATTRIBUTE VALUE       |
       +---------------+----------------------------+
       |Availability   | library/perl-5/perl-tk-532 |
       +---------------+----------------------------+
       |Stability      | Volatile                   |
       +---------------+----------------------------+

SEE ALSO
       Tk::Wm Tk::Mwm Tk::Frame Tk::Toplevel

KEYWORDS
       window manager, wm, TIX



NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://search.cpan.org/CPAN/authors/id/S/SR/SREZIC/Tk-804.036.tar.gz.

       Further information about this software can be found on the open source
       community website at http://search.cpan.org/~srezic/Tk.



perl v5.32.0                      2013-11-15                          tixWm(3)