1Mwm(3)                User Contributed Perl Documentation               Mwm(3)
2
3
4

NAME

6       Tk::Mwm - Communicate with the Motif(tm) window manager.
7

SYNOPSIS

9           use Tk::Mwm;
10
11           $toplevel->mwmOption?(args)?
12
13           $toplevel->mwm(option ?,args?)
14

DESCRIPTION

16       Interface to special extentions supported by mwm.
17

METHODS

19       $toplevel->mwmDecoration?(?option??=>value? ?,...?)?
20           When no options are given, this method returns the values of all
21           the decorations options for the toplevel window with the $toplevel.
22           When only one option is given without specifying the value, the
23           current value of that option is returned.  When more than one
24           "option-value" pairs are passed to this method, the specified
25           values will be assigned to the corresponding options. As a result,
26           the appearance of the Motif decorations around the toplevel window
27           will be changed.  Possible options are: -border, -menu, -maximize,
28           -minimize, -resizeh and -title. The value must be a Boolean value.
29           The values returned by this command are undefined when the window
30           is not managed by mwm.
31
32       $toplevel->mwmIsmwmrunning
33           This returns value is true if mwm is running on the screen where
34           the specified window is located, false otherwise.
35
36       $toplevel->mwmProtocol
37           When no additional options are given, this method returns all
38           protocols associated with this toplevel window.
39
40       $toplevel->mwmProtocol(activate => protocol_name)
41           Activate the mwm protocol message in mwm's menu.
42
43       $toplevel->MwmProtocol(add => protocol_name, menu_message)
44           Add a new mwm protocol message for this toplevel window. The
45           message is identified by the string name specified in
46           protocol_name.  A menu item will be added into mwm's menu as
47           specified by menu_message.  Once a new mwm protocol message is
48           added to a toplevel, it can be caught by the TK protocol method.
49           Here is an example:
50
51               $toplevel->mwmProtocol('add' => 'MY_PRINT_HELLO', '"Print
52           Hello"  _H Ctrl<Key>H');
53
54               $toplevel->protocol('MY_PRINT_HELLO' => sub {print "Hello"});
55
56       $toplevel->mwmProtocol('deactivate' => protocol_name)
57           Deactivate the mwm protocol message in mwm's menu.
58
59       $toplevel->mwmProtocol('delete' => protocol_name)
60           Delete the mwm protocol message from mwm's menu. Please note that
61           the window manager protocol handler associated with this protocol
62           (by the protocol method) is not deleted automatically. You have to
63           delete the protocol handle explicitly.  E.g.:
64
65               $mw->mwmProtocol('delete' => 'MY_PRINT_HELLO');
66
67               $mw->protocol('MY_PRINT_HELLO' => '');
68

BUGS

70       This is a Tix extension which perl/Tk has adopted. It has not been
71       tested as perl/Tk's author has not got round to installing a Motif
72       Window Manager.
73
74       On some versions of mwm, the -border will not disappear unless -resizeh
75       is turned off. Also, the -title will not disappear unless all of
76       -title, -menu, -maximize and -minimize are turned off.
77

SEE ALSO

79       Tk::Wm Tk::tixWm Tk::Toplevel
80

KEYWORDS

82       window manager, mwm, TIX
83

AUTHOR

85       Ioi Kim Lam - ioi@graphics.cis.upenn.edu
86
87
88
89perl v5.12.0                      2010-05-13                            Mwm(3)
Impressum