Mercurial > hg > xemacs-beta
comparison man/lispref/extents.texi @ 211:78478c60bfcd r20-4b4
Import from CVS: tag r20-4b4
author | cvs |
---|---|
date | Mon, 13 Aug 2007 10:05:51 +0200 |
parents | e45d5e7c476e |
children | 70ad99077275 |
comparison
equal
deleted
inserted
replaced
210:49f55ca3ba57 | 211:78478c60bfcd |
---|---|
83 key and mouse strokes within the extent's text, and the @code{mouse-face} | 83 key and mouse strokes within the extent's text, and the @code{mouse-face} |
84 property controls whether the extent is highlighted when the mouse moves | 84 property controls whether the extent is highlighted when the mouse moves |
85 over it. @xref{Extents and Events}. | 85 over it. @xref{Extents and Events}. |
86 | 86 |
87 An extent can optionally have a @dfn{begin-glyph} or @dfn{end-glyph} | 87 An extent can optionally have a @dfn{begin-glyph} or @dfn{end-glyph} |
88 (but not both at one time) associated with it. A begin-glyph or | 88 associated with it. A begin-glyph or end-glyph is a pixmap or string |
89 end-glyph is a pixmap or string that will be displayed either at the | 89 that will be displayed either at the start or end of an extent or in the |
90 start or end of an extent or in the margin of the line that the start | 90 margin of the line that the start or end of the extent lies in, |
91 or end of the extent lies in, depending on the extent's layout policy. | 91 depending on the extent's layout policy. Begin-glyphs and end-glyphs |
92 Begin-glyphs and end-glyphs are used to implement annotations, and you | 92 are used to implement annotations, and you should use the annotation API |
93 should use the annotation API functions in preference to the | 93 functions in preference to the lower-level extent functions. For more |
94 lower-level extent functions. For more information, @xref{Annotations}. | 94 information, @xref{Annotations}. |
95 | 95 |
96 If an extent has its @code{detachable} property set, it will become | 96 If an extent has its @code{detachable} property set, it will become |
97 @dfn{detached} (i.e. no longer in the buffer) when all its text its | 97 @dfn{detached} (i.e. no longer in the buffer) when all its text its |
98 deleted. Otherwise, it will simply shrink down to zero-length and | 98 deleted. Otherwise, it will simply shrink down to zero-length and |
99 sit it the same place in the buffer. By default, the @code{detachable} | 99 sit it the same place in the buffer. By default, the @code{detachable} |
636 | 636 |
637 @defun extent-priority extent | 637 @defun extent-priority extent |
638 This function returns the @code{priority} property of @var{extent}. | 638 This function returns the @code{priority} property of @var{extent}. |
639 @end defun | 639 @end defun |
640 | 640 |
641 @defun extent-keymap extent | |
642 This function returns the @code{keymap} property of @var{extent}. | |
643 @end defun | |
644 | |
641 @defun extent-begin-glyph-layout extent | 645 @defun extent-begin-glyph-layout extent |
642 This function returns the @code{begin-glyph-layout} property of | 646 This function returns the @code{begin-glyph-layout} property of |
643 @var{extent}, i.e. the layout policy associated with the @var{extent}'s | 647 @var{extent}, i.e. the layout policy associated with the @var{extent}'s |
644 begin glyph. | 648 begin glyph. |
645 @end defun | 649 @end defun |