path: root/devdocs/elisp/motion-events.html

 <h4 class="subsection">Motion Events</h4>   <p>Emacs sometimes generates <em>mouse motion</em> events to describe motion of the mouse without any button activity. Mouse motion events are represented by lists that look like this: </p> <div class="example"> <pre class="example">(mouse-movement POSITION)
</pre>
</div> <p><var>position</var> is a mouse position list (see <a href="click-events">Click Events</a>), specifying the current position of the mouse cursor. As with the end-position of a drag event, this position list may represent a location outside the boundaries of the initially selected frame, in which case the list contains that frame in place of a window. </p> <p>The special form <code>track-mouse</code> enables generation of motion events within its body. Outside of <code>track-mouse</code> forms, Emacs does not generate events for mere motion of the mouse, and these events do not appear. See <a href="mouse-tracking">Mouse Tracking</a>. </p> <dl> <dt id="mouse-fine-grained-tracking">Variable: <strong>mouse-fine-grained-tracking</strong>
</dt> <dd><p>When non-<code>nil</code>, mouse motion events are generated even for very small movements. Otherwise, motion events are not generated as long as the mouse cursor remains pointing to the same glyph in the text. </p></dd>
</dl><div class="_attribution">
  <p class="_attribution-p">
    Copyright &copy; 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br>
    <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Motion-Events.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Motion-Events.html</a>
  </p>
</div>