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