<doc>
  <legacy_id>2185</legacy_id>
  <name>screenMouseLoc</name>
  <type>property</type>
  <syntax>
    <example>set the screenMouseLoc to <i>horizontal</i>,<i>vertical</i></example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>User Interaction</category>
  </classification>
  <references>
    <function tag="mouseV">mouseV Function</function>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
    <changed version="2.0"></changed>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies the position of the <glossary tag="mouse pointer">mouse pointer</glossary> relative to the screen.</summary>
  <examples>
    <example>put the localLoc(the screenMouseLoc) into localMouse</example>
    <example>set the screenMouseLoc to the topLeft of this stack</example>
  </examples>
  <description>
    <p>Use the <b>screenMouseLoc</b> <glossary tag="property">property</glossary> to find out where the <glossary tag="mouse pointer">mouse pointer</glossary> is, or to change the location of the <glossary tag="mouse pointer">mouse pointer</glossary>.</p><p/><p><b>Value:</b></p><p>The <b>screenMouseLoc</b> consists of two <glossary tag="integer">integers</glossary>, separated by a comma. It reports the position of the <glossary tag="mouse pointer">mouse pointer</glossary> in <href tag="glossary/Appearance/288.xml">absolute coordinates</href>--that is, relative to the top left of the main screen. (The <function tag="mouseLoc">mouseLoc</function> <control_st tag="function">function</control_st> is similar, but its coordinates are relative to the <property tag="defaultStack">defaultStack</property> window rather than the screen.)</p><p/><p>If you set this property, the mouse pointer is moved to the specified location on the screen.</p><p/><p><code/><img src="202653"/> <b>Important!</b><code/> Taking over the position of the <glossary tag="mouse pointer">mouse pointer</glossary> can disorient and confuse users, and <glossary tag="user interface">user-interface</glossary> standards warn against doing so for that reason. Consider setting the <b>screenMouseLoc</b> <glossary tag="property">property</glossary> only in unusual situations (such as for a kiosk application or game). In normal desktop applications, the user expects a consistent <glossary tag="user interface">user interface</glossary> without such surprises. You must use this power only for good.</p><p/><p><b>Changes:</b></p><p>Support for using the <b>screenMouseLoc</b> with <glossary tag="OS X">OS X systems</glossary> was added in version 2.0.</p>
  </description>
</doc>