<refentry id="ExoCellRendererEllipsizedText">
<refmeta>
<refentrytitle>ExoCellRendererEllipsizedText</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>EXO Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>ExoCellRendererEllipsizedText</refname><refpurpose>Renders text in a cell and optionally ellipsizes the text.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>

#include &lt;exo/exo.h&gt;


            <link linkend="ExoCellRendererEllipsizedText-struct">ExoCellRendererEllipsizedText</link>;
<link linkend="GtkCellRenderer">GtkCellRenderer</link>* <link linkend="exo-cell-renderer-ellipsized-text-new">exo_cell_renderer_ellipsized_text_new</link>
                                            (void);


</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----<link linkend="GtkObject">GtkObject</link>
         +----<link linkend="GtkCellRenderer">GtkCellRenderer</link>
               +----<link linkend="GtkCellRendererText">GtkCellRendererText</link>
                     +----ExoCellRendererEllipsizedText
</synopsis>

</refsect1>





<refsect1>
<title>Properties</title>
<synopsis>

  &quot;<link linkend="ExoCellRendererEllipsizedText--ellipsize">ellipsize</link>&quot;            <link linkend="ExoPangoEllipsizeMode">ExoPangoEllipsizeMode</link>  : Read / Write
  &quot;<link linkend="ExoCellRendererEllipsizedText--ellipsize-set">ellipsize-set</link>&quot;        <link linkend="gboolean">gboolean</link>              : Read / Write
</synopsis>
</refsect1>



<refsect1>
<title>Description</title>
<para>
The <link linkend="ExoCellRendererEllipsizedText"><type>ExoCellRendererEllipsizedText</type></link> renders a given text in its
cell, using the font, color and style information provided by
its properties (which are actually inherited from <link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link>).
The text will be ellipsized if its too long and the "ellipsize"
property allows it.
</para>
<para>
<link linkend="ExoCellRendererEllipsizedText"><type>ExoCellRendererEllipsizedText</type></link> is compatible with Gtk+ 2.5 and
above in that it automatically detects if <link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link>
has the "ellipsize" property and reuses the built-in functionality
if available. For Gtk+ 2.4, it uses the <link
linkend="exo-Extensions-to-Pango">Pango Extensions</link> to
ellipsize text properly.
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="ExoCellRendererEllipsizedText-struct"/>ExoCellRendererEllipsizedText</title>
<indexterm><primary>ExoCellRendererEllipsizedText</primary></indexterm><programlisting>typedef struct _ExoCellRendererEllipsizedText ExoCellRendererEllipsizedText;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="exo-cell-renderer-ellipsized-text-new"/>exo_cell_renderer_ellipsized_text_new ()</title>
<indexterm><primary>exo_cell_renderer_ellipsized_text_new</primary></indexterm><programlisting><link linkend="GtkCellRenderer">GtkCellRenderer</link>* exo_cell_renderer_ellipsized_text_new
                                            (void);</programlisting>
<para>
Creates a new <link linkend="ExoCellRendererEllipsizedText"><type>ExoCellRendererEllipsizedText</type></link>. Adjust how text is
drawn using object properties. Object properties can be set globally
(with <link linkend="g-object-set"><function>g_object_set()</function></link>). Also, with <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>, you can bind a
property to a value in a <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>. For example, you can bind the
"text" property on the cell renderer to a string value in the model,
thus rendering a different string in each row of the <link linkend="GtkTreeView"><type>GtkTreeView</type></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The new cell renderer.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1>
<title>Properties</title>
<refsect2><title><anchor id="ExoCellRendererEllipsizedText--ellipsize"/>The &quot;<literal>ellipsize</literal>&quot; property</title>
<programlisting>  &quot;ellipsize&quot;            <link linkend="ExoPangoEllipsizeMode">ExoPangoEllipsizeMode</link>  : Read / Write</programlisting>
<para>The preferred place to ellipsize the string, if the cell renderer does not have enough room to display the entire string, if at all.</para><para>Default value: EXO_PANGO_ELLIPSIZE_NONE</para>
</refsect2>
<refsect2><title><anchor id="ExoCellRendererEllipsizedText--ellipsize-set"/>The &quot;<literal>ellipsize-set</literal>&quot; property</title>
<programlisting>  &quot;ellipsize-set&quot;        <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether this tag affects the ellipsize mode.</para><para>Default value: FALSE</para>
</refsect2>

</refsect1>



<refsect1>
<title>See Also</title>
<para>
<ulink url="http://developer.gnome.org/doc/API/2.0/gtk/GtkCellRendererText.html"
type="http">GtkCellRendererText</ulink>, <link
linkend="exo-Extensions-to-Pango">Exo Pango Extensions</link>
</para>
</refsect1>

</refentry>
