GNU Info

(elisp)Specified Space

---

Next: Other Display Specs Up: Display Property

---

Enter node , (file) or (file)node

Specified Spaces
----------------

   To display a space of specified width and/or height, use a display
specification of the form `(space . PROPS)', where PROPS is a property
list (a list of alternating properties and values).  You can put this
property on one or more consecutive characters; a space of the
specified height and width is displayed in place of _all_ of those
characters.  These are the properties you can use to specify the weight
of the space:

`:width WIDTH'
     Specifies that the space width should be WIDTH times the normal
     character width.  WIDTH can be an integer or floating point number.

`:relative-width FACTOR'
     Specifies that the width of the stretch should be computed from the
     first character in the group of consecutive characters that have
     the same `display' property.  The space width is the width of that
     character, multiplied by FACTOR.

`:align-to HPOS'
     Specifies that the space should be wide enough to reach HPOS.  The
     value HPOS is measured in units of the normal character width.  It
     may be an interer or a floating point number.

   Exactly one of the above properties should be used.  You can also
specify the height of the space, with other properties:

`:height HEIGHT'
     Specifies the height of the space, as HEIGHT, measured in terms of
     the normal line height.

`:relative-height FACTOR'
     Specifies the height of the space, multiplying the ordinary height
     of the text having this display specification by FACTOR.

`:ascent ASCENT'
     Specifies that ASCENT percent of the height of the space should be
     considered as the ascent of the space--that is, the part above the
     baseline.  The value of ASCENT must be a non-negative number no
     greater than 100.

   You should not use both `:height' and `:relative-height' together.