<doc>
  <legacy_id>1383</legacy_id>
  <name>pointerFocus</name>
  <type>property</type>
  <syntax>
    <example>set the pointerFocus to {true | false}</example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>User Interaction</category>
  </classification>
  <references>
    <property tag="raiseMenus">raiseMenus Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>Specifies whether typed text is sent to the window under the <glossary tag="mouse pointer">mouse pointer</glossary> or to the frontmost window.</summary>
  <examples>
    <example>set the pointerFocus to true</example>
  </examples>
  <description>
    <p>Use the <b>pointerFocus</b> <glossary tag="property">property</glossary> to determine how the <glossary tag="active window">active window</glossary> is determined.</p><p/><p><b>Value:</b></p><p>The <b>pointerFocus</b> is true or false.</p><p/><p>By default, the <b>pointerFocus</b> <glossary tag="property">property</glossary> is set to true on <glossary tag="Mac OS">Mac OS</glossary>, <glossary tag="OS X">OS X</glossary>, and <glossary tag="Windows">Windows systems</glossary>, and to false on <glossary tag="Unix">Unix systems</glossary> that ship with <glossary tag="Motif">Motif</glossary>.</p><p/><p><b>Comments:</b></p><p>On Unix systems, if the <b>pointerFocus</b> <glossary tag="property">property</glossary> is false, clicking inside a window makes it the <glossary tag="active window">active window</glossary>. This is the recommended setup.</p><p/><p>If the <b>pointerFocus</b> <glossary tag="property">property</glossary> is true, moving the <glossary tag="mouse pointer">mouse pointer</glossary> into a window makes it the <glossary tag="active window">active window</glossary>. Set the <b>pointerFocus</b> to true to work around problems in some <glossary tag="Unix">Unix</glossary> window managers (specifically, "olwm" and "fvwm") that prevent <glossary tag="explicit focus">active-focus</glossary> applications such as LiveCode from operating correctly.</p><p/><p>If the application is started from a Unix command line, this property can be set to true on startup by using the<code> -pointerfocus </code>option.</p><p/><p><code/><img src="202652"/> <b>Cross-platform note:</b><code/> On <glossary tag="Mac OS">Mac OS</glossary>, <glossary tag="OS X">OS X</glossary>, and <glossary tag="Windows">Windows systems</glossary>, setting the <b>pointerFocus</b> <glossary tag="property">property</glossary> to false changes window activation in minor ways which are not particularly useful, and has no other effect.</p>
  </description>
</doc>