Extensions to Pango

Extensions to Pango — Miscelleanous extensions to the Pango library

Synopsis


#include <exo/exo.h>

typedef             ExoPangoEllipsizeMode;
gboolean            exo_pango_layout_set_text_ellipsized
                                                        (PangoLayout *layout,
                                                         const gchar *string,
                                                         gint width,
                                                         PangoEllipsizeMode mode);

Description

This facility provides ellipsizing support functions for Pango 1.4 and below. If its build against Pango 1.6 or above, it uses the ellipsizing functionality provided by Pango, else its emulated in libexo.

It is deprecated as of version 0.3.1.8. Use the Pango 1.6 functions directly.

Details

ExoPangoEllipsizeMode

Warning

ExoPangoEllipsizeMode is deprecated and should not be used in newly-written code.

Use PangoEllipsizeMode instead.


exo_pango_layout_set_text_ellipsized ()

gboolean            exo_pango_layout_set_text_ellipsized
                                                        (PangoLayout *layout,
                                                         const gchar *string,
                                                         gint width,
                                                         PangoEllipsizeMode mode);

Warning

exo_pango_layout_set_text_ellipsized has been deprecated since version 0.3.1.8 and should not be used in newly-written code. Use pango_layout_set_ellipsize() instead.

Truncates a string if required to fit in width and sets it on the layout. Truncation involves removing characters from the start, middle or end respectively and replacing them with "...". Algorithm is a bit fuzzy, won't work 100%.

layout :

A PangoLayout.

string :

The string to ellipsize.

width :

The maximal width for the layout.

mode :

The ellipsize mode.

Returns :

TRUE if string had to be ellipsized to fit into width, else FALSE.

See Also

Pango Reference Manual, ExoEllipsizedLabel