home *** CD-ROM | disk | FTP | other *** search
/ Netrunner 2004 October / NETRUNNER0410.ISO / regular / ActivePerl-5.8.4.810-MSWin32-x86.msi / _307bdde2a78ef5348d0d0e2a7aa140e4 < prev    next >
Encoding:
Text File  |  2004-06-01  |  2.0 KB  |  74 lines
  1.  
  2.  
  3. =head1 NAME
  4.  
  5. Tk::tixWm - Tix's addition to the standard TK wm command.
  6.  
  7. =for category  Tix Extensions
  8.  
  9. =head1 SYNOPSIS
  10.  
  11. S<    >I<$widget>-E<gt>B<wmCapture>
  12.  
  13. S<    >I<$widget>-E<gt>B<wmRelease>
  14.  
  15. =head1 DESCRIPTION
  16.  
  17. The B<wmCapture> and the B<wmRelease> methods change the
  18. toplevel attribute of Tk widgets.
  19.  
  20. =head1 METHODS
  21.  
  22. =over 4
  23.  
  24. =item I<$widget>-E<gt>B<wmCapture>
  25.  
  26. Converts the toplevel window specified by I<$widget> into a non-toplevel
  27. widget. Normally this command is called to convert a L<Toplevel|Tk::Toplevel> widget
  28. into a L<Frame|Tk::Frame> widget. The newly-converted frame widget is
  29. un-mapped from the screen. To make it appear inside its parent, you
  30. must call a geometry manager (e.g. grid or pack) explictly.
  31.  
  32. =item I<$widget>-E<gt>B<wmRelease>
  33.  
  34. Makes the non-toplevel window specified by I<$widget> into a toplevel
  35. widget. Normally this command is called to convert a L<Frame|Tk::Frame> widget
  36. into a L<Toplevel|Tk::Toplevel> widget, but it can also be used on any
  37. non-toplevel widget (e.g, label). The newly-converted toplevel window
  38. is in a B<withdrawn> state. To make it appear on the screen, you must call
  39. B<deiconify> after calling B<wmRelease>.
  40.  
  41. Any data associated with I<$widget> via B<wm> methods (icon, protocol,
  42. command etc.) are released, and must be re-established if window is later
  43. re-captured.
  44.  
  45. =back
  46.  
  47. =head1 BUGS
  48.  
  49. B<wmCapture> does not exist in the Win32 window manager code.
  50.  
  51. How these methods interact with perl/Tk's class hierarchy is not yet clear.
  52. In particular a B<wmRelease>d window will not automatically ``I<inherit>''
  53. the B<Tk::Wm> methods, however a B<wmCapture>d window still will.
  54. (A B<release>d B<Label> might make a good candidate for an B<Icon>.)
  55.  
  56. =head1 AUTHORS
  57.  
  58. Ioi Kim Lam - ioi@graphics.cis.upenn.edu wrote original Tix version.
  59. Updated for tk8.0, Win32 and perl by Nick Ing-Simmons.
  60.  
  61. =head1 SEE ALSO
  62.  
  63. L<Tk::Wm|Tk::Wm>
  64. L<Tk::Mwm|Tk::Mwm>
  65. L<Tk::Frame|Tk::Frame>
  66. L<Tk::Toplevel|Tk::Toplevel>
  67.  
  68. =head1 KEYWORDS
  69.  
  70. window manager, wm, TIX
  71.  
  72. =cut
  73.  
  74.