diff options
| author | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
| commit | 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 (patch) | |
| tree | f1190704f78f04a2b0b4c977d20fe96a828377f1 /devdocs/elisp/pointer-shape.html | |
new repository
Diffstat (limited to 'devdocs/elisp/pointer-shape.html')
| -rw-r--r-- | devdocs/elisp/pointer-shape.html | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/devdocs/elisp/pointer-shape.html b/devdocs/elisp/pointer-shape.html new file mode 100644 index 00000000..6c0428b7 --- /dev/null +++ b/devdocs/elisp/pointer-shape.html @@ -0,0 +1,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 © 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> |
