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/display-property.html | |
new repository
Diffstat (limited to 'devdocs/elisp/display-property.html')
| -rw-r--r-- | devdocs/elisp/display-property.html | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/devdocs/elisp/display-property.html b/devdocs/elisp/display-property.html new file mode 100644 index 00000000..fdde4e72 --- /dev/null +++ b/devdocs/elisp/display-property.html @@ -0,0 +1,31 @@ + <h3 class="section">The display Property</h3> <p>The <code>display</code> text property (or overlay property) is used to insert images into text, and to control other aspects of how text displays. The value of the <code>display</code> property should be a display specification, or a list or vector containing several display specifications. Display specifications in the same <code>display</code> property value generally apply in parallel to the text they cover. </p> <p>If several sources (overlays and/or a text property) specify values for the <code>display</code> property, only one of the values takes effect, following the rules of <code>get-char-property</code>. See <a href="examining-properties">Examining Properties</a>. </p> <p>Some of the display specifications allow inclusion of Lisp forms, which are evaluated at display time. This could be unsafe in certain situations, e.g., when the display specification was generated by some external program/agent. Wrapping a display specification in a list that begins with the special symbol <code>disable-eval</code>, as in <code><span class="nolinebreak">(disable-eval</span> <var>spec</var>)</code>, will disable evaluation of any Lisp in <var>spec</var>, while still supporting all the other display property features. </p> <p>The rest of this section describes several kinds of display specifications and what they mean. </p> <table class="menu" border="0" cellspacing="0"> <tr> +<td align="left" valign="top">• <a href="replacing-specs" accesskey="1">Replacing Specs</a> +</td> +<td> </td> +<td align="left" valign="top">Display specs that replace the text. </td> +</tr> <tr> +<td align="left" valign="top">• <a href="specified-space" accesskey="2">Specified Space</a> +</td> +<td> </td> +<td align="left" valign="top">Displaying one space with a specified width. </td> +</tr> <tr> +<td align="left" valign="top">• <a href="pixel-specification" accesskey="3">Pixel Specification</a> +</td> +<td> </td> +<td align="left" valign="top">Specifying space width or height in pixels. </td> +</tr> <tr> +<td align="left" valign="top">• <a href="other-display-specs" accesskey="4">Other Display Specs</a> +</td> +<td> </td> +<td align="left" valign="top">Displaying an image; adjusting the height, spacing, and other properties of text. </td> +</tr> <tr> +<td align="left" valign="top">• <a href="display-margins" accesskey="5">Display Margins</a> +</td> +<td> </td> +<td align="left" valign="top">Displaying text or images to the side of the main text. </td> +</tr> </table><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/Display-Property.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Display-Property.html</a> + </p> +</div> |
