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