Package: pango

Function pango-layout-ellipsize

Lambda List

pango-layout-ellipsize (layout)

Syntax

(pango-layout-ellipsize layout) => ellipsize
(setf (pango-layout-ellipsize layout) ellipsize)

Arguments

layout -- a pango-layout object
ellipsize -- a value of the pango-ellipsize-mode enumeration

Details

Accessor of the ellipsization mode for the layout.

The function pango-layout-ellispze gets the type of ellipsization being performed for the layout. The function (setf pango-layout-ellipsize sets the type of ellipsization being performed for the layout. Depending on the ellipsization mode ellipsize text is removed from the start, middle, or end of text so they fit within the width and height of layout set with the functions pango-layout-width and pango-layout-height.

If the layout contains characters such as newlines that force it to be layed out in multiple paragraphs, then whether each paragraph is ellipsized separately or the entire layout is ellipsized as a whole depends on the set height of the layout. See the function pango-layout-height for details.

Use the function pango-layout-is-ellipsized to query whether any paragraphs were actually ellipsized.
 

See also

2021-1-14