devdocs/elisp/pointer-shape.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

 <h3 class="section">Pointer Shape</h3>   <p>You can specify the mouse pointer style for particular text or images using the <code>pointer</code> text property, and for images with the <code>:pointer</code> and <code>:map</code> image properties. The values you can use in these properties are in the table below. The actual shapes may vary between systems; the descriptions are examples. </p> <dl compact> <dt><code>text</code></dt> <dt><code>nil</code></dt> <dd>
<p>The usual mouse pointer style used over text (an “I”-like shape). </p> </dd> <dt><code>arrow</code></dt> <dt><code>vdrag</code></dt> <dt><code>modeline</code></dt> <dd>
<p>An arrow that points north-west. </p> </dd> <dt><code>hand</code></dt> <dd>
<p>A hand that points upwards. </p> </dd> <dt><code>hdrag</code></dt> <dd>
<p>A right-left arrow. </p> </dd> <dt><code>nhdrag</code></dt> <dd>
<p>An up-down arrow. </p> </dd> <dt><code>hourglass</code></dt> <dd><p>A rotating ring. </p></dd> </dl> <p>Over void parts of the window (parts that do not correspond to any of the buffer contents), the mouse pointer usually uses the <code>arrow</code> style, but you can specify a different style (one of those above) by setting <code>void-text-area-pointer</code>. </p> <dl> <dt id="void-text-area-pointer">User Option: <strong>void-text-area-pointer</strong>
</dt> <dd><p>This variable specifies the mouse pointer style for void text areas. These include the areas after the end of a line or below the last line in the buffer. The default is to use the <code>arrow</code> (non-text) pointer style. </p></dd>
</dl> <p>When using X, you can specify what the <code>text</code> pointer style really looks like by setting the variable <code>x-pointer-shape</code>. </p> <dl> <dt id="x-pointer-shape">Variable: <strong>x-pointer-shape</strong>
</dt> <dd><p>This variable specifies the pointer shape to use ordinarily in the Emacs frame, for the <code>text</code> pointer style. </p></dd>
</dl> <dl> <dt id="x-sensitive-text-pointer-shape">Variable: <strong>x-sensitive-text-pointer-shape</strong>
</dt> <dd><p>This variable specifies the pointer shape to use when the mouse is over mouse-sensitive text. </p></dd>
</dl> <p>These variables affect newly created frames. They do not normally affect existing frames; however, if you set the mouse color of a frame, that also installs the current value of those two variables. See <a href="font-and-color-parameters">Font and Color Parameters</a>. </p> <p>The values you can use, to specify either of these pointer shapes, are defined in the file <samp>lisp/term/x-win.el</samp>. Use <kbd>M-x apropos <span class="key">RET</span> x-pointer <span class="key">RET</span></kbd> to see a list of them. </p><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/Pointer-Shape.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Pointer-Shape.html</a>
  </p>
</div>