<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkCellRendererText">
<refmeta>
<refentrytitle role="top_of_page" id="GtkCellRendererText.top_of_page">GtkCellRendererText</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkCellRendererText</refname>
<refpurpose>Renders text in a cell</refpurpose>
</refnamediv>

<refsect1 id="GtkCellRendererText.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-renderer-text-new">gtk_cell_renderer_text_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-renderer-text-set-fixed-height-from-font">gtk_cell_renderer_text_set_fixed_height_from_font</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellRendererText.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--align-set">align-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoAlignment"><type>PangoAlignment</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--alignment">alignment</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoAttrList"><type>PangoAttrList</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--attributes">attributes</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--background">background</link></entry><entry role="property_flags">Write</entry></row>
<row><entry role="property_type"><link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--background-rgba">background-rgba</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--background-set">background-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--editable">editable</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--editable-set">editable-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoEllipsizeMode"><type>PangoEllipsizeMode</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--ellipsize">ellipsize</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--ellipsize-set">ellipsize-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--family">family</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--family-set">family-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--font">font</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--font-desc">font-desc</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--foreground">foreground</link></entry><entry role="property_flags">Write</entry></row>
<row><entry role="property_type"><link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--foreground-rgba">foreground-rgba</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--foreground-set">foreground-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--language">language</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--language-set">language-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--markup">markup</link></entry><entry role="property_flags">Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--max-width-chars">max-width-chars</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--placeholder-text">placeholder-text</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--rise">rise</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--rise-set">rise-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--scale">scale</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--scale-set">scale-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--single-paragraph-mode">single-paragraph-mode</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--size">size</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--size-points">size-points</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--size-set">size-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoStretch"><type>PangoStretch</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--stretch">stretch</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--stretch-set">stretch-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--strikethrough">strikethrough</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--strikethrough-set">strikethrough-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoStyle"><type>PangoStyle</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--style">style</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--style-set">style-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellRendererText--text">text</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoUnderline"><type>PangoUnderline</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--underline">underline</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--underline-set">underline-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoVariant"><type>PangoVariant</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--variant">variant</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--variant-set">variant-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--weight">weight</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--weight-set">weight-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--width-chars">width-chars</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoWrapMode"><type>PangoWrapMode</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--wrap-mode">wrap-mode</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkCellRendererText--wrap-width">wrap-width</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellRendererText.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkCellRendererText-edited">edited</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellRendererText.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GtkCellRendererText-struct">GtkCellRendererText</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellRendererText.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkCellRenderer">GtkCellRenderer</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkCellRendererText
                <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkCellRendererAccel">GtkCellRendererAccel</link>
                <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkCellRendererCombo">GtkCellRendererCombo</link>
                <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkCellRendererSpin">GtkCellRendererSpin</link>
</screen>
</refsect1>

<refsect1 id="GtkCellRendererText.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkCellRendererText.description" role="desc">
<title role="desc.title">Description</title>
<para>A <link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link> renders a given text in its cell, using the font, color and
style information provided by its properties. The text will be ellipsized if it is
too long and the <link linkend="GtkCellRendererText--ellipsize"><type>“ellipsize”</type></link> property allows it.</para>
<para>If the <link linkend="GtkCellRenderer--mode"><type>“mode”</type></link> is <link linkend="GTK-CELL-RENDERER-MODE-EDITABLE:CAPS"><literal>GTK_CELL_RENDERER_MODE_EDITABLE</literal></link>,
the <link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link> allows to edit its text using an entry.</para>

</refsect1>
<refsect1 id="GtkCellRendererText.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-cell-renderer-text-new" role="function">
<title>gtk_cell_renderer_text_new&#160;()</title>
<indexterm zone="gtk-cell-renderer-text-new"><primary>gtk_cell_renderer_text_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
gtk_cell_renderer_text_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new <link linkend="GtkCellRendererText"><type>GtkCellRendererText</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>
<refsect3 id="gtk-cell-renderer-text-new.returns" role="returns">
<title>Returns</title>
<para> the new cell renderer</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-renderer-text-set-fixed-height-from-font" role="function">
<title>gtk_cell_renderer_text_set_fixed_height_from_font&#160;()</title>
<indexterm zone="gtk-cell-renderer-text-set-fixed-height-from-font"><primary>gtk_cell_renderer_text_set_fixed_height_from_font</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_renderer_text_set_fixed_height_from_font
                               (<parameter><link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link> *renderer</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> number_of_rows</parameter>);</programlisting>
<para>Sets the height of a renderer to explicitly be determined by the “font” and
“y_pad” property set on it.  Further changes in these properties do not
affect the height, so they must be accompanied by a subsequent call to this
function.  Using this function is unflexible, and should really only be used
if calculating the size of a cell is too slow (ie, a massive number of cells
displayed).  If <parameter>number_of_rows</parameter>
 is -1, then the fixed height is unset, and
the height is determined by the properties again.</para>
<refsect3 id="gtk-cell-renderer-text-set-fixed-height-from-font.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>number_of_rows</para></entry>
<entry role="parameter_description"><para>Number of rows of text each cell renderer is allocated, or -1</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkCellRendererText.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkCellRendererText-struct" role="struct">
<title>struct GtkCellRendererText</title>
<indexterm zone="GtkCellRendererText-struct"><primary>GtkCellRendererText</primary></indexterm>
<programlisting language="C">struct GtkCellRendererText;</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkCellRendererText.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkCellRendererText--align-set" role="property"><title>The <literal>“align-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--align-set"><primary>GtkCellRendererText:align-set</primary></indexterm>
<programlisting>  “align-set”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the alignment mode.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--alignment" role="property"><title>The <literal>“alignment”</literal> property</title>
<indexterm zone="GtkCellRendererText--alignment"><primary>GtkCellRendererText:alignment</primary></indexterm>
<programlisting>  “alignment”                <link linkend="PangoAlignment"><type>PangoAlignment</type></link></programlisting>
<para>Specifies how to align the lines of text with respect to each other.</para>
<para>Note that this property describes how to align the lines of text in
case there are several of them. The "xalign" property of <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>,
on the other hand, sets the horizontal alignment of the whole text.</para>
<para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_ALIGN_LEFT</para>
</refsect2>
<refsect2 id="GtkCellRendererText--attributes" role="property"><title>The <literal>“attributes”</literal> property</title>
<indexterm zone="GtkCellRendererText--attributes"><primary>GtkCellRendererText:attributes</primary></indexterm>
<programlisting>  “attributes”               <link linkend="PangoAttrList"><type>PangoAttrList</type></link>&#160;*</programlisting>
<para>A list of style attributes to apply to the text of the renderer.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkCellRendererText--background" role="property"><title>The <literal>“background”</literal> property</title>
<indexterm zone="GtkCellRendererText--background"><primary>GtkCellRendererText:background</primary></indexterm>
<programlisting>  “background”               <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Background color as a string.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--background-rgba" role="property"><title>The <literal>“background-rgba”</literal> property</title>
<indexterm zone="GtkCellRendererText--background-rgba"><primary>GtkCellRendererText:background-rgba</primary></indexterm>
<programlisting>  “background-rgba”          <link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</programlisting>
<para>Background color as a <link linkend="GdkRGBA"><type>GdkRGBA</type></link></para>
<para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkCellRendererText--background-set" role="property"><title>The <literal>“background-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--background-set"><primary>GtkCellRendererText:background-set</primary></indexterm>
<programlisting>  “background-set”           <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the background color.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--editable" role="property"><title>The <literal>“editable”</literal> property</title>
<indexterm zone="GtkCellRendererText--editable"><primary>GtkCellRendererText:editable</primary></indexterm>
<programlisting>  “editable”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the text can be modified by the user.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--editable-set" role="property"><title>The <literal>“editable-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--editable-set"><primary>GtkCellRendererText:editable-set</primary></indexterm>
<programlisting>  “editable-set”             <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects text editability.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--ellipsize" role="property"><title>The <literal>“ellipsize”</literal> property</title>
<indexterm zone="GtkCellRendererText--ellipsize"><primary>GtkCellRendererText:ellipsize</primary></indexterm>
<programlisting>  “ellipsize”                <link linkend="PangoEllipsizeMode"><type>PangoEllipsizeMode</type></link></programlisting>
<para>Specifies the preferred place to ellipsize the string, if the cell renderer
does not have enough room to display the entire string. Setting it to
<link linkend="PANGO-ELLIPSIZE-NONE:CAPS"><literal>PANGO_ELLIPSIZE_NONE</literal></link> turns off ellipsizing. See the wrap-width property
for another way of making the text fit into a given width.</para>
<para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_ELLIPSIZE_NONE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--ellipsize-set" role="property"><title>The <literal>“ellipsize-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--ellipsize-set"><primary>GtkCellRendererText:ellipsize-set</primary></indexterm>
<programlisting>  “ellipsize-set”            <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the ellipsize mode.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--family" role="property"><title>The <literal>“family”</literal> property</title>
<indexterm zone="GtkCellRendererText--family"><primary>GtkCellRendererText:family</primary></indexterm>
<programlisting>  “family”                   <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Name of the font family, e.g. Sans, Helvetica, Times, Monospace.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--family-set" role="property"><title>The <literal>“family-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--family-set"><primary>GtkCellRendererText:family-set</primary></indexterm>
<programlisting>  “family-set”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font family.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--font" role="property"><title>The <literal>“font”</literal> property</title>
<indexterm zone="GtkCellRendererText--font"><primary>GtkCellRendererText:font</primary></indexterm>
<programlisting>  “font”                     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Font description as a string, e.g. “Sans Italic 12”.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--font-desc" role="property"><title>The <literal>“font-desc”</literal> property</title>
<indexterm zone="GtkCellRendererText--font-desc"><primary>GtkCellRendererText:font-desc</primary></indexterm>
<programlisting>  “font-desc”                <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>&#160;*</programlisting>
<para>Font description as a PangoFontDescription struct.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkCellRendererText--foreground" role="property"><title>The <literal>“foreground”</literal> property</title>
<indexterm zone="GtkCellRendererText--foreground"><primary>GtkCellRendererText:foreground</primary></indexterm>
<programlisting>  “foreground”               <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Foreground color as a string.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--foreground-rgba" role="property"><title>The <literal>“foreground-rgba”</literal> property</title>
<indexterm zone="GtkCellRendererText--foreground-rgba"><primary>GtkCellRendererText:foreground-rgba</primary></indexterm>
<programlisting>  “foreground-rgba”          <link linkend="GdkRGBA"><type>GdkRGBA</type></link>&#160;*</programlisting>
<para>Foreground color as a <link linkend="GdkRGBA"><type>GdkRGBA</type></link></para>
<para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkCellRendererText--foreground-set" role="property"><title>The <literal>“foreground-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--foreground-set"><primary>GtkCellRendererText:foreground-set</primary></indexterm>
<programlisting>  “foreground-set”           <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the foreground color.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--language" role="property"><title>The <literal>“language”</literal> property</title>
<indexterm zone="GtkCellRendererText--language"><primary>GtkCellRendererText:language</primary></indexterm>
<programlisting>  “language”                 <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The language this text is in, as an ISO code. Pango can use this as a hint when rendering the text. If you don’t understand this parameter, you probably don’t need it.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--language-set" role="property"><title>The <literal>“language-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--language-set"><primary>GtkCellRendererText:language-set</primary></indexterm>
<programlisting>  “language-set”             <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the language the text is rendered as.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--markup" role="property"><title>The <literal>“markup”</literal> property</title>
<indexterm zone="GtkCellRendererText--markup"><primary>GtkCellRendererText:markup</primary></indexterm>
<programlisting>  “markup”                   <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Marked up text to render.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--max-width-chars" role="property"><title>The <literal>“max-width-chars”</literal> property</title>
<indexterm zone="GtkCellRendererText--max-width-chars"><primary>GtkCellRendererText:max-width-chars</primary></indexterm>
<programlisting>  “max-width-chars”          <link linkend="gint"><type>gint</type></link></programlisting>
<para>The desired maximum width of the cell, in characters. If this property
is set to -1, the width will be calculated automatically.</para>
<para>For cell renderers that ellipsize or wrap text; this property
controls the maximum reported width of the cell. The
cell should not receive any greater allocation unless it is
set to expand in its <link linkend="GtkCellLayout"><type>GtkCellLayout</type></link> and all of the cell's siblings
have received their natural width.</para>
<para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkCellRendererText--placeholder-text" role="property"><title>The <literal>“placeholder-text”</literal> property</title>
<indexterm zone="GtkCellRendererText--placeholder-text"><primary>GtkCellRendererText:placeholder-text</primary></indexterm>
<programlisting>  “placeholder-text”         <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The text that will be displayed in the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> if
<link linkend="GtkCellRendererText--editable"><type>“editable”</type></link> is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> and the cell is empty.</para>
<para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--rise" role="property"><title>The <literal>“rise”</literal> property</title>
<indexterm zone="GtkCellRendererText--rise"><primary>GtkCellRendererText:rise</primary></indexterm>
<programlisting>  “rise”                     <link linkend="gint"><type>gint</type></link></programlisting>
<para>Offset of text above the baseline (below the baseline if rise is negative).</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -2147483647</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkCellRendererText--rise-set" role="property"><title>The <literal>“rise-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--rise-set"><primary>GtkCellRendererText:rise-set</primary></indexterm>
<programlisting>  “rise-set”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the rise.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--scale" role="property"><title>The <literal>“scale”</literal> property</title>
<indexterm zone="GtkCellRendererText--scale"><primary>GtkCellRendererText:scale</primary></indexterm>
<programlisting>  “scale”                    <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>Font scaling factor.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 1</para>
</refsect2>
<refsect2 id="GtkCellRendererText--scale-set" role="property"><title>The <literal>“scale-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--scale-set"><primary>GtkCellRendererText:scale-set</primary></indexterm>
<programlisting>  “scale-set”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag scales the font size by a factor.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--single-paragraph-mode" role="property"><title>The <literal>“single-paragraph-mode”</literal> property</title>
<indexterm zone="GtkCellRendererText--single-paragraph-mode"><primary>GtkCellRendererText:single-paragraph-mode</primary></indexterm>
<programlisting>  “single-paragraph-mode”    <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to keep all text in a single paragraph.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--size" role="property"><title>The <literal>“size”</literal> property</title>
<indexterm zone="GtkCellRendererText--size"><primary>GtkCellRendererText:size</primary></indexterm>
<programlisting>  “size”                     <link linkend="gint"><type>gint</type></link></programlisting>
<para>Font size.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkCellRendererText--size-points" role="property"><title>The <literal>“size-points”</literal> property</title>
<indexterm zone="GtkCellRendererText--size-points"><primary>GtkCellRendererText:size-points</primary></indexterm>
<programlisting>  “size-points”              <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>Font size in points.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkCellRendererText--size-set" role="property"><title>The <literal>“size-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--size-set"><primary>GtkCellRendererText:size-set</primary></indexterm>
<programlisting>  “size-set”                 <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font size.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--stretch" role="property"><title>The <literal>“stretch”</literal> property</title>
<indexterm zone="GtkCellRendererText--stretch"><primary>GtkCellRendererText:stretch</primary></indexterm>
<programlisting>  “stretch”                  <link linkend="PangoStretch"><type>PangoStretch</type></link></programlisting>
<para>Font stretch.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_STRETCH_NORMAL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--stretch-set" role="property"><title>The <literal>“stretch-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--stretch-set"><primary>GtkCellRendererText:stretch-set</primary></indexterm>
<programlisting>  “stretch-set”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font stretch.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--strikethrough" role="property"><title>The <literal>“strikethrough”</literal> property</title>
<indexterm zone="GtkCellRendererText--strikethrough"><primary>GtkCellRendererText:strikethrough</primary></indexterm>
<programlisting>  “strikethrough”            <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to strike through the text.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--strikethrough-set" role="property"><title>The <literal>“strikethrough-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--strikethrough-set"><primary>GtkCellRendererText:strikethrough-set</primary></indexterm>
<programlisting>  “strikethrough-set”        <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects strikethrough.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--style" role="property"><title>The <literal>“style”</literal> property</title>
<indexterm zone="GtkCellRendererText--style"><primary>GtkCellRendererText:style</primary></indexterm>
<programlisting>  “style”                    <link linkend="PangoStyle"><type>PangoStyle</type></link></programlisting>
<para>Font style.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_STYLE_NORMAL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--style-set" role="property"><title>The <literal>“style-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--style-set"><primary>GtkCellRendererText:style-set</primary></indexterm>
<programlisting>  “style-set”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font style.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--text" role="property"><title>The <literal>“text”</literal> property</title>
<indexterm zone="GtkCellRendererText--text"><primary>GtkCellRendererText:text</primary></indexterm>
<programlisting>  “text”                     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Text to render.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--underline" role="property"><title>The <literal>“underline”</literal> property</title>
<indexterm zone="GtkCellRendererText--underline"><primary>GtkCellRendererText:underline</primary></indexterm>
<programlisting>  “underline”                <link linkend="PangoUnderline"><type>PangoUnderline</type></link></programlisting>
<para>Style of underline for this text.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_UNDERLINE_NONE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--underline-set" role="property"><title>The <literal>“underline-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--underline-set"><primary>GtkCellRendererText:underline-set</primary></indexterm>
<programlisting>  “underline-set”            <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects underlining.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--variant" role="property"><title>The <literal>“variant”</literal> property</title>
<indexterm zone="GtkCellRendererText--variant"><primary>GtkCellRendererText:variant</primary></indexterm>
<programlisting>  “variant”                  <link linkend="PangoVariant"><type>PangoVariant</type></link></programlisting>
<para>Font variant.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_VARIANT_NORMAL</para>
</refsect2>
<refsect2 id="GtkCellRendererText--variant-set" role="property"><title>The <literal>“variant-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--variant-set"><primary>GtkCellRendererText:variant-set</primary></indexterm>
<programlisting>  “variant-set”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font variant.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--weight" role="property"><title>The <literal>“weight”</literal> property</title>
<indexterm zone="GtkCellRendererText--weight"><primary>GtkCellRendererText:weight</primary></indexterm>
<programlisting>  “weight”                   <link linkend="gint"><type>gint</type></link></programlisting>
<para>Font weight.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 400</para>
</refsect2>
<refsect2 id="GtkCellRendererText--weight-set" role="property"><title>The <literal>“weight-set”</literal> property</title>
<indexterm zone="GtkCellRendererText--weight-set"><primary>GtkCellRendererText:weight-set</primary></indexterm>
<programlisting>  “weight-set”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this tag affects the font weight.</para><para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellRendererText--width-chars" role="property"><title>The <literal>“width-chars”</literal> property</title>
<indexterm zone="GtkCellRendererText--width-chars"><primary>GtkCellRendererText:width-chars</primary></indexterm>
<programlisting>  “width-chars”              <link linkend="gint"><type>gint</type></link></programlisting>
<para>The desired width of the cell, in characters. If this property is set to
-1, the width will be calculated automatically, otherwise the cell will
request either 3 characters or the property value, whichever is greater.</para>
<para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkCellRendererText--wrap-mode" role="property"><title>The <literal>“wrap-mode”</literal> property</title>
<indexterm zone="GtkCellRendererText--wrap-mode"><primary>GtkCellRendererText:wrap-mode</primary></indexterm>
<programlisting>  “wrap-mode”                <link linkend="PangoWrapMode"><type>PangoWrapMode</type></link></programlisting>
<para>Specifies how to break the string into multiple lines, if the cell
renderer does not have enough room to display the entire string.
This property has no effect unless the wrap-width property is set.</para>
<para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Default value: PANGO_WRAP_CHAR</para>
</refsect2>
<refsect2 id="GtkCellRendererText--wrap-width" role="property"><title>The <literal>“wrap-width”</literal> property</title>
<indexterm zone="GtkCellRendererText--wrap-width"><primary>GtkCellRendererText:wrap-width</primary></indexterm>
<programlisting>  “wrap-width”               <link linkend="gint"><type>gint</type></link></programlisting>
<para>Specifies the minimum width at which the text is wrapped. The wrap-mode property can
be used to influence at what character positions the line breaks can be placed.
Setting wrap-width to -1 turns wrapping off.</para>
<para>Owner: GtkCellRendererText</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>

</refsect1>
<refsect1 id="GtkCellRendererText.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkCellRendererText-edited" role="signal"><title>The <literal>“edited”</literal> signal</title>
<indexterm zone="GtkCellRendererText-edited"><primary>GtkCellRendererText::edited</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link> *renderer,
               <link linkend="gchar"><type>gchar</type></link>               *path,
               <link linkend="gchar"><type>gchar</type></link>               *new_text,
               <link linkend="gpointer"><type>gpointer</type></link>             user_data)</programlisting>
<para>This signal is emitted after <parameter>renderer</parameter>
 has been edited.</para>
<para>It is the responsibility of the application to update the model
and store <parameter>new_text</parameter>
 at the position indicated by <parameter>path</parameter>
.</para>
<refsect3 id="GtkCellRendererText-edited.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>the path identifying the edited cell</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>new_text</para></entry>
<entry role="parameter_description"><para>the new text</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2>
</refsect1>

</refentry>
