home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _0ccd6465e1812b76f09c2d82fc0d3c48 < prev    next >
Text File  |  2000-03-23  |  6KB  |  144 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Tk::Mwm - Communicate with the Motif window manager.</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Tk::Mwm - Communicate with the Motif window manager.</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#methods">METHODS</A></LI>
  26.     <LI><A HREF="#bugs">BUGS</A></LI>
  27.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  28.     <LI><A HREF="#keywords">KEYWORDS</A></LI>
  29.     <LI><A HREF="#author">AUTHOR</A></LI>
  30. </UL>
  31. <!-- INDEX END -->
  32.  
  33. <HR>
  34. <P>
  35. <H1><A NAME="name">NAME</A></H1>
  36. <P>Tk::Mwm - Communicate with the <CODE>Motif(tm)</CODE> window manager.</P>
  37. <P>
  38. <HR>
  39. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  40. <UL>
  41. <LI>Linux</LI>
  42. <LI>Solaris</LI>
  43. <LI>Windows</LI>
  44. </UL>
  45. <HR>
  46. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  47. <P>    <STRONG>use Tk::Mwm;</STRONG></P>
  48. <P>    <EM>$toplevel</EM>-><STRONG>mwm</STRONG><EM>Option</EM>?(<EM>args</EM>)?</P>
  49. <P>    <EM>$toplevel</EM>-><STRONG>mwm</STRONG>(<EM>option</EM> ?,<EM>args</EM>?)</P>
  50. <P>
  51. <HR>
  52. <H1><A NAME="description">DESCRIPTION</A></H1>
  53. <P>Interface to special extentions supported by mwm.</P>
  54. <P>
  55. <HR>
  56. <H1><A NAME="methods">METHODS</A></H1>
  57. <DL>
  58. <DT><STRONG><A NAME="item_mwmDecoration"><EM>$toplevel</EM>-><STRONG>mwmDecoration</STRONG>?(?option??=>value? ?,...?)?</A></STRONG><BR>
  59. <DD>
  60. When no options are given, this method returns the values of all the
  61. decorations options for the toplevel window with the <EM>$toplevel</EM>.
  62. When only one option is given without specifying the value, the
  63. current value of that option is returned.
  64. When more than one ``option-value'' pairs are passed to this method,
  65. the specified values will be assigned to the corresponding options. As
  66. a result, the appearance of the Motif decorations around the toplevel
  67. window will be changed.
  68. Possible options are: <STRONG>-border</STRONG>, <STRONG>-menu</STRONG>, <STRONG>-maximize</STRONG>,
  69. <STRONG>-minimize</STRONG>, <STRONG>-resizeh</STRONG> and <STRONG>-title</STRONG>. The value must be a
  70. Boolean value. The values returned by this command are undefined when
  71. the window is not managed by mwm.
  72. <P></P>
  73. <DT><STRONG><A NAME="item_mwmIsmwmrunning"><EM>$toplevel</EM>-><STRONG>mwmIsmwmrunning</STRONG></A></STRONG><BR>
  74. <DD>
  75. This returns value is true if mwm is running on the screen where the specified
  76. window is located, false otherwise.
  77. <P></P>
  78. <DT><STRONG><A NAME="item_mwmProtocol"><EM>$toplevel</EM>-><STRONG>mwmProtocol</STRONG></A></STRONG><BR>
  79. <DD>
  80. When no additional options are given, this method returns all
  81. protocols associated with this toplevel window.
  82. <P></P>
  83. <DT><STRONG><EM>$toplevel</EM>-><STRONG>mwmProtocol</STRONG>(<STRONG>activate</STRONG> => <EM>protocol_name</EM>)</STRONG><BR>
  84. <DD>
  85. Activate the mwm protocol message in mwm's menu.
  86. <P></P>
  87. <DT><STRONG><A NAME="item_MwmProtocol"><EM>$toplevel</EM>-><STRONG>MwmProtocol</STRONG>(<STRONG>add</STRONG> => <EM>protocol_name</EM>, <EM>menu_message</EM>)</A></STRONG><BR>
  88. <DD>
  89. Add a new mwm protocol message for this toplevel window. The
  90. message is identified by the string name specified in
  91. <EM>protocol_name</EM>.  A menu item will be added into mwm's menu as
  92. specified by <EM>menu_message</EM>.  Once a new mwm protocol message is
  93. added to a toplevel, it can be caught by the TK <STRONG>protocol</STRONG>
  94. method. Here is an example:
  95. <P>    <EM>$toplevel</EM>-><STRONG>mwmProtocol</STRONG>(<STRONG>'add'</STRONG> => 'MY_PRINT_HELLO', '``Print Hello''  _H Ctrl<Key>H');</P>
  96. <P>    <EM>$toplevel</EM>-><STRONG>protocol</STRONG>(<STRONG>'MY_PRINT_HELLO'</STRONG> => sub {print ``Hello''});</P>
  97. <P></P>
  98. <DT><STRONG><EM>$toplevel</EM>-><STRONG>mwmProtocol</STRONG>(<STRONG>'deactivate'</STRONG> => <EM>protocol_name</EM>)</STRONG><BR>
  99. <DD>
  100. Deactivate the mwm protocol message in mwm's menu.
  101. <P></P>
  102. <DT><STRONG><EM>$toplevel</EM>-><STRONG>mwmProtocol</STRONG>(<STRONG>'delete'</STRONG> => <EM>protocol_name</EM>)</STRONG><BR>
  103. <DD>
  104. Delete the mwm protocol message from mwm's menu. Please note that the
  105. window manager protocol handler associated with this protocol (by the
  106. <STRONG>protocol</STRONG> method) is not deleted automatically. You have to
  107. delete the protocol handle explicitly.  E.g.:
  108. <P>    <EM>$mw</EM>-><STRONG>mwmProtocol</STRONG>(<STRONG>'delete'</STRONG> => 'MY_PRINT_HELLO');</P>
  109. <P>    <EM>$mw</EM>-><STRONG>protocol</STRONG>(<STRONG>'MY_PRINT_HELLO'</STRONG> => '');</P>
  110. <P></P></DL>
  111. <P>
  112. <HR>
  113. <H1><A NAME="bugs">BUGS</A></H1>
  114. <P>This is a Tix extension which perl/Tk has adopted. It has not been
  115. tested as perl/Tk's author has not got round to installing a Motif Window
  116. Manager.</P>
  117. <P>On some versions of mwm, the <STRONG>-border</STRONG> will not disappear unless
  118. <STRONG>-resizeh</STRONG> is turned off. Also, the <STRONG>-title</STRONG> will not disappear
  119. unless all of <STRONG>-title</STRONG>, <STRONG>-menu</STRONG>, <STRONG>-maximize</STRONG> and
  120. <STRONG>-minimize</STRONG> are turned off.</P>
  121. <P>
  122. <HR>
  123. <H1><A NAME="see also">SEE ALSO</A></H1>
  124. <P><A HREF="../../../site/lib/Tk/Wm.html">Tk::Wm</A>
  125. <A HREF="../../../site/lib/Tk/tixWm.html">Tk::tixWm</A>
  126. <A HREF="../../../site/lib/Tk/Toplevel.html">Tk::Toplevel</A></P>
  127. <P>
  128. <HR>
  129. <H1><A NAME="keywords">KEYWORDS</A></H1>
  130. <P>window manager, mwm, TIX</P>
  131. <P>
  132. <HR>
  133. <H1><A NAME="author">AUTHOR</A></H1>
  134. <P>Ioi Kim Lam - <A HREF="mailto:ioi@graphics.cis.upenn.edu">ioi@graphics.cis.upenn.edu</A></P>
  135. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  136. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  137. <STRONG><P CLASS=block> Tk::Mwm - Communicate with the Motif window manager.</P></STRONG>
  138. </TD></TR>
  139. </TABLE>
  140.  
  141. </BODY>
  142.  
  143. </HTML>
  144.