## ExoEllipsizedLabel

ExoEllipsizedLabel — A widget that automatically ellipsizes text

## Synopsis

    #include <exo/exo.h>

                        ExoEllipsizedLabel;
    GtkWidget*          exo_ellipsized_label_new            (const gchar *text);
    PangoEllipsizeMode  exo_ellipsized_label_get_ellipsize  (ExoEllipsizedLabel *label);
    void                exo_ellipsized_label_set_ellipsize  (ExoEllipsizedLabel *label,
                                                             PangoEllipsizeMode ellipsize);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkMisc
                               +----GtkLabel
                                     +----ExoEllipsizedLabel

## Implemented Interfaces

ExoEllipsizedLabel implements AtkImplementorIface and GtkBuildable.

## Description

ExoEllipsizedLabel extends the standard GtkLabel class present in Gtk+ 2.4 with the ability to automatically ellipsize text with "...".

ExoEllipsizedLabel automatically detects if its running with Gtk+ 2.5 or above and uses the native ellipsizing support of Gtk+ 2.5 or above in that case. So its safe to use ExoEllipsizedLabel with every Gtk+ version above 2.4.

As of exo 0.3.1.8, ExoEllipsizedLabel is deprecated and should not be used in newly written code. Instead use GtkLabel directly, which supports the "ellipsize" property since GTK+ 2.6.

## Details

### ExoEllipsizedLabel

    typedef struct _ExoEllipsizedLabel ExoEllipsizedLabel;

### Warning

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

The ExoEllipsizedLabel struct contains only private fields and should not be directly accessed.

### exo_ellipsized_label_new ()

    GtkWidget*          exo_ellipsized_label_new            (const gchar *text);

### Warning

`exo_ellipsized_label_new` has been deprecated since version 0.3.1.8 and should not be used in newly-written code. Use GtkLabel instead.

Creates a new ExoEllipsizedLabel with the given text inside it. You can pass `NULL` to get an empty label widget.

`text` : | The text of the label.
Returns : | The new ExoEllipsizedLabel.

### exo_ellipsized_label_get_ellipsize ()

    PangoEllipsizeMode  exo_ellipsized_label_get_ellipsize  (ExoEllipsizedLabel *label);

### Warning

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

Returns the ellipsizing position of the `label`. See `exo_ellipsized_label_set_ellipsize()`.

`label` : | An ExoEllipsizedLabel.
Returns : | An PangoEllipsizeMode.

### exo_ellipsized_label_set_ellipsize ()

    void                exo_ellipsized_label_set_ellipsize  (ExoEllipsizedLabel *label,
                                                             PangoEllipsizeMode ellipsize);

### Warning

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

Sets the mode used to ellipsize (add an ellipsis: "...") to the text if there is not enough space to render the entire string.

`label` : | An ExoEllipsizedLabel.
`ellipsize` : | An PangoEllipsizeMode.

## See Also

GtkLabel, Exo Pango Extensions