home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _2b10b6b3312cbc9bf666e136e7191e63 < prev    next >
Text File  |  2000-03-23  |  7KB  |  165 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>grab - Confine pointer and keyboard events to a window sub-tree</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> grab - Confine pointer and keyboard events to a window sub-tree</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="#bugs">BUGS</A></LI>
  26.     <LI><A HREF="#keywords">KEYWORDS</A></LI>
  27. </UL>
  28. <!-- INDEX END -->
  29.  
  30. <HR>
  31. <P>
  32. <H1><A NAME="name">NAME</A></H1>
  33. <P>grab - Confine pointer and keyboard events to a window sub-tree</P>
  34. <P>
  35. <HR>
  36. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  37. <UL>
  38. <LI>Linux</LI>
  39. <LI>Solaris</LI>
  40. <LI>Windows</LI>
  41. </UL>
  42. <HR>
  43. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  44. <P><EM>$widget</EM>-><STRONG>grab</STRONG></P>
  45. <P><EM>$widget</EM>-><STRONG>grab</STRONG><EM>Option</EM></P>
  46. <P>
  47. <HR>
  48. <H1><A NAME="description">DESCRIPTION</A></H1>
  49. <P>This set of methods implement simple pointer and keyboard grabs for Tk.
  50. Tk's grabs are different than the grabs
  51. described in the Xlib documentation.
  52. When a grab is set for a particular window, Tk restricts all pointer
  53. events to the grab window and its descendants in Tk's window hierarchy.
  54. Whenever the pointer is within the grab window's subtree, the pointer
  55. will behave exactly the same as if there had been no grab at all
  56. and all events will be reported in the normal fashion.
  57. When the pointer is outside <EM>$widget</EM>'s tree, button presses and
  58. releases and
  59. mouse motion events are reported to <EM>$widget</EM>, and window entry
  60. and window exit events are ignored.
  61. The grab subtree ``owns'' the pointer:
  62. windows outside the grab subtree will be visible on the screen
  63. but they will be insensitive until the grab is released.
  64. The tree of windows underneath the grab window can include top-level
  65. windows, in which case all of those top-level windows
  66. and their descendants will continue to receive mouse events
  67. during the grab.</P>
  68. <P>Two forms of grabs are possible:  local and global.
  69. A local grab affects only the grabbing application:  events will
  70. be reported to other applications as if the grab had never occurred.
  71. Grabs are local by default.
  72. A global grab locks out all applications on the screen,
  73. so that only the given subtree of the grabbing application will be
  74. sensitive to pointer events (mouse button presses, mouse button releases,
  75. pointer motions, window entries, and window exits).
  76. During global grabs the window manager will not receive pointer
  77. events either.</P>
  78. <P>During local grabs, keyboard events (key presses and key releases)
  79. are delivered as usual:  the window
  80. manager controls which application receives keyboard events, and
  81. if they are sent to any window in the grabbing application then they are
  82. redirected to the focus window.
  83. During a global grab Tk grabs the keyboard so that all keyboard events
  84. are always sent to the grabbing application.
  85. The <STRONG>focus</STRONG> method is still used to determine which window in the
  86. application receives the keyboard events.
  87. The keyboard grab is released when the grab is released.</P>
  88. <P>Grabs apply to particular displays.  If an application has windows
  89. on multiple displays then it can establish a separate grab on each
  90. display.
  91. The grab on a particular display affects only the windows on
  92. that display.
  93. It is possible for different applications on a single display to have
  94. simultaneous local grabs, but only one application can have a global
  95. grab on a given display at once.</P>
  96. <P>The <STRONG>grab</STRONG> methods take any of the following forms:</P>
  97. <DL>
  98. <DT><STRONG><A NAME="item_grabCurrent"><EM>$widget</EM>-><STRONG>grabCurrent</STRONG></A></STRONG><BR>
  99. <DD>
  100. Returns the current grab
  101. window in this application for <EM>$widget</EM>'s display, or an empty
  102. string if there is no such window.
  103. <P></P>
  104. <DT><STRONG><A NAME="item_grabs"><EM>$widget</EM>-><STRONG>grabs</STRONG></A></STRONG><BR>
  105. <DD>
  106. Returns a list whose elements
  107. are all of the windows grabbed by this application for all displays,
  108. or an empty string if the application has no grabs.
  109. <P><EM>Not implemented yet!</EM></P>
  110. <P></P>
  111. <DT><STRONG><A NAME="item_grabRelease"><EM>$widget</EM>-><STRONG>grabRelease</STRONG></A></STRONG><BR>
  112. <DD>
  113. Releases the grab on <EM>$widget</EM> if there is one, otherwise does
  114. nothing.  Returns an empty string.
  115. <P></P>
  116. <DT><STRONG><A NAME="item_grab"><EM>$widget</EM>-><STRONG>grab</STRONG></A></STRONG><BR>
  117. <DD>
  118. Sets a local grab on <EM>$widget</EM>.
  119. If a grab was already in effect for this application on
  120. <EM>$widget</EM>'s display then it is automatically released.
  121. If there is already a local grab on <EM>$widget</EM>, then the command
  122. does nothing.  Returns an empty string.
  123. <P></P>
  124. <DT><STRONG><A NAME="item_grabGlobal"><EM>$widget</EM>-><STRONG>grabGlobal</STRONG></A></STRONG><BR>
  125. <DD>
  126. Sets a global grab on <EM>$widget</EM>.
  127. If a grab was already in effect for this application on
  128. <EM>$widget</EM>'s display then it is automatically released.
  129. If there is already a global grab on <EM>$widget</EM>,
  130. then the command does nothing.  Returns an empty string.
  131. <P></P>
  132. <DT><STRONG><A NAME="item_grabStatus"><EM>$widget</EM>-><STRONG>grabStatus</STRONG></A></STRONG><BR>
  133. <DD>
  134. Returns <STRONG>none</STRONG> if no grab is currently set on <EM>$widget</EM>,
  135. <STRONG>local</STRONG> if a local grab is set on <EM>$widget</EM>, and
  136. <STRONG>global</STRONG> if a global grab is set.
  137. <P></P></DL>
  138. <P>
  139. <HR>
  140. <H1><A NAME="bugs">BUGS</A></H1>
  141. <P>It took an incredibly complex and gross implementation to produce
  142. the simple grab effect described above.
  143. Given the current implementation, it isn't safe for applications
  144. to use the Xlib grab facilities at all except through the Tk grab
  145. procedures.
  146. If applications try to manipulate X's grab mechanisms directly,
  147. things will probably break.</P>
  148. <P>If a single process is managing several different Tk applications,
  149. only one of those applications can have a local grab for a given
  150. display at any given time.  If the applications are in different
  151. processes, this restriction doesn't exist.</P>
  152. <P>
  153. <HR>
  154. <H1><A NAME="keywords">KEYWORDS</A></H1>
  155. <P>grab, keyboard events, pointer events, window</P>
  156. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  157. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  158. <STRONG><P CLASS=block> grab - Confine pointer and keyboard events to a window sub-tree</P></STRONG>
  159. </TD></TR>
  160. </TABLE>
  161.  
  162. </BODY>
  163.  
  164. </HTML>
  165.