|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/gtk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GtkCellRendererText</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="prev" href="GtkCellRendererSpin.html" title="GtkCellRendererSpin">
<link rel="next" href="GtkCellRendererToggle.html" title="GtkCellRendererToggle">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and
GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkCellRendererSpin.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="TreeWidgetObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkCellRendererToggle.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3229442" class="shortcut">Top</a>
 | 
<a href="#id3230409" class="shortcut">Description</a>
 | 
<a href="#id3229510" class="shortcut">Object Hierarchy</a>
 | 
<a href="#id3229581" class="shortcut">Properties</a>
 | 
<a href="#id3230343" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkCellRendererText"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id3229442"></a><span class="refentrytitle">GtkCellRendererText</span>
</h2>
<p>GtkCellRendererText — Renders text in a cell</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <gtk/gtk.h>
<a href="GtkCellRendererText.html#GtkCellRendererText-struct">GtkCellRendererText</a>;
<a href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>* <a href="GtkCellRendererText.html#gtk-cell-renderer-text-new">gtk_cell_renderer_text_new</a> (void);
void <a href="GtkCellRendererText.html#gtk-cell-renderer-text-set-fixed-height-from-font">gtk_cell_renderer_text_set_fixed_height_from_font</a>
(<a href="GtkCellRendererText.html" title="GtkCellRendererText">GtkCellRendererText</a> *renderer,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> number_of_rows);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3229510"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
+----<a href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>
+----GtkCellRendererText
+----<a href="GtkCellRendererAccel.html" title="GtkCellRendererAccel">GtkCellRendererAccel</a>
+----<a href="GtkCellRendererCombo.html" title="GtkCellRendererCombo">GtkCellRendererCombo</a>
+----<a href="GtkCellRendererSpin.html" title="GtkCellRendererSpin">GtkCellRendererSpin</a>
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3229581"></a><h2>Properties</h2>
<pre class="synopsis">
"<a href="GtkCellRendererText.html#GtkCellRendererText--alignment">alignment</a>" <a
href="../pango/pango-Layout-Objects.html#PangoAlignment"
>PangoAlignment</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--attributes">attributes</a>" <a
href="../pango/pango-Text-Attributes.html#PangoAttrList"
>PangoAttrList</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--background">background</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--background-gdk">background-gdk</a>" <a
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"
>GdkColor</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--background-set">background-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--editable">editable</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--editable-set">editable-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--ellipsize">ellipsize</a>" <a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
>PangoEllipsizeMode</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--ellipsize-set">ellipsize-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--family">family</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--family-set">family-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--font">font</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--font-desc">font-desc</a>" <a
href="../pango/pango-Fonts.html#PangoFontDescription"
>PangoFontDescription</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--foreground">foreground</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--foreground-gdk">foreground-gdk</a>" <a
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"
>GdkColor</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--foreground-set">foreground-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--language">language</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--language-set">language-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--markup">markup</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--rise">rise</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--rise-set">rise-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--scale">scale</a>" <a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--scale-set">scale-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--single-paragraph-mode">single-paragraph-mode</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--size">size</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--size-points">size-points</a>" <a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--size-set">size-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--stretch">stretch</a>" <a
href="../pango/pango-Fonts.html#PangoStretch"
>PangoStretch</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--stretch-set">stretch-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--strikethrough">strikethrough</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--strikethrough-set">strikethrough-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--style">style</a>" <a
href="../pango/pango-Fonts.html#PangoStyle"
>PangoStyle</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--style-set">style-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--text">text</a>" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--underline">underline</a>" <a
href="../pango/pango-Text-Attributes.html#PangoUnderline"
>PangoUnderline</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--underline-set">underline-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--variant">variant</a>" <a
href="../pango/pango-Fonts.html#PangoVariant"
>PangoVariant</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--variant-set">variant-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--weight">weight</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--weight-set">weight-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--width-chars">width-chars</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--wrap-mode">wrap-mode</a>" <a
href="../pango/pango-Layout-Objects.html#PangoWrapMode"
>PangoWrapMode</a> : Read / Write
"<a href="GtkCellRendererText.html#GtkCellRendererText--wrap-width">wrap-width</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3230343"></a><h2>Signals</h2>
<pre class="synopsis">
"<a href="GtkCellRendererText.html#GtkCellRendererText-edited">edited</a>" void user_function (<a href="GtkCellRendererText.html" title="GtkCellRendererText">GtkCellRendererText</a> *cellrenderertext,
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *arg1,
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *arg2,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3230409"></a><h2>Description</h2>
<p>
A <a href="GtkCellRendererText.html" title="GtkCellRendererText"><span class="type">GtkCellRendererText</span></a> 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 <a href="GtkCellRendererText.html#GtkCellRendererText--ellipsize">ellipsize</a>
property allows it.
</p>
<p>
If the <a href="GtkCellRenderer.html#GtkCellRenderer--mode">mode</a> is <a href="GtkCellRenderer.html#GTK-CELL-RENDERER-MODE-EDITABLE:CAPS"><code class="literal">GTK_CELL_RENDERER_MODE_EDITABLE</code></a>,
the <a href="GtkCellRendererText.html" title="GtkCellRendererText"><span class="type">GtkCellRendererText</span></a> allows to edit its text using an entry.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3230473"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3230484"></a><h3>
<a name="GtkCellRendererText-struct"></a>GtkCellRendererText</h3>
<a class="indexterm" name="id3230497"></a><pre class="programlisting">typedef struct _GtkCellRendererText GtkCellRendererText;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230512"></a><h3>
<a name="gtk-cell-renderer-text-new"></a>gtk_cell_renderer_text_new ()</h3>
<a class="indexterm" name="id3230526"></a><pre class="programlisting"><a href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>* gtk_cell_renderer_text_new (void);</pre>
<p>
Creates a new <a href="GtkCellRendererText.html" title="GtkCellRendererText"><span class="type">GtkCellRendererText</span></a>. Adjust how text is drawn using
object properties. Object properties can be
set globally (with <a
href="../gobject/gobject-The-Base-Object-Type.html#g-object-set"
><code class="function">g_object_set()</code></a>). Also, with <a href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a>,
you can bind a property to a value in a <a href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>. 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 <a href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new cell renderer
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230613"></a><h3>
<a name="gtk-cell-renderer-text-set-fixed-height-from-font"></a>gtk_cell_renderer_text_set_fixed_height_from_font ()</h3>
<a class="indexterm" name="id3230627"></a><pre class="programlisting">void gtk_cell_renderer_text_set_fixed_height_from_font
(<a href="GtkCellRendererText.html" title="GtkCellRendererText">GtkCellRendererText</a> *renderer,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> number_of_rows);</pre>
<p>
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 <em class="parameter"><code>number_of_rows</code></em> is -1, then the fixed height is unset, and
the height is determined by the properties again.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>renderer</code></em> :</span></td>
<td> A <a href="GtkCellRendererText.html" title="GtkCellRendererText"><span class="type">GtkCellRendererText</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>number_of_rows</code></em> :</span></td>
<td> Number of rows of text each cell renderer is allocated, or -1
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3230725"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3230735"></a><h3>
<a name="GtkCellRendererText--alignment"></a>The "<code class="literal">alignment</code>" property</h3>
<a class="indexterm" name="id3230752"></a><pre class="programlisting"> "alignment" <a
href="../pango/pango-Layout-Objects.html#PangoAlignment"
>PangoAlignment</a> : Read / Write</pre>
<p>
Specifies how to align the lines of text.</p>
<p>
</p>
<p>Default value: PANGO_ALIGN_LEFT</p>
<p>Since 2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230788"></a><h3>
<a name="GtkCellRendererText--attributes"></a>The "<code class="literal">attributes</code>" property</h3>
<a class="indexterm" name="id3230805"></a><pre class="programlisting"> "attributes" <a
href="../pango/pango-Text-Attributes.html#PangoAttrList"
>PangoAttrList</a> : Read / Write</pre>
<p>A list of style attributes to apply to the text of the renderer.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230829"></a><h3>
<a name="GtkCellRendererText--background"></a>The "<code class="literal">background</code>" property</h3>
<a class="indexterm" name="id3230846"></a><pre class="programlisting"> "background" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Write</pre>
<p>Background color as a string.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230872"></a><h3>
<a name="GtkCellRendererText--background-gdk"></a>The "<code class="literal">background-gdk</code>" property</h3>
<a class="indexterm" name="id3230889"></a><pre class="programlisting"> "background-gdk" <a
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"
>GdkColor</a> : Read / Write</pre>
<p>Background color as a GdkColor.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230912"></a><h3>
<a name="GtkCellRendererText--background-set"></a>The "<code class="literal">background-set</code>" property</h3>
<a class="indexterm" name="id3230929"></a><pre class="programlisting"> "background-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the background color.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230956"></a><h3>
<a name="GtkCellRendererText--editable"></a>The "<code class="literal">editable</code>" property</h3>
<a class="indexterm" name="id3230973"></a><pre class="programlisting"> "editable" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether the text can be modified by the user.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231000"></a><h3>
<a name="GtkCellRendererText--editable-set"></a>The "<code class="literal">editable-set</code>" property</h3>
<a class="indexterm" name="id3231017"></a><pre class="programlisting"> "editable-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects text editability.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231044"></a><h3>
<a name="GtkCellRendererText--ellipsize"></a>The "<code class="literal">ellipsize</code>" property</h3>
<a class="indexterm" name="id3231061"></a><pre class="programlisting"> "ellipsize" <a
href="../pango/pango-Layout-Objects.html#PangoEllipsizeMode"
>PangoEllipsizeMode</a> : Read / Write</pre>
<p>
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
<a
href="../pango/pango-Layout-Objects.html#PANGO-ELLIPSIZE-NONE:CAPS"
><code class="literal">PANGO_ELLIPSIZE_NONE</code></a> turns off ellipsizing. See the wrap-width property
for another way of making the text fit into a given width.</p>
<p>
</p>
<p>Default value: PANGO_ELLIPSIZE_NONE</p>
<p>Since 2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231111"></a><h3>
<a name="GtkCellRendererText--ellipsize-set"></a>The "<code class="literal">ellipsize-set</code>" property</h3>
<a class="indexterm" name="id3231128"></a><pre class="programlisting"> "ellipsize-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the ellipsize mode.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231155"></a><h3>
<a name="GtkCellRendererText--family"></a>The "<code class="literal">family</code>" property</h3>
<a class="indexterm" name="id3231171"></a><pre class="programlisting"> "family" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>Name of the font family, e.g. Sans, Helvetica, Times, Monospace.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231198"></a><h3>
<a name="GtkCellRendererText--family-set"></a>The "<code class="literal">family-set</code>" property</h3>
<a class="indexterm" name="id3231215"></a><pre class="programlisting"> "family-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the font family.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231241"></a><h3>
<a name="GtkCellRendererText--font"></a>The "<code class="literal">font</code>" property</h3>
<a class="indexterm" name="id3231257"></a><pre class="programlisting"> "font" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>Font description as a string, e.g. "Sans Italic 12".</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231285"></a><h3>
<a name="GtkCellRendererText--font-desc"></a>The "<code class="literal">font-desc</code>" property</h3>
<a class="indexterm" name="id3231302"></a><pre class="programlisting"> "font-desc" <a
href="../pango/pango-Fonts.html#PangoFontDescription"
>PangoFontDescription</a> : Read / Write</pre>
<p>Font description as a PangoFontDescription struct.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231326"></a><h3>
<a name="GtkCellRendererText--foreground"></a>The "<code class="literal">foreground</code>" property</h3>
<a class="indexterm" name="id3231342"></a><pre class="programlisting"> "foreground" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Write</pre>
<p>Foreground color as a string.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231369"></a><h3>
<a name="GtkCellRendererText--foreground-gdk"></a>The "<code class="literal">foreground-gdk</code>" property</h3>
<a class="indexterm" name="id3231386"></a><pre class="programlisting"> "foreground-gdk" <a
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"
>GdkColor</a> : Read / Write</pre>
<p>Foreground color as a GdkColor.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231409"></a><h3>
<a name="GtkCellRendererText--foreground-set"></a>The "<code class="literal">foreground-set</code>" property</h3>
<a class="indexterm" name="id3231426"></a><pre class="programlisting"> "foreground-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the foreground color.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231453"></a><h3>
<a name="GtkCellRendererText--language"></a>The "<code class="literal">language</code>" property</h3>
<a class="indexterm" name="id3231470"></a><pre class="programlisting"> "language" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>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.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231499"></a><h3>
<a name="GtkCellRendererText--language-set"></a>The "<code class="literal">language-set</code>" property</h3>
<a class="indexterm" name="id3231515"></a><pre class="programlisting"> "language-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the language the text is rendered as.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231542"></a><h3>
<a name="GtkCellRendererText--markup"></a>The "<code class="literal">markup</code>" property</h3>
<a class="indexterm" name="id3231559"></a><pre class="programlisting"> "markup" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Write</pre>
<p>Marked up text to render.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231585"></a><h3>
<a name="GtkCellRendererText--rise"></a>The "<code class="literal">rise</code>" property</h3>
<a class="indexterm" name="id3231602"></a><pre class="programlisting"> "rise" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write</pre>
<p>Offset of text above the baseline (below the baseline if rise is negative).</p>
<p>Allowed values: >= -2147483647</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231633"></a><h3>
<a name="GtkCellRendererText--rise-set"></a>The "<code class="literal">rise-set</code>" property</h3>
<a class="indexterm" name="id3231650"></a><pre class="programlisting"> "rise-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the rise.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231677"></a><h3>
<a name="GtkCellRendererText--scale"></a>The "<code class="literal">scale</code>" property</h3>
<a class="indexterm" name="id3231693"></a><pre class="programlisting"> "scale" <a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> : Read / Write</pre>
<p>Font scaling factor.</p>
<p>Allowed values: >= 0</p>
<p>Default value: 1</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231723"></a><h3>
<a name="GtkCellRendererText--scale-set"></a>The "<code class="literal">scale-set</code>" property</h3>
<a class="indexterm" name="id3231739"></a><pre class="programlisting"> "scale-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag scales the font size by a factor.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231766"></a><h3>
<a name="GtkCellRendererText--single-paragraph-mode"></a>The "<code class="literal">single-paragraph-mode</code>" property</h3>
<a class="indexterm" name="id3231784"></a><pre class="programlisting"> "single-paragraph-mode" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether or not to keep all text in a single paragraph.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231811"></a><h3>
<a name="GtkCellRendererText--size"></a>The "<code class="literal">size</code>" property</h3>
<a class="indexterm" name="id3231827"></a><pre class="programlisting"> "size" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write</pre>
<p>Font size.</p>
<p>Allowed values: >= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231858"></a><h3>
<a name="GtkCellRendererText--size-points"></a>The "<code class="literal">size-points</code>" property</h3>
<a class="indexterm" name="id3231875"></a><pre class="programlisting"> "size-points" <a
href="../glib/glib-Basic-Types.html#gdouble"
>gdouble</a> : Read / Write</pre>
<p>Font size in points.</p>
<p>Allowed values: >= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231905"></a><h3>
<a name="GtkCellRendererText--size-set"></a>The "<code class="literal">size-set</code>" property</h3>
<a class="indexterm" name="id3231922"></a><pre class="programlisting"> "size-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the font size.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231949"></a><h3>
<a name="GtkCellRendererText--stretch"></a>The "<code class="literal">stretch</code>" property</h3>
<a class="indexterm" name="id3231966"></a><pre class="programlisting"> "stretch" <a
href="../pango/pango-Fonts.html#PangoStretch"
>PangoStretch</a> : Read / Write</pre>
<p>Font stretch.</p>
<p>Default value: PANGO_STRETCH_NORMAL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231993"></a><h3>
<a name="GtkCellRendererText--stretch-set"></a>The "<code class="literal">stretch-set</code>" property</h3>
<a class="indexterm" name="id3232010"></a><pre class="programlisting"> "stretch-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the font stretch.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232037"></a><h3>
<a name="GtkCellRendererText--strikethrough"></a>The "<code class="literal">strikethrough</code>" property</h3>
<a class="indexterm" name="id3232054"></a><pre class="programlisting"> "strikethrough" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether to strike through the text.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232080"></a><h3>
<a name="GtkCellRendererText--strikethrough-set"></a>The "<code class="literal">strikethrough-set</code>" property</h3>
<a class="indexterm" name="id3232097"></a><pre class="programlisting"> "strikethrough-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects strikethrough.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232124"></a><h3>
<a name="GtkCellRendererText--style"></a>The "<code class="literal">style</code>" property</h3>
<a class="indexterm" name="id3232141"></a><pre class="programlisting"> "style" <a
href="../pango/pango-Fonts.html#PangoStyle"
>PangoStyle</a> : Read / Write</pre>
<p>Font style.</p>
<p>Default value: PANGO_STYLE_NORMAL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232167"></a><h3>
<a name="GtkCellRendererText--style-set"></a>The "<code class="literal">style-set</code>" property</h3>
<a class="indexterm" name="id3232184"></a><pre class="programlisting"> "style-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the font style.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232211"></a><h3>
<a name="GtkCellRendererText--text"></a>The "<code class="literal">text</code>" property</h3>
<a class="indexterm" name="id3232227"></a><pre class="programlisting"> "text" <a
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a> : Read / Write</pre>
<p>Text to render.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232254"></a><h3>
<a name="GtkCellRendererText--underline"></a>The "<code class="literal">underline</code>" property</h3>
<a class="indexterm" name="id3232271"></a><pre class="programlisting"> "underline" <a
href="../pango/pango-Text-Attributes.html#PangoUnderline"
>PangoUnderline</a> : Read / Write</pre>
<p>Style of underline for this text.</p>
<p>Default value: PANGO_UNDERLINE_NONE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232298"></a><h3>
<a name="GtkCellRendererText--underline-set"></a>The "<code class="literal">underline-set</code>" property</h3>
<a class="indexterm" name="id3232315"></a><pre class="programlisting"> "underline-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects underlining.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232342"></a><h3>
<a name="GtkCellRendererText--variant"></a>The "<code class="literal">variant</code>" property</h3>
<a class="indexterm" name="id3232359"></a><pre class="programlisting"> "variant" <a
href="../pango/pango-Fonts.html#PangoVariant"
>PangoVariant</a> : Read / Write</pre>
<p>Font variant.</p>
<p>Default value: PANGO_VARIANT_NORMAL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232386"></a><h3>
<a name="GtkCellRendererText--variant-set"></a>The "<code class="literal">variant-set</code>" property</h3>
<a class="indexterm" name="id3232403"></a><pre class="programlisting"> "variant-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the font variant.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232430"></a><h3>
<a name="GtkCellRendererText--weight"></a>The "<code class="literal">weight</code>" property</h3>
<a class="indexterm" name="id3232446"></a><pre class="programlisting"> "weight" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write</pre>
<p>Font weight.</p>
<p>Allowed values: >= 0</p>
<p>Default value: 400</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232476"></a><h3>
<a name="GtkCellRendererText--weight-set"></a>The "<code class="literal">weight-set</code>" property</h3>
<a class="indexterm" name="id3232493"></a><pre class="programlisting"> "weight-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether this tag affects the font weight.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232520"></a><h3>
<a name="GtkCellRendererText--width-chars"></a>The "<code class="literal">width-chars</code>" property</h3>
<a class="indexterm" name="id3232536"></a><pre class="programlisting"> "width-chars" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write</pre>
<p>
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.</p>
<p>
</p>
<p>Allowed values: >= -1</p>
<p>Default value: -1</p>
<p>Since 2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232579"></a><h3>
<a name="GtkCellRendererText--wrap-mode"></a>The "<code class="literal">wrap-mode</code>" property</h3>
<a class="indexterm" name="id3232596"></a><pre class="programlisting"> "wrap-mode" <a
href="../pango/pango-Layout-Objects.html#PangoWrapMode"
>PangoWrapMode</a> : Read / Write</pre>
<p>
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.</p>
<p>
</p>
<p>Default value: PANGO_WRAP_CHAR</p>
<p>Since 2.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232634"></a><h3>
<a name="GtkCellRendererText--wrap-width"></a>The "<code class="literal">wrap-width</code>" property</h3>
<a class="indexterm" name="id3232651"></a><pre class="programlisting"> "wrap-width" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read / Write</pre>
<p>
Specifies the 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.</p>
<p>
</p>
<p>Allowed values: >= -1</p>
<p>Default value: -1</p>
<p>Since 2.8
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3232694"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3232704"></a><h3>
<a name="GtkCellRendererText-edited"></a>The "edited" signal</h3>
<a class="indexterm" name="id3232715"></a><pre class="programlisting">void user_function (<a href="GtkCellRendererText.html" title="GtkCellRendererText">GtkCellRendererText</a> *cellrenderertext,
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *arg1,
<a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *arg2,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cellrenderertext</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>arg2</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>