projects / OpenSPARC-T2-DV / blame
| Commit | Line | Data |
|---|---|---|
| 86530b38 AT |
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 |