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

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

If the Pango 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 Pango layout is ellipsized as a whole depends on the set height of the Pango layout. See the pango:layout-height function for details.

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

See also

#2025-2-15