<doc>
  <legacy_id>1680</legacy_id>
  <name>mouseMove</name>
  <type>message</type>
  <syntax>
    <example>mouseMove <i>newMouseH</i>,<i>newMouseV</i></example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>User Interaction</category>
  </classification>
  <references>
    <command tag="grab">grab Command</command>
    <function tag="mouseCharChunk">mouseCharChunk Function</function>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Sent when the user moves the mouse.</summary>
  <examples>
    <example>on mouseMove <code><i>-- highlight grouped text</i></code></p><p>  if the mouseChunk is not empty and \</p><p>     "link" is among the items of the textStyle of the mouseChunk</p><p>  then set the backgroundColor of the mouseChunk to "yellow"</p><p>end mouseMove</example>
  </examples>
  <description>
    <p>Handle the <b>mouseMove</b> <keyword tag="message box">message</keyword> if you want to perform some action (such as updating a <keyword tag="field">field</keyword>) when the user moves the mouse, or if you want to keep continuous track of the <glossary tag="mouse pointer">mouse pointer's</glossary> position.</p><p/><p><b>Parameters:</b></p><p>The <i>newMouseH</i> is the horizontal distance in <property tag="pixels">pixels</property> from the left edge of the stack to the <glossary tag="mouse pointer">mouse pointer's</glossary> current location.</p><p/><p>The <i>newMouseV</i> is the vertical distance in <property tag="pixels">pixels</property> from the top edge of the stack to the <glossary tag="mouse pointer">mouse pointer's</glossary> current location.</p><p/><p><b>Comments:</b></p><p>The <b>mouseMove</b> <keyword tag="message box">message</keyword> is sent to the <keyword tag="control">control</keyword> the <glossary tag="mouse pointer">mouse pointer</glossary> is over, or to the <keyword tag="card">card</keyword> if no <keyword tag="control">control</keyword> is under the <glossary tag="mouse pointer">mouse pointer</glossary>. The <glossary tag="parameter">parameters</glossary> sent with the <b>mouseMove</b> <keyword tag="message box">message</keyword> describe the <glossary tag="mouse pointer">mouse pointer's</glossary> current location.</p><p/><p>If the mouse button is down, the <b>mouseMove</b> <keyword tag="message box">message</keyword> continues to be sent to the <glossary tag="object">object</glossary> that was clicked, even if the <glossary tag="mouse pointer">mouse pointer</glossary> moves outside that <glossary tag="object">object</glossary>. However, if the <glossary tag="mouse button">mouse button</glossary> was down at the time the <keyword tag="pointer">pointer</keyword> entered the <keyword tag="control">control</keyword>, no <message tag="mouseMove">mouseMove</message> <glossary tag="message">messages</glossary> are sent until the <glossary tag="mouse button">mouse button</glossary> is released while the <keyword tag="pointer">pointer</keyword> is still in the <keyword tag="control">control</keyword>.</p><p/>
  </description>
</doc>