## 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