<?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="GtkCellArea">
<refmeta>
<refentrytitle role="top_of_page" id="GtkCellArea.top_of_page">GtkCellArea</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkCellArea</refname>
<refpurpose>An abstract class for laying out GtkCellRenderers</refpurpose>
</refnamediv>

<refsect1 id="GtkCellArea.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="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><phrase role="c_punctuation">(</phrase><link linkend="GtkCellCallback">*GtkCellCallback</link><phrase role="c_punctuation">)</phrase>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><phrase role="c_punctuation">(</phrase><link linkend="GtkCellAllocCallback">*GtkCellAllocCallback</link><phrase role="c_punctuation">)</phrase>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="GTK-CELL-AREA-WARN-INVALID-CELL-PROPERTY-ID:CAPS">GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID</link><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-area-add">gtk_cell_area_add</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-area-remove">gtk_cell_area_remove</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-area-has-renderer">gtk_cell_area_has_renderer</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-area-foreach">gtk_cell_area_foreach</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-area-foreach-alloc">gtk_cell_area_foreach_alloc</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-area-event">gtk_cell_area_event</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-area-snapshot">gtk_cell_area_snapshot</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-area-get-cell-allocation">gtk_cell_area_get_cell_allocation</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-get-cell-at-position">gtk_cell_area_get_cell_at_position</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkCellAreaContext"><returnvalue>GtkCellAreaContext</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-create-context">gtk_cell_area_create_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkCellAreaContext"><returnvalue>GtkCellAreaContext</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-copy-context">gtk_cell_area_copy_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkSizeRequestMode"><returnvalue>GtkSizeRequestMode</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-area-get-request-mode">gtk_cell_area_get_request_mode</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-area-get-preferred-width">gtk_cell_area_get_preferred_width</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-area-get-preferred-height-for-width">gtk_cell_area_get_preferred_height_for_width</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-area-get-preferred-height">gtk_cell_area_get_preferred_height</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-area-get-preferred-width-for-height">gtk_cell_area_get_preferred_width_for_height</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-get-current-path-string">gtk_cell_area_get_current_path_string</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-area-apply-attributes">gtk_cell_area_apply_attributes</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-area-attribute-connect">gtk_cell_area_attribute_connect</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-area-attribute-disconnect">gtk_cell_area_attribute_disconnect</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-area-attribute-get-column">gtk_cell_area_attribute_get_column</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-area-class-install-cell-property">gtk_cell_area_class_install_cell_property</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-class-find-cell-property">gtk_cell_area_class_find_cell_property</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;**
</entry><entry role="function_name"><link linkend="gtk-cell-area-class-list-cell-properties">gtk_cell_area_class_list_cell_properties</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-area-add-with-properties">gtk_cell_area_add_with_properties</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-area-cell-set">gtk_cell_area_cell_set</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-area-cell-get">gtk_cell_area_cell_get</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-area-cell-set-valist">gtk_cell_area_cell_set_valist</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-area-cell-get-valist">gtk_cell_area_cell_get_valist</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-area-cell-set-property">gtk_cell_area_cell_set_property</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-area-cell-get-property">gtk_cell_area_cell_get_property</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-area-is-activatable">gtk_cell_area_is_activatable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-area-activate">gtk_cell_area_activate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-area-focus">gtk_cell_area_focus</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-area-set-focus-cell">gtk_cell_area_set_focus_cell</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-get-focus-cell">gtk_cell_area_get_focus_cell</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-area-add-focus-sibling">gtk_cell_area_add_focus_sibling</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-area-remove-focus-sibling">gtk_cell_area_remove_focus_sibling</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-area-is-focus-sibling">gtk_cell_area_is_focus_sibling</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="GList"><returnvalue>GList</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-get-focus-siblings">gtk_cell_area_get_focus_siblings</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-get-focus-from-sibling">gtk_cell_area_get_focus_from_sibling</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-get-edited-cell">gtk_cell_area_get_edited_cell</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkCellEditable"><returnvalue>GtkCellEditable</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-area-get-edit-widget">gtk_cell_area_get_edit_widget</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-cell-area-activate-cell">gtk_cell_area_activate_cell</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-area-stop-editing">gtk_cell_area_stop_editing</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-area-inner-cell-area">gtk_cell_area_inner_cell_area</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-area-request-renderer">gtk_cell_area_request_renderer</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellArea.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="GtkCellEditable"><type>GtkCellEditable</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellArea--edit-widget">edit-widget</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellArea--edited-cell">edited-cell</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellArea--focus-cell">focus-cell</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellArea.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="GtkCellArea-add-editable">add-editable</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkCellArea-apply-attributes">apply-attributes</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkCellArea-focus-changed">focus-changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkCellArea-remove-editable">remove-editable</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellArea.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="GtkCellArea-struct">GtkCellArea</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GtkCellAreaClass">GtkCellAreaClass</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellArea.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> GtkCellArea
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkCellAreaBox">GtkCellAreaBox</link>
</screen>
</refsect1>
<refsect1 id="GtkCellArea.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkCellArea implements
 <link linkend="GtkCellLayout">GtkCellLayout</link> and  <link linkend="GtkBuildable">GtkBuildable</link>.</para>

</refsect1>

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

<refsect1 id="GtkCellArea.description" role="desc">
<title role="desc.title">Description</title>
<para>The <link linkend="GtkCellArea"><type>GtkCellArea</type></link> is an abstract class for <link linkend="GtkCellLayout"><type>GtkCellLayout</type></link> widgets
(also referred to as "layouting widgets") to interface with an
arbitrary number of <link linkend="GtkCellRenderers"><type>GtkCellRenderers</type></link> and interact with the user
for a given <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> row.</para>
<para>The cell area handles events, focus navigation, drawing and
size requests and allocations for a given row of data.</para>
<para>Usually users dont have to interact with the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> directly
unless they are implementing a cell-layouting widget themselves.</para>
<refsect2><title>Requesting area sizes</title><para>As outlined in
<link linkend="geometry-management">GtkWidget’s geometry management section</link>,
GTK+ uses a height-for-width
geometry management system to compute the sizes of widgets and user
interfaces. <link linkend="GtkCellArea"><type>GtkCellArea</type></link> uses the same semantics to calculate the
size of an area for an arbitrary number of <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> rows.</para>
<para>When requesting the size of a cell area one needs to calculate
the size for a handful of rows, and this will be done differently by
different layouting widgets. For instance a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
always lines up the areas from top to bottom while a <link linkend="GtkIconView"><type>GtkIconView</type></link>
on the other hand might enforce that all areas received the same
width and wrap the areas around, requesting height for more cell
areas when allocated less width.</para>
<para>It’s also important for areas to maintain some cell
alignments with areas rendered for adjacent rows (cells can
appear “columnized” inside an area even when the size of
cells are different in each row). For this reason the <link linkend="GtkCellArea"><type>GtkCellArea</type></link>
uses a <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> object to store the alignments
and sizes along the way (as well as the overall largest minimum
and natural size for all the rows which have been calculated
with the said context).</para>
<para>The <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> is an opaque object specific to the
<link linkend="GtkCellArea"><type>GtkCellArea</type></link> which created it (see <link linkend="gtk-cell-area-create-context"><function>gtk_cell_area_create_context()</function></link>).
The owning cell-layouting widget can create as many contexts as
it wishes to calculate sizes of rows which should receive the
same size in at least one orientation (horizontally or vertically),
However, it’s important that the same <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> which
was used to request the sizes for a given <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> row be
used when rendering or processing events for that row.</para>
<para>In order to request the width of all the rows at the root level
of a <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> one would do the following:</para>
<informalexample><programlisting role="example"><![CDATA[
GtkTreeIter iter;
gint        minimum_width;
gint        natural_width;

valid = gtk_tree_model_get_iter_first (model, &iter);
while (valid)
  {
    gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE);
    gtk_cell_area_get_preferred_width (area, context, widget, NULL, NULL);

    valid = gtk_tree_model_iter_next (model, &iter);
  }
gtk_cell_area_context_get_preferred_width (context, &minimum_width, &natural_width);
]]></programlisting></informalexample>
<para></para>
<para>Note that in this example it’s not important to observe the
returned minimum and natural width of the area for each row
unless the cell-layouting object is actually interested in the
widths of individual rows. The overall width is however stored
in the accompanying <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> object and can be consulted
at any time.</para>
<para>This can be useful since <link linkend="GtkCellLayout"><type>GtkCellLayout</type></link> widgets usually have to
support requesting and rendering rows in treemodels with an
exceedingly large amount of rows. The <link linkend="GtkCellLayout"><type>GtkCellLayout</type></link> widget in
that case would calculate the required width of the rows in an
idle or timeout source (see <link linkend="g-timeout-add"><function>g_timeout_add()</function></link>) and when the widget
is requested its actual width in <link linkend="GtkWidgetClass.get-preferred-width"><function>GtkWidgetClass.get_preferred_width()</function></link>
it can simply consult the width accumulated so far in the
<link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> object.</para>
<para>A simple example where rows are rendered from top to bottom and
take up the full width of the layouting widget would look like:</para>
<informalexample><programlisting role="example"><![CDATA[
static void
foo_get_preferred_width (GtkWidget       *widget,
                         gint            *minimum_size,
                         gint            *natural_size)
{
  Foo        *foo  = FOO (widget);
  FooPrivate *priv = foo->priv;

  foo_ensure_at_least_one_handfull_of_rows_have_been_requested (foo);

  gtk_cell_area_context_get_preferred_width (priv->context, minimum_size, natural_size);
}
]]></programlisting></informalexample>
<para></para>
<para>In the above example the Foo widget has to make sure that some
row sizes have been calculated (the amount of rows that Foo judged
was appropriate to request space for in a single timeout iteration)
before simply returning the amount of space required by the area via
the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link>.</para>
<para>Requesting the height for width (or width for height) of an area is
a similar task except in this case the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> does not
store the data (actually, it does not know how much space the layouting
widget plans to allocate it for every row. It’s up to the layouting
widget to render each row of data with the appropriate height and
width which was requested by the <link linkend="GtkCellArea"><type>GtkCellArea</type></link>).</para>
<para>In order to request the height for width of all the rows at the
root level of a <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> one would do the following:</para>
<informalexample><programlisting role="example"><![CDATA[
GtkTreeIter iter;
gint        minimum_height;
gint        natural_height;
gint        full_minimum_height = 0;
gint        full_natural_height = 0;

valid = gtk_tree_model_get_iter_first (model, &iter);
while (valid)
  {
    gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE);
    gtk_cell_area_get_preferred_height_for_width (area, context, widget,
                                                  width, &minimum_height, &natural_height);

    if (width_is_for_allocation)
       cache_row_height (&iter, minimum_height, natural_height);

    full_minimum_height += minimum_height;
    full_natural_height += natural_height;

    valid = gtk_tree_model_iter_next (model, &iter);
  }
]]></programlisting></informalexample>
<para></para>
<para>Note that in the above example we would need to cache the heights
returned for each row so that we would know what sizes to render the
areas for each row. However we would only want to really cache the
heights if the request is intended for the layouting widgets real
allocation.</para>
<para>In some cases the layouting widget is requested the height for an
arbitrary for_width, this is a special case for layouting widgets
who need to request size for tens of thousands  of rows. For this
case it’s only important that the layouting widget calculate
one reasonably sized chunk of rows and return that height
synchronously. The reasoning here is that any layouting widget is
at least capable of synchronously calculating enough height to fill
the screen height (or scrolled window height) in response to a single
call to <link linkend="GtkWidgetClass.get-preferred-height-for-width"><function>GtkWidgetClass.get_preferred_height_for_width()</function></link>. Returning
a perfect height for width that is larger than the screen area is
inconsequential since after the layouting receives an allocation
from a scrolled window it simply continues to drive the scrollbar
values while more and more height is required for the row heights
that are calculated in the background.</para>
</refsect2>
<refsect2><title>Rendering Areas</title><para>Once area sizes have been aquired at least for the rows in the
visible area of the layouting widget they can be rendered at
<link linkend="GtkWidgetClass.draw"><function>GtkWidgetClass.draw()</function></link> time.</para>
<para>A crude example of how to render all the rows at the root level
runs as follows:</para>
<informalexample><programlisting role="example"><![CDATA[
GtkAllocation allocation;
GdkRectangle  cell_area = { 0, };
GtkTreeIter   iter;
gint          minimum_width;
gint          natural_width;

gtk_widget_get_allocation (widget, &allocation);
cell_area.width = allocation.width;

valid = gtk_tree_model_get_iter_first (model, &iter);
while (valid)
  {
    cell_area.height = get_cached_height_for_row (&iter);

    gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE);
    gtk_cell_area_render (area, context, widget, cr,
                          &cell_area, &cell_area, state_flags, FALSE);

    cell_area.y += cell_area.height;

    valid = gtk_tree_model_iter_next (model, &iter);
  }
]]></programlisting></informalexample>
<para></para>
<para>Note that the cached height in this example really depends on how
the layouting widget works. The layouting widget might decide to
give every row its minimum or natural height or, if the model content
is expected to fit inside the layouting widget without scrolling, it
would make sense to calculate the allocation for each row at
the time the widget is allocated using <link linkend="gtk-distribute-natural-allocation"><function>gtk_distribute_natural_allocation()</function></link>.</para>
</refsect2>
<refsect2><title>Handling Events and Driving Keyboard Focus</title><para>Passing events to the area is as simple as handling events on any
normal widget and then passing them to the <link linkend="gtk-cell-area-event"><function>gtk_cell_area_event()</function></link>
API as they come in. Usually <link linkend="GtkCellArea"><type>GtkCellArea</type></link> is only interested in
button events, however some customized derived areas can be implemented
who are interested in handling other events. Handling an event can
trigger the <link linkend="GtkCellArea-focus-changed"><type>“focus-changed”</type></link> signal to fire; as well as
<link linkend="GtkCellArea-add-editable"><type>“add-editable”</type></link> in the case that an editable cell was
clicked and needs to start editing. You can call
<link linkend="gtk-cell-area-stop-editing"><function>gtk_cell_area_stop_editing()</function></link> at any time to cancel any cell editing
that is currently in progress.</para>
<para>The <link linkend="GtkCellArea"><type>GtkCellArea</type></link> drives keyboard focus from cell to cell in a way
similar to <link linkend="GtkWidget"><type>GtkWidget</type></link>. For layouting widgets that support giving
focus to cells it’s important to remember to pass <link linkend="GTK-CELL-RENDERER-FOCUSED:CAPS"><literal>GTK_CELL_RENDERER_FOCUSED</literal></link>
to the area functions for the row that has focus and to tell the
area to paint the focus at render time.</para>
<para>Layouting widgets that accept focus on cells should implement the
<link linkend="GtkWidgetClass.focus"><function>GtkWidgetClass.focus()</function></link> virtual method. The layouting widget is always
responsible for knowing where <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> rows are rendered inside
the widget, so at <link linkend="GtkWidgetClass.focus"><function>GtkWidgetClass.focus()</function></link> time the layouting widget
should use the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> methods to navigate focus inside the area
and then observe the GtkDirectionType to pass the focus to adjacent
rows and areas.</para>
<para>A basic example of how the <link linkend="GtkWidgetClass.focus"><function>GtkWidgetClass.focus()</function></link> virtual method
should be implemented:</para>
<informalexample><programlisting role="example"><![CDATA[
static gboolean
foo_focus (GtkWidget       *widget,
           GtkDirectionType direction)
{
  Foo        *foo  = FOO (widget);
  FooPrivate *priv = foo->priv;
  gint        focus_row;
  gboolean    have_focus = FALSE;

  focus_row = priv->focus_row;

  if (!gtk_widget_has_focus (widget))
    gtk_widget_grab_focus (widget);

  valid = gtk_tree_model_iter_nth_child (priv->model, &iter, NULL, priv->focus_row);
  while (valid)
    {
      gtk_cell_area_apply_attributes (priv->area, priv->model, &iter, FALSE, FALSE);

      if (gtk_cell_area_focus (priv->area, direction))
        {
           priv->focus_row = focus_row;
           have_focus = TRUE;
           break;
        }
      else
        {
          if (direction == GTK_DIR_RIGHT ||
              direction == GTK_DIR_LEFT)
            break;
          else if (direction == GTK_DIR_UP ||
                   direction == GTK_DIR_TAB_BACKWARD)
           {
              if (focus_row == 0)
                break;
              else
               {
                  focus_row--;
                  valid = gtk_tree_model_iter_nth_child (priv->model, &iter, NULL, focus_row);
               }
            }
          else
            {
              if (focus_row == last_row)
                break;
              else
                {
                  focus_row++;
                  valid = gtk_tree_model_iter_next (priv->model, &iter);
                }
            }
        }
    }
    return have_focus;
}
]]></programlisting></informalexample>
<para></para>
<para>Note that the layouting widget is responsible for matching the
GtkDirectionType values to the way it lays out its cells.</para>
</refsect2>
<refsect2><title>Cell Properties</title><para>The <link linkend="GtkCellArea"><type>GtkCellArea</type></link> introduces cell properties for <link linkend="GtkCellRenderers"><type>GtkCellRenderers</type></link>
in very much the same way that <link linkend="GtkContainer"><type>GtkContainer</type></link> introduces
<link linkend="child-properties">child properties</link>
for <link linkend="GtkWidgets"><type>GtkWidgets</type></link>. This provides some general interfaces for defining
the relationship cell areas have with their cells. For instance in a
<link linkend="GtkCellAreaBox"><type>GtkCellAreaBox</type></link> a cell might “expand” and receive extra space when
the area is allocated more than its full natural request, or a cell
might be configured to “align” with adjacent rows which were requested
and rendered with the same <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link>.</para>
<para>Use <link linkend="gtk-cell-area-class-install-cell-property"><function>gtk_cell_area_class_install_cell_property()</function></link> to install cell
properties for a cell area class and <link linkend="gtk-cell-area-class-find-cell-property"><function>gtk_cell_area_class_find_cell_property()</function></link>
or <link linkend="gtk-cell-area-class-list-cell-properties"><function>gtk_cell_area_class_list_cell_properties()</function></link> to get information about
existing cell properties.</para>
<para>To set the value of a cell property, use <link linkend="gtk-cell-area-cell-set-property"><function>gtk_cell_area_cell_set_property()</function></link>,
<link linkend="gtk-cell-area-cell-set"><function>gtk_cell_area_cell_set()</function></link> or <link linkend="gtk-cell-area-cell-set-valist"><function>gtk_cell_area_cell_set_valist()</function></link>. To obtain
the value of a cell property, use <link linkend="gtk-cell-area-cell-get-property"><function>gtk_cell_area_cell_get_property()</function></link>,
<link linkend="gtk-cell-area-cell-get"><function>gtk_cell_area_cell_get()</function></link> or <link linkend="gtk-cell-area-cell-get-valist"><function>gtk_cell_area_cell_get_valist()</function></link>.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkCellArea.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="GtkCellCallback" role="function">
<title>GtkCellCallback&#160;()</title>
<indexterm zone="GtkCellCallback"><primary>GtkCellCallback</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
<phrase role="c_punctuation">(</phrase>*GtkCellCallback<phrase role="c_punctuation">)</phrase> (<parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                    <parameter><link linkend="gpointer"><type>gpointer</type></link> data</parameter>);</programlisting>
<para>The type of the callback functions used for iterating over
the cell renderers of a <link linkend="GtkCellArea"><type>GtkCellArea</type></link>, see <link linkend="gtk-cell-area-foreach"><function>gtk_cell_area_foreach()</function></link>.</para>
<refsect3 id="GtkCellCallback.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 cell renderer to operate on</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>data</para></entry>
<entry role="parameter_description"><para>user-supplied data. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="GtkCellCallback.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to stop iterating over cells.</para>
</refsect3></refsect2>
<refsect2 id="GtkCellAllocCallback" role="function">
<title>GtkCellAllocCallback&#160;()</title>
<indexterm zone="GtkCellAllocCallback"><primary>GtkCellAllocCallback</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
<phrase role="c_punctuation">(</phrase>*GtkCellAllocCallback<phrase role="c_punctuation">)</phrase> (<parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                         <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_area</parameter>,
                         <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_background</parameter>,
                         <parameter><link linkend="gpointer"><type>gpointer</type></link> data</parameter>);</programlisting>
<para>The type of the callback functions used for iterating over the
cell renderers and their allocated areas inside a <link linkend="GtkCellArea"><type>GtkCellArea</type></link>,
see <link linkend="gtk-cell-area-foreach-alloc"><function>gtk_cell_area_foreach_alloc()</function></link>.</para>
<refsect3 id="GtkCellAllocCallback.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 cell renderer to operate on</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the area allocated to <parameter>renderer</parameter>
inside the rectangle
provided to <link linkend="gtk-cell-area-foreach-alloc"><function>gtk_cell_area_foreach_alloc()</function></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_background</para></entry>
<entry role="parameter_description"><para>the background area for <parameter>renderer</parameter>
inside the
background area provided to <link linkend="gtk-cell-area-foreach-alloc"><function>gtk_cell_area_foreach_alloc()</function></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>data</para></entry>
<entry role="parameter_description"><para>user-supplied data. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="GtkCellAllocCallback.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to stop iterating over cells.</para>
</refsect3></refsect2>
<refsect2 id="GTK-CELL-AREA-WARN-INVALID-CELL-PROPERTY-ID:CAPS" role="macro">
<title>GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID()</title>
<indexterm zone="GTK-CELL-AREA-WARN-INVALID-CELL-PROPERTY-ID:CAPS"><primary>GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID</primary></indexterm>
<programlisting language="C">#define             GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID(object, property_id, pspec)</programlisting>
<para>This macro should be used to emit a standard warning about unexpected
properties in <link linkend="set-cell-property"><function>set_cell_property()</function></link> and <link linkend="get-cell-property"><function>get_cell_property()</function></link> implementations.</para>
<refsect3 id="GTK-CELL-AREA-WARN-INVALID-CELL-PROPERTY-ID.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>object</para></entry>
<entry role="parameter_description"><para>the <link linkend="GObject"><type>GObject</type></link> on which <link linkend="set-cell-property"><function>set_cell_property()</function></link> or <link linkend="get-cell-property"><function>get_cell_property()</function></link>
was called</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>property_id</para></entry>
<entry role="parameter_description"><para>the numeric id of the property</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>the <link linkend="GParamSpec"><type>GParamSpec</type></link> of the property</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-add" role="function">
<title>gtk_cell_area_add&#160;()</title>
<indexterm zone="gtk-cell-area-add"><primary>gtk_cell_area_add</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_add (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                   <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>);</programlisting>
<para>Adds <parameter>renderer</parameter>
 to <parameter>area</parameter>
 with the default child cell properties.</para>
<refsect3 id="gtk-cell-area-add.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to add to <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-remove" role="function">
<title>gtk_cell_area_remove&#160;()</title>
<indexterm zone="gtk-cell-area-remove"><primary>gtk_cell_area_remove</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_remove (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                      <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>);</programlisting>
<para>Removes <parameter>renderer</parameter>
 from <parameter>area</parameter>
.</para>
<refsect3 id="gtk-cell-area-remove.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to remove from <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-has-renderer" role="function">
<title>gtk_cell_area_has_renderer&#160;()</title>
<indexterm zone="gtk-cell-area-has-renderer"><primary>gtk_cell_area_has_renderer</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_cell_area_has_renderer (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                            <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>);</programlisting>
<para>Checks if <parameter>area</parameter>
 contains <parameter>renderer</parameter>
.</para>
<refsect3 id="gtk-cell-area-has-renderer.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to check</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-has-renderer.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>renderer</parameter>
is in the <parameter>area</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-foreach" role="function">
<title>gtk_cell_area_foreach&#160;()</title>
<indexterm zone="gtk-cell-area-foreach"><primary>gtk_cell_area_foreach</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_foreach (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                       <parameter><link linkend="GtkCellCallback"><type>GtkCellCallback</type></link> callback</parameter>,
                       <parameter><link linkend="gpointer"><type>gpointer</type></link> callback_data</parameter>);</programlisting>
<para>Calls <parameter>callback</parameter>
 for every <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> in <parameter>area</parameter>
.</para>
<refsect3 id="gtk-cell-area-foreach.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellCallback"><type>GtkCellCallback</type></link> to call. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope call</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>callback_data</para></entry>
<entry role="parameter_description"><para>user provided data pointer</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-foreach-alloc" role="function">
<title>gtk_cell_area_foreach_alloc&#160;()</title>
<indexterm zone="gtk-cell-area-foreach-alloc"><primary>gtk_cell_area_foreach_alloc</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_foreach_alloc (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                             <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                             <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                             <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_area</parameter>,
                             <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *background_area</parameter>,
                             <parameter><link linkend="GtkCellAllocCallback"><type>GtkCellAllocCallback</type></link> callback</parameter>,
                             <parameter><link linkend="gpointer"><type>gpointer</type></link> callback_data</parameter>);</programlisting>
<para>Calls <parameter>callback</parameter>
 for every <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> in <parameter>area</parameter>
 with the
allocated rectangle inside <parameter>cell_area</parameter>
.</para>
<refsect3 id="gtk-cell-area-foreach-alloc.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> for this row of data.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> that <parameter>area</parameter>
is rendering to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the <parameter>widget</parameter>
relative coordinates and size for <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>background_area</para></entry>
<entry role="parameter_description"><para>the <parameter>widget</parameter>
relative coordinates of the background area</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAllocCallback"><type>GtkCellAllocCallback</type></link> to call. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope call</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>callback_data</para></entry>
<entry role="parameter_description"><para>user provided data pointer</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-event" role="function">
<title>gtk_cell_area_event&#160;()</title>
<indexterm zone="gtk-cell-area-event"><primary>gtk_cell_area_event</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_cell_area_event (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                     <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                     <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                     <parameter><link linkend="GdkEvent"><type>GdkEvent</type></link> *event</parameter>,
                     <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_area</parameter>,
                     <parameter><link linkend="GtkCellRendererState"><type>GtkCellRendererState</type></link> flags</parameter>);</programlisting>
<para>Delegates event handling to a <link linkend="GtkCellArea"><type>GtkCellArea</type></link>.</para>
<refsect3 id="gtk-cell-area-event.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> for this row of data.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> that <parameter>area</parameter>
is rendering to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>event</para></entry>
<entry role="parameter_description"><para>the <link linkend="GdkEvent"><type>GdkEvent</type></link> to handle</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the <parameter>widget</parameter>
relative coordinates for <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRendererState"><type>GtkCellRendererState</type></link> for <parameter>area</parameter>
in this row.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-event.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the event was handled by <parameter>area</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-snapshot" role="function">
<title>gtk_cell_area_snapshot&#160;()</title>
<indexterm zone="gtk-cell-area-snapshot"><primary>gtk_cell_area_snapshot</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_snapshot (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                        <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                        <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                        <parameter><link linkend="GtkSnapshot"><type>GtkSnapshot</type></link> *snapshot</parameter>,
                        <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *background_area</parameter>,
                        <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_area</parameter>,
                        <parameter><link linkend="GtkCellRendererState"><type>GtkCellRendererState</type></link> flags</parameter>,
                        <parameter><link linkend="gboolean"><type>gboolean</type></link> paint_focus</parameter>);</programlisting>
<para>Snapshots <parameter>area</parameter>
’s cells according to <parameter>area</parameter>
’s layout onto at
the given coordinates.</para>
<refsect3 id="gtk-cell-area-snapshot.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> for this row of data.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> that <parameter>area</parameter>
is rendering to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>snapshot</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkSnapshot"><type>GtkSnapshot</type></link> to draw to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>background_area</para></entry>
<entry role="parameter_description"><para>the <parameter>widget</parameter>
relative coordinates for <parameter>area</parameter>
’s background</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the <parameter>widget</parameter>
relative coordinates for <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRendererState"><type>GtkCellRendererState</type></link> for <parameter>area</parameter>
in this row.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>paint_focus</para></entry>
<entry role="parameter_description"><para>whether <parameter>area</parameter>
should paint focus on focused cells for focused rows or not.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-cell-allocation" role="function">
<title>gtk_cell_area_get_cell_allocation&#160;()</title>
<indexterm zone="gtk-cell-area-get-cell-allocation"><primary>gtk_cell_area_get_cell_allocation</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_get_cell_allocation (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                   <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                                   <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                   <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                   <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_area</parameter>,
                                   <parameter><link linkend="GdkRectangle"><type>GdkRectangle</type></link> *allocation</parameter>);</programlisting>
<para>Derives the allocation of <parameter>renderer</parameter>
 inside <parameter>area</parameter>
 if <parameter>area</parameter>

were to be renderered in <parameter>cell_area</parameter>
.</para>
<refsect3 id="gtk-cell-area-get-cell-allocation.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> used to hold sizes for <parameter>area</parameter>
.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> that <parameter>area</parameter>
is rendering on</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to get the allocation for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the whole allocated area for <parameter>area</parameter>
in <parameter>widget</parameter>
for this row</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>allocation</para></entry>
<entry role="parameter_description"><para>where to store the allocation for <parameter>renderer</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-cell-at-position" role="function">
<title>gtk_cell_area_get_cell_at_position&#160;()</title>
<indexterm zone="gtk-cell-area-get-cell-at-position"><primary>gtk_cell_area_get_cell_at_position</primary></indexterm>
<programlisting language="C"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
gtk_cell_area_get_cell_at_position (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                    <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                                    <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                    <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_area</parameter>,
                                    <parameter><link linkend="gint"><type>gint</type></link> x</parameter>,
                                    <parameter><link linkend="gint"><type>gint</type></link> y</parameter>,
                                    <parameter><link linkend="GdkRectangle"><type>GdkRectangle</type></link> *alloc_area</parameter>);</programlisting>
<para>Gets the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> at <parameter>x</parameter>
 and <parameter>y</parameter>
 coordinates inside <parameter>area</parameter>
 and optionally
returns the full cell allocation for it inside <parameter>cell_area</parameter>
.</para>
<refsect3 id="gtk-cell-area-get-cell-at-position.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> used to hold sizes for <parameter>area</parameter>
.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> that <parameter>area</parameter>
is rendering on</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the whole allocated area for <parameter>area</parameter>
in <parameter>widget</parameter>
for this row</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x position</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y position</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>alloc_area</para></entry>
<entry role="parameter_description"><para>where to store the inner allocated area of the
returned cell renderer, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-get-cell-at-position.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> at <parameter>x</parameter>
and <parameter>y</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-create-context" role="function">
<title>gtk_cell_area_create_context&#160;()</title>
<indexterm zone="gtk-cell-area-create-context"><primary>gtk_cell_area_create_context</primary></indexterm>
<programlisting language="C"><link linkend="GtkCellAreaContext"><returnvalue>GtkCellAreaContext</returnvalue></link>&#160;*
gtk_cell_area_create_context (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>);</programlisting>
<para>Creates a <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> to be used with <parameter>area</parameter>
 for
all purposes. <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> stores geometry information
for rows for which it was operated on, it is important to use
the same context for the same row of data at all times (i.e.
one should render and handle events with the same <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link>
which was used to request the size of those rows of data).</para>
<refsect3 id="gtk-cell-area-create-context.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-create-context.returns" role="returns">
<title>Returns</title>
<para>a newly created <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> which can be used with <parameter>area</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-copy-context" role="function">
<title>gtk_cell_area_copy_context&#160;()</title>
<indexterm zone="gtk-cell-area-copy-context"><primary>gtk_cell_area_copy_context</primary></indexterm>
<programlisting language="C"><link linkend="GtkCellAreaContext"><returnvalue>GtkCellAreaContext</returnvalue></link>&#160;*
gtk_cell_area_copy_context (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                            <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>);</programlisting>
<para>This is sometimes needed for cases where rows need to share
alignments in one orientation but may be separately grouped
in the opposing orientation.</para>
<para>For instance, <link linkend="GtkIconView"><type>GtkIconView</type></link> creates all icons (rows) to have
the same width and the cells theirin to have the same
horizontal alignments. However each row of icons may have
a separate collective height. <link linkend="GtkIconView"><type>GtkIconView</type></link> uses this to
request the heights of each row based on a context which
was already used to request all the row widths that are
to be displayed.</para>
<refsect3 id="gtk-cell-area-copy-context.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> to copy</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-copy-context.returns" role="returns">
<title>Returns</title>
<para>a newly created <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> copy of <parameter>context</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-request-mode" role="function">
<title>gtk_cell_area_get_request_mode&#160;()</title>
<indexterm zone="gtk-cell-area-get-request-mode"><primary>gtk_cell_area_get_request_mode</primary></indexterm>
<programlisting language="C"><link linkend="GtkSizeRequestMode"><returnvalue>GtkSizeRequestMode</returnvalue></link>
gtk_cell_area_get_request_mode (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>);</programlisting>
<para>Gets whether the area prefers a height-for-width layout
or a width-for-height layout.</para>
<refsect3 id="gtk-cell-area-get-request-mode.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-get-request-mode.returns" role="returns">
<title>Returns</title>
<para> The <link linkend="GtkSizeRequestMode"><type>GtkSizeRequestMode</type></link> preferred by <parameter>area</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-preferred-width" role="function">
<title>gtk_cell_area_get_preferred_width&#160;()</title>
<indexterm zone="gtk-cell-area-get-preferred-width"><primary>gtk_cell_area_get_preferred_width</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_get_preferred_width (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                   <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                                   <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                   <parameter><link linkend="gint"><type>gint</type></link> *minimum_width</parameter>,
                                   <parameter><link linkend="gint"><type>gint</type></link> *natural_width</parameter>);</programlisting>
<para>Retrieves a cell area’s initial minimum and natural width.</para>
<para><parameter>area</parameter>
 will store some geometrical information in <parameter>context</parameter>
 along the way;
when requesting sizes over an arbitrary number of rows, it’s not important
to check the <parameter>minimum_width</parameter>
 and <parameter>natural_width</parameter>
 of this call but rather to
consult <link linkend="gtk-cell-area-context-get-preferred-width"><function>gtk_cell_area_context_get_preferred_width()</function></link> after a series of
requests.</para>
<refsect3 id="gtk-cell-area-get-preferred-width.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> to perform this request with</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> where <parameter>area</parameter>
will be rendering</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum_width</para></entry>
<entry role="parameter_description"><para>location to store the minimum width, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>natural_width</para></entry>
<entry role="parameter_description"><para>location to store the natural width, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-preferred-height-for-width" role="function">
<title>gtk_cell_area_get_preferred_height_for_width&#160;()</title>
<indexterm zone="gtk-cell-area-get-preferred-height-for-width"><primary>gtk_cell_area_get_preferred_height_for_width</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_get_preferred_height_for_width
                               (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                                <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> width</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> *minimum_height</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> *natural_height</parameter>);</programlisting>
<para>Retrieves a cell area’s minimum and natural height if it would be given
the specified <parameter>width</parameter>
.</para>
<para><parameter>area</parameter>
 stores some geometrical information in <parameter>context</parameter>
 along the way
while calling <link linkend="gtk-cell-area-get-preferred-width"><function>gtk_cell_area_get_preferred_width()</function></link>. It’s important to
perform a series of <link linkend="gtk-cell-area-get-preferred-width"><function>gtk_cell_area_get_preferred_width()</function></link> requests with
<parameter>context</parameter>
 first and then call <link linkend="gtk-cell-area-get-preferred-height-for-width"><function>gtk_cell_area_get_preferred_height_for_width()</function></link>
on each cell area individually to get the height for width of each
fully requested row.</para>
<para>If at some point, the width of a single row changes, it should be
requested with <link linkend="gtk-cell-area-get-preferred-width"><function>gtk_cell_area_get_preferred_width()</function></link> again and then
the full width of the requested rows checked again with
<link linkend="gtk-cell-area-context-get-preferred-width"><function>gtk_cell_area_context_get_preferred_width()</function></link>.</para>
<refsect3 id="gtk-cell-area-get-preferred-height-for-width.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> which has already been requested for widths.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> where <parameter>area</parameter>
will be rendering</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>width</para></entry>
<entry role="parameter_description"><para>the width for which to check the height of this area</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum_height</para></entry>
<entry role="parameter_description"><para>location to store the minimum height, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>natural_height</para></entry>
<entry role="parameter_description"><para>location to store the natural height, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-preferred-height" role="function">
<title>gtk_cell_area_get_preferred_height&#160;()</title>
<indexterm zone="gtk-cell-area-get-preferred-height"><primary>gtk_cell_area_get_preferred_height</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_get_preferred_height (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                    <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                                    <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                    <parameter><link linkend="gint"><type>gint</type></link> *minimum_height</parameter>,
                                    <parameter><link linkend="gint"><type>gint</type></link> *natural_height</parameter>);</programlisting>
<para>Retrieves a cell area’s initial minimum and natural height.</para>
<para><parameter>area</parameter>
 will store some geometrical information in <parameter>context</parameter>
 along the way;
when requesting sizes over an arbitrary number of rows, it’s not important
to check the <parameter>minimum_height</parameter>
 and <parameter>natural_height</parameter>
 of this call but rather to
consult <link linkend="gtk-cell-area-context-get-preferred-height"><function>gtk_cell_area_context_get_preferred_height()</function></link> after a series of
requests.</para>
<refsect3 id="gtk-cell-area-get-preferred-height.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> to perform this request with</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> where <parameter>area</parameter>
will be rendering</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum_height</para></entry>
<entry role="parameter_description"><para>location to store the minimum height, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>natural_height</para></entry>
<entry role="parameter_description"><para>location to store the natural height, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-preferred-width-for-height" role="function">
<title>gtk_cell_area_get_preferred_width_for_height&#160;()</title>
<indexterm zone="gtk-cell-area-get-preferred-width-for-height"><primary>gtk_cell_area_get_preferred_width_for_height</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_get_preferred_width_for_height
                               (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                                <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> height</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> *minimum_width</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> *natural_width</parameter>);</programlisting>
<para>Retrieves a cell area’s minimum and natural width if it would be given
the specified <parameter>height</parameter>
.</para>
<para><parameter>area</parameter>
 stores some geometrical information in <parameter>context</parameter>
 along the way
while calling <link linkend="gtk-cell-area-get-preferred-height"><function>gtk_cell_area_get_preferred_height()</function></link>. It’s important to
perform a series of <link linkend="gtk-cell-area-get-preferred-height"><function>gtk_cell_area_get_preferred_height()</function></link> requests with
<parameter>context</parameter>
 first and then call <link linkend="gtk-cell-area-get-preferred-width-for-height"><function>gtk_cell_area_get_preferred_width_for_height()</function></link>
on each cell area individually to get the height for width of each
fully requested row.</para>
<para>If at some point, the height of a single row changes, it should be
requested with <link linkend="gtk-cell-area-get-preferred-height"><function>gtk_cell_area_get_preferred_height()</function></link> again and then
the full height of the requested rows checked again with
<link linkend="gtk-cell-area-context-get-preferred-height"><function>gtk_cell_area_context_get_preferred_height()</function></link>.</para>
<refsect3 id="gtk-cell-area-get-preferred-width-for-height.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> which has already been requested for widths.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> where <parameter>area</parameter>
will be rendering</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>height</para></entry>
<entry role="parameter_description"><para>the height for which to check the width of this area</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum_width</para></entry>
<entry role="parameter_description"><para>location to store the minimum width, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>natural_width</para></entry>
<entry role="parameter_description"><para>location to store the natural width, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-current-path-string" role="function">
<title>gtk_cell_area_get_current_path_string&#160;()</title>
<indexterm zone="gtk-cell-area-get-current-path-string"><primary>gtk_cell_area_get_current_path_string</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_cell_area_get_current_path_string (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>);</programlisting>
<para>Gets the current <link linkend="GtkTreePath"><type>GtkTreePath</type></link> string for the currently
applied <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link>, this is implicitly updated when
<link linkend="gtk-cell-area-apply-attributes"><function>gtk_cell_area_apply_attributes()</function></link> is called and can be
used to interact with renderers from <link linkend="GtkCellArea"><type>GtkCellArea</type></link>
subclasses.</para>
<refsect3 id="gtk-cell-area-get-current-path-string.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-get-current-path-string.returns" role="returns">
<title>Returns</title>
<para> The current <link linkend="GtkTreePath"><type>GtkTreePath</type></link> string for the current
attributes applied to <parameter>area</parameter>
. This string belongs to the area and
should not be freed.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-apply-attributes" role="function">
<title>gtk_cell_area_apply_attributes&#160;()</title>
<indexterm zone="gtk-cell-area-apply-attributes"><primary>gtk_cell_area_apply_attributes</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_apply_attributes (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                <parameter><link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> *tree_model</parameter>,
                                <parameter><link linkend="GtkTreeIter"><type>GtkTreeIter</type></link> *iter</parameter>,
                                <parameter><link linkend="gboolean"><type>gboolean</type></link> is_expander</parameter>,
                                <parameter><link linkend="gboolean"><type>gboolean</type></link> is_expanded</parameter>);</programlisting>
<para>Applies any connected attributes to the renderers in
<parameter>area</parameter>
 by pulling the values from <parameter>tree_model</parameter>
.</para>
<refsect3 id="gtk-cell-area-apply-attributes.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>tree_model</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> to pull values from</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>iter</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link> in <parameter>tree_model</parameter>
to apply values for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>is_expander</para></entry>
<entry role="parameter_description"><para>whether <parameter>iter</parameter>
has children</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>is_expanded</para></entry>
<entry role="parameter_description"><para>whether <parameter>iter</parameter>
is expanded in the view and
children are visible</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-attribute-connect" role="function">
<title>gtk_cell_area_attribute_connect&#160;()</title>
<indexterm zone="gtk-cell-area-attribute-connect"><primary>gtk_cell_area_attribute_connect</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_attribute_connect (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                 <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *attribute</parameter>,
                                 <parameter><link linkend="gint"><type>gint</type></link> column</parameter>);</programlisting>
<para>Connects an <parameter>attribute</parameter>
 to apply values from <parameter>column</parameter>
 for the
<link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> in use.</para>
<refsect3 id="gtk-cell-area-attribute-connect.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to connect an attribute for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>attribute</para></entry>
<entry role="parameter_description"><para>the attribute name</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>column</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> column to fetch attribute values from</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-attribute-disconnect" role="function">
<title>gtk_cell_area_attribute_disconnect&#160;()</title>
<indexterm zone="gtk-cell-area-attribute-disconnect"><primary>gtk_cell_area_attribute_disconnect</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_attribute_disconnect (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                    <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *attribute</parameter>);</programlisting>
<para>Disconnects <parameter>attribute</parameter>
 for the <parameter>renderer</parameter>
 in <parameter>area</parameter>
 so that
attribute will no longer be updated with values from the
model.</para>
<refsect3 id="gtk-cell-area-attribute-disconnect.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to disconnect an attribute for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>attribute</para></entry>
<entry role="parameter_description"><para>the attribute name</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-attribute-get-column" role="function">
<title>gtk_cell_area_attribute_get_column&#160;()</title>
<indexterm zone="gtk-cell-area-attribute-get-column"><primary>gtk_cell_area_attribute_get_column</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_cell_area_attribute_get_column (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                    <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *attribute</parameter>);</programlisting>
<para>Returns the model column that an attribute has been mapped to,
or -1 if the attribute is not mapped.</para>
<refsect3 id="gtk-cell-area-attribute-get-column.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>attribute</para></entry>
<entry role="parameter_description"><para>an attribute on the renderer</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-attribute-get-column.returns" role="returns">
<title>Returns</title>
<para> the model column, or -1</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-class-install-cell-property" role="function">
<title>gtk_cell_area_class_install_cell_property&#160;()</title>
<indexterm zone="gtk-cell-area-class-install-cell-property"><primary>gtk_cell_area_class_install_cell_property</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_class_install_cell_property
                               (<parameter><link linkend="GtkCellAreaClass"><type>GtkCellAreaClass</type></link> *aclass</parameter>,
                                <parameter><link linkend="guint"><type>guint</type></link> property_id</parameter>,
                                <parameter><link linkend="GParamSpec"><type>GParamSpec</type></link> *pspec</parameter>);</programlisting>
<para>Installs a cell property on a cell area class.</para>
<refsect3 id="gtk-cell-area-class-install-cell-property.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>aclass</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellAreaClass"><type>GtkCellAreaClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>property_id</para></entry>
<entry role="parameter_description"><para>the id for the property</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>the <link linkend="GParamSpec"><type>GParamSpec</type></link> for the property</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-class-find-cell-property" role="function">
<title>gtk_cell_area_class_find_cell_property&#160;()</title>
<indexterm zone="gtk-cell-area-class-find-cell-property"><primary>gtk_cell_area_class_find_cell_property</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
gtk_cell_area_class_find_cell_property
                               (<parameter><link linkend="GtkCellAreaClass"><type>GtkCellAreaClass</type></link> *aclass</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *property_name</parameter>);</programlisting>
<para>Finds a cell property of a cell area class by name.</para>
<refsect3 id="gtk-cell-area-class-find-cell-property.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>aclass</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellAreaClass"><type>GtkCellAreaClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>property_name</para></entry>
<entry role="parameter_description"><para>the name of the child property to find</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-class-find-cell-property.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="GParamSpec"><type>GParamSpec</type></link> of the child property
or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if <parameter>aclass</parameter>
has no child property with that name. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-class-list-cell-properties" role="function">
<title>gtk_cell_area_class_list_cell_properties&#160;()</title>
<indexterm zone="gtk-cell-area-class-list-cell-properties"><primary>gtk_cell_area_class_list_cell_properties</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;**
gtk_cell_area_class_list_cell_properties
                               (<parameter><link linkend="GtkCellAreaClass"><type>GtkCellAreaClass</type></link> *aclass</parameter>,
                                <parameter><link linkend="guint"><type>guint</type></link> *n_properties</parameter>);</programlisting>
<para>Returns all cell properties of a cell area class.</para>
<refsect3 id="gtk-cell-area-class-list-cell-properties.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>aclass</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellAreaClass"><type>GtkCellAreaClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_properties</para></entry>
<entry role="parameter_description"><para>location to return the number of cell properties found. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-class-list-cell-properties.returns" role="returns">
<title>Returns</title>
<para>a newly
allocated <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated array of <link linkend="GParamSpec"><type>GParamSpec</type></link>*.  The array
must be freed with <link linkend="g-free"><function>g_free()</function></link>. </para>
<para><emphasis role="annotation">[<acronym>array</acronym> length=n_properties][<acronym>transfer container</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-add-with-properties" role="function">
<title>gtk_cell_area_add_with_properties&#160;()</title>
<indexterm zone="gtk-cell-area-add-with-properties"><primary>gtk_cell_area_add_with_properties</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_add_with_properties (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                   <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *first_prop_name</parameter>,
                                   <parameter>...</parameter>);</programlisting>
<para>Adds <parameter>renderer</parameter>
 to <parameter>area</parameter>
, setting cell properties at the same time.
See <link linkend="gtk-cell-area-add"><function>gtk_cell_area_add()</function></link> and <link linkend="gtk-cell-area-cell-set"><function>gtk_cell_area_cell_set()</function></link> for more details.</para>
<refsect3 id="gtk-cell-area-add-with-properties.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to be placed inside <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>first_prop_name</para></entry>
<entry role="parameter_description"><para>the name of the first cell property to set</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>a <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated list of property names and values, starting
with <parameter>first_prop_name</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-cell-set" role="function">
<title>gtk_cell_area_cell_set&#160;()</title>
<indexterm zone="gtk-cell-area-cell-set"><primary>gtk_cell_area_cell_set</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_cell_set (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                        <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                        <parameter>const <link linkend="gchar"><type>gchar</type></link> *first_prop_name</parameter>,
                        <parameter>...</parameter>);</programlisting>
<para>Sets one or more cell properties for <parameter>cell</parameter>
 in <parameter>area</parameter>
.</para>
<refsect3 id="gtk-cell-area-cell-set.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> which is a cell inside <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>first_prop_name</para></entry>
<entry role="parameter_description"><para>the name of the first cell property to set</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>a <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated list of property names and values, starting
with <parameter>first_prop_name</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-cell-get" role="function">
<title>gtk_cell_area_cell_get&#160;()</title>
<indexterm zone="gtk-cell-area-cell-get"><primary>gtk_cell_area_cell_get</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_cell_get (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                        <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                        <parameter>const <link linkend="gchar"><type>gchar</type></link> *first_prop_name</parameter>,
                        <parameter>...</parameter>);</programlisting>
<para>Gets the values of one or more cell properties for <parameter>renderer</parameter>
 in <parameter>area</parameter>
.</para>
<refsect3 id="gtk-cell-area-cell-get.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> which is inside <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>first_prop_name</para></entry>
<entry role="parameter_description"><para>the name of the first cell property to get</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>return location for the first cell property, followed
optionally by more name/return location pairs, followed by <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-cell-set-valist" role="function">
<title>gtk_cell_area_cell_set_valist&#160;()</title>
<indexterm zone="gtk-cell-area-cell-set-valist"><primary>gtk_cell_area_cell_set_valist</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_cell_set_valist (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                               <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *first_property_name</parameter>,
                               <parameter><link linkend="va-list"><type>va_list</type></link> var_args</parameter>);</programlisting>
<para>Sets one or more cell properties for <parameter>renderer</parameter>
 in <parameter>area</parameter>
.</para>
<refsect3 id="gtk-cell-area-cell-set-valist.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> which inside <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>first_property_name</para></entry>
<entry role="parameter_description"><para>the name of the first cell property to set</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>var_args</para></entry>
<entry role="parameter_description"><para>a <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated list of property names and values, starting
with <parameter>first_prop_name</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-cell-get-valist" role="function">
<title>gtk_cell_area_cell_get_valist&#160;()</title>
<indexterm zone="gtk-cell-area-cell-get-valist"><primary>gtk_cell_area_cell_get_valist</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_cell_get_valist (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                               <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *first_property_name</parameter>,
                               <parameter><link linkend="va-list"><type>va_list</type></link> var_args</parameter>);</programlisting>
<para>Gets the values of one or more cell properties for <parameter>renderer</parameter>
 in <parameter>area</parameter>
.</para>
<refsect3 id="gtk-cell-area-cell-get-valist.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> inside <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>first_property_name</para></entry>
<entry role="parameter_description"><para>the name of the first property to get</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>var_args</para></entry>
<entry role="parameter_description"><para>return location for the first property, followed
optionally by more name/return location pairs, followed by <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-cell-set-property" role="function">
<title>gtk_cell_area_cell_set_property&#160;()</title>
<indexterm zone="gtk-cell-area-cell-set-property"><primary>gtk_cell_area_cell_set_property</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_cell_set_property (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                 <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *property_name</parameter>,
                                 <parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Sets a cell property for <parameter>renderer</parameter>
 in <parameter>area</parameter>
.</para>
<refsect3 id="gtk-cell-area-cell-set-property.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> inside <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>property_name</para></entry>
<entry role="parameter_description"><para>the name of the cell property to set</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>the value to set the cell property to</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-cell-get-property" role="function">
<title>gtk_cell_area_cell_get_property&#160;()</title>
<indexterm zone="gtk-cell-area-cell-get-property"><primary>gtk_cell_area_cell_get_property</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_cell_get_property (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                 <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                 <parameter>const <link linkend="gchar"><type>gchar</type></link> *property_name</parameter>,
                                 <parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Gets the value of a cell property for <parameter>renderer</parameter>
 in <parameter>area</parameter>
.</para>
<refsect3 id="gtk-cell-area-cell-get-property.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> inside <parameter>area</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>property_name</para></entry>
<entry role="parameter_description"><para>the name of the property to get</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a location to return the value</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-is-activatable" role="function">
<title>gtk_cell_area_is_activatable&#160;()</title>
<indexterm zone="gtk-cell-area-is-activatable"><primary>gtk_cell_area_is_activatable</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_cell_area_is_activatable (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>);</programlisting>
<para>Returns whether the area can do anything when activated,
after applying new attributes to <parameter>area</parameter>
.</para>
<refsect3 id="gtk-cell-area-is-activatable.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-is-activatable.returns" role="returns">
<title>Returns</title>
<para> whether <parameter>area</parameter>
can do anything when activated.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-activate" role="function">
<title>gtk_cell_area_activate&#160;()</title>
<indexterm zone="gtk-cell-area-activate"><primary>gtk_cell_area_activate</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_cell_area_activate (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                        <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>,
                        <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                        <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_area</parameter>,
                        <parameter><link linkend="GtkCellRendererState"><type>GtkCellRendererState</type></link> flags</parameter>,
                        <parameter><link linkend="gboolean"><type>gboolean</type></link> edit_only</parameter>);</programlisting>
<para>Activates <parameter>area</parameter>
, usually by activating the currently focused
cell, however some subclasses which embed widgets in the area
can also activate a widget if it currently has the focus.</para>
<refsect3 id="gtk-cell-area-activate.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>context</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> in context with the current row data</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> that <parameter>area</parameter>
is rendering on</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the size and location of <parameter>area</parameter>
relative to <parameter>widget</parameter>
’s allocation</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRendererState"><type>GtkCellRendererState</type></link> flags for <parameter>area</parameter>
for this row of data.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>edit_only</para></entry>
<entry role="parameter_description"><para>if <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> then only cell renderers that are <link linkend="GTK-CELL-RENDERER-MODE-EDITABLE:CAPS"><literal>GTK_CELL_RENDERER_MODE_EDITABLE</literal></link>
will be activated.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-activate.returns" role="returns">
<title>Returns</title>
<para> Whether <parameter>area</parameter>
was successfully activated.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-focus" role="function">
<title>gtk_cell_area_focus&#160;()</title>
<indexterm zone="gtk-cell-area-focus"><primary>gtk_cell_area_focus</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_cell_area_focus (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                     <parameter><link linkend="GtkDirectionType"><type>GtkDirectionType</type></link> direction</parameter>);</programlisting>
<para>This should be called by the <parameter>area</parameter>
’s owning layout widget
when focus is to be passed to <parameter>area</parameter>
, or moved within <parameter>area</parameter>

for a given <parameter>direction</parameter>
 and row data.</para>
<para>Implementing <link linkend="GtkCellArea"><type>GtkCellArea</type></link> classes should implement this
method to receive and navigate focus in its own way particular
to how it lays out cells.</para>
<refsect3 id="gtk-cell-area-focus.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>direction</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkDirectionType"><type>GtkDirectionType</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-focus.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if focus remains inside <parameter>area</parameter>
as a result of this call.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-set-focus-cell" role="function">
<title>gtk_cell_area_set_focus_cell&#160;()</title>
<indexterm zone="gtk-cell-area-set-focus-cell"><primary>gtk_cell_area_set_focus_cell</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_set_focus_cell (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                              <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>);</programlisting>
<para>Explicitly sets the currently focused cell to <parameter>renderer</parameter>
.</para>
<para>This is generally called by implementations of
<link linkend="GtkCellAreaClass.focus"><function>GtkCellAreaClass.focus()</function></link> or <link linkend="GtkCellAreaClass.event"><function>GtkCellAreaClass.event()</function></link>,
however it can also be used to implement functions such
as <link linkend="gtk-tree-view-set-cursor-on-cell"><function>gtk_tree_view_set_cursor_on_cell()</function></link>.</para>
<refsect3 id="gtk-cell-area-set-focus-cell.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to give focus to</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-focus-cell" role="function">
<title>gtk_cell_area_get_focus_cell&#160;()</title>
<indexterm zone="gtk-cell-area-get-focus-cell"><primary>gtk_cell_area_get_focus_cell</primary></indexterm>
<programlisting language="C"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
gtk_cell_area_get_focus_cell (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>);</programlisting>
<para>Retrieves the currently focused cell for <parameter>area</parameter>
</para>
<refsect3 id="gtk-cell-area-get-focus-cell.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-get-focus-cell.returns" role="returns">
<title>Returns</title>
<para>the currently focused cell in <parameter>area</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-add-focus-sibling" role="function">
<title>gtk_cell_area_add_focus_sibling&#160;()</title>
<indexterm zone="gtk-cell-area-add-focus-sibling"><primary>gtk_cell_area_add_focus_sibling</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_add_focus_sibling (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                 <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                 <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *sibling</parameter>);</programlisting>
<para>Adds <parameter>sibling</parameter>
 to <parameter>renderer</parameter>
’s focusable area, focus will be drawn
around <parameter>renderer</parameter>
 and all of its siblings if <parameter>renderer</parameter>
 can
focus for a given row.</para>
<para>Events handled by focus siblings can also activate the given
focusable <parameter>renderer</parameter>
.</para>
<refsect3 id="gtk-cell-area-add-focus-sibling.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> expected to have focus</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>sibling</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to add to <parameter>renderer</parameter>
’s focus area</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-remove-focus-sibling" role="function">
<title>gtk_cell_area_remove_focus_sibling&#160;()</title>
<indexterm zone="gtk-cell-area-remove-focus-sibling"><primary>gtk_cell_area_remove_focus_sibling</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_remove_focus_sibling (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                    <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                    <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *sibling</parameter>);</programlisting>
<para>Removes <parameter>sibling</parameter>
 from <parameter>renderer</parameter>
’s focus sibling list
(see <link linkend="gtk-cell-area-add-focus-sibling"><function>gtk_cell_area_add_focus_sibling()</function></link>).</para>
<refsect3 id="gtk-cell-area-remove-focus-sibling.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> expected to have focus</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>sibling</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to remove from <parameter>renderer</parameter>
’s focus area</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-is-focus-sibling" role="function">
<title>gtk_cell_area_is_focus_sibling&#160;()</title>
<indexterm zone="gtk-cell-area-is-focus-sibling"><primary>gtk_cell_area_is_focus_sibling</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_cell_area_is_focus_sibling (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *sibling</parameter>);</programlisting>
<para>Returns whether <parameter>sibling</parameter>
 is one of <parameter>renderer</parameter>
’s focus siblings
(see <link linkend="gtk-cell-area-add-focus-sibling"><function>gtk_cell_area_add_focus_sibling()</function></link>).</para>
<refsect3 id="gtk-cell-area-is-focus-sibling.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> expected to have focus</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>sibling</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to check against <parameter>renderer</parameter>
’s sibling list</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-is-focus-sibling.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>sibling</parameter>
is a focus sibling of <parameter>renderer</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-focus-siblings" role="function">
<title>gtk_cell_area_get_focus_siblings&#160;()</title>
<indexterm zone="gtk-cell-area-get-focus-siblings"><primary>gtk_cell_area_get_focus_siblings</primary></indexterm>
<programlisting language="C">const <link linkend="GList"><returnvalue>GList</returnvalue></link>&#160;*
gtk_cell_area_get_focus_siblings (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                  <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>);</programlisting>
<para>Gets the focus sibling cell renderers for <parameter>renderer</parameter>
.</para>
<refsect3 id="gtk-cell-area-get-focus-siblings.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> expected to have focus</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-get-focus-siblings.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="GList"><type>GList</type></link> of <link linkend="GtkCellRenderers"><type>GtkCellRenderers</type></link>.
The returned list is internal and should not be freed. </para>
<para><emphasis role="annotation">[<acronym>element-type</acronym> GtkCellRenderer][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-focus-from-sibling" role="function">
<title>gtk_cell_area_get_focus_from_sibling&#160;()</title>
<indexterm zone="gtk-cell-area-get-focus-from-sibling"><primary>gtk_cell_area_get_focus_from_sibling</primary></indexterm>
<programlisting language="C"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
gtk_cell_area_get_focus_from_sibling (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                      <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>);</programlisting>
<para>Gets the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> which is expected to be focusable
for which <parameter>renderer</parameter>
 is, or may be a sibling.</para>
<para>This is handy for <link linkend="GtkCellArea"><type>GtkCellArea</type></link> subclasses when handling events,
after determining the renderer at the event location it can
then chose to activate the focus cell for which the event
cell may have been a sibling.</para>
<refsect3 id="gtk-cell-area-get-focus-from-sibling.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-get-focus-from-sibling.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> for which <parameter>renderer</parameter>
is a sibling, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-edited-cell" role="function">
<title>gtk_cell_area_get_edited_cell&#160;()</title>
<indexterm zone="gtk-cell-area-get-edited-cell"><primary>gtk_cell_area_get_edited_cell</primary></indexterm>
<programlisting language="C"><link linkend="GtkCellRenderer"><returnvalue>GtkCellRenderer</returnvalue></link>&#160;*
gtk_cell_area_get_edited_cell (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>);</programlisting>
<para>Gets the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> in <parameter>area</parameter>
 that is currently
being edited.</para>
<refsect3 id="gtk-cell-area-get-edited-cell.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-get-edited-cell.returns" role="returns">
<title>Returns</title>
<para>The currently edited <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-get-edit-widget" role="function">
<title>gtk_cell_area_get_edit_widget&#160;()</title>
<indexterm zone="gtk-cell-area-get-edit-widget"><primary>gtk_cell_area_get_edit_widget</primary></indexterm>
<programlisting language="C"><link linkend="GtkCellEditable"><returnvalue>GtkCellEditable</returnvalue></link>&#160;*
gtk_cell_area_get_edit_widget (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>);</programlisting>
<para>Gets the <link linkend="GtkCellEditable"><type>GtkCellEditable</type></link> widget currently used
to edit the currently edited cell.</para>
<refsect3 id="gtk-cell-area-get-edit-widget.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-get-edit-widget.returns" role="returns">
<title>Returns</title>
<para>The currently active <link linkend="GtkCellEditable"><type>GtkCellEditable</type></link> widget. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-activate-cell" role="function">
<title>gtk_cell_area_activate_cell&#160;()</title>
<indexterm zone="gtk-cell-area-activate-cell"><primary>gtk_cell_area_activate_cell</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_cell_area_activate_cell (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                             <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                             <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                             <parameter><link linkend="GdkEvent"><type>GdkEvent</type></link> *event</parameter>,
                             <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_area</parameter>,
                             <parameter><link linkend="GtkCellRendererState"><type>GtkCellRendererState</type></link> flags</parameter>);</programlisting>
<para>This is used by <link linkend="GtkCellArea"><type>GtkCellArea</type></link> subclasses when handling events
to activate cells, the base <link linkend="GtkCellArea"><type>GtkCellArea</type></link> class activates cells
for keyboard events for free in its own GtkCellArea-><link linkend="activate"><function>activate()</function></link>
implementation.</para>
<refsect3 id="gtk-cell-area-activate-cell.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> that <parameter>area</parameter>
is rendering onto</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> in <parameter>area</parameter>
to activate</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>event</para></entry>
<entry role="parameter_description"><para>the <link linkend="GdkEvent"><type>GdkEvent</type></link> for which cell activation should occur</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the <link linkend="GdkRectangle"><type>GdkRectangle</type></link> in <parameter>widget</parameter>
relative coordinates
of <parameter>renderer</parameter>
for the current row.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRendererState"><type>GtkCellRendererState</type></link> for <parameter>renderer</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-area-activate-cell.returns" role="returns">
<title>Returns</title>
<para> whether cell activation was successful</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-stop-editing" role="function">
<title>gtk_cell_area_stop_editing&#160;()</title>
<indexterm zone="gtk-cell-area-stop-editing"><primary>gtk_cell_area_stop_editing</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_stop_editing (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                            <parameter><link linkend="gboolean"><type>gboolean</type></link> canceled</parameter>);</programlisting>
<para>Explicitly stops the editing of the currently edited cell.</para>
<para>If <parameter>canceled</parameter>
 is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, the currently edited cell renderer
will emit the ::editing-canceled signal, otherwise the
the ::editing-done signal will be emitted on the current
edit widget.</para>
<para>See <link linkend="gtk-cell-area-get-edited-cell"><function>gtk_cell_area_get_edited_cell()</function></link> and <link linkend="gtk-cell-area-get-edit-widget"><function>gtk_cell_area_get_edit_widget()</function></link>.</para>
<refsect3 id="gtk-cell-area-stop-editing.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>canceled</para></entry>
<entry role="parameter_description"><para>whether editing was canceled.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-inner-cell-area" role="function">
<title>gtk_cell_area_inner_cell_area&#160;()</title>
<indexterm zone="gtk-cell-area-inner-cell-area"><primary>gtk_cell_area_inner_cell_area</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_inner_cell_area (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                               <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                               <parameter>const <link linkend="GdkRectangle"><type>GdkRectangle</type></link> *cell_area</parameter>,
                               <parameter><link linkend="GdkRectangle"><type>GdkRectangle</type></link> *inner_area</parameter>);</programlisting>
<para>This is a convenience function for <link linkend="GtkCellArea"><type>GtkCellArea</type></link> implementations
to get the inner area where a given <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> will be
rendered. It removes any padding previously added by <link linkend="gtk-cell-area-request-renderer"><function>gtk_cell_area_request_renderer()</function></link>.</para>
<refsect3 id="gtk-cell-area-inner-cell-area.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> that <parameter>area</parameter>
is rendering onto</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the <parameter>widget</parameter>
relative coordinates where one of <parameter>area</parameter>
’s cells
is to be placed</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>inner_area</para></entry>
<entry role="parameter_description"><para>the return location for the inner cell area. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-area-request-renderer" role="function">
<title>gtk_cell_area_request_renderer&#160;()</title>
<indexterm zone="gtk-cell-area-request-renderer"><primary>gtk_cell_area_request_renderer</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_area_request_renderer (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer</parameter>,
                                <parameter><link linkend="GtkOrientation"><type>GtkOrientation</type></link> orientation</parameter>,
                                <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> for_size</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> *minimum_size</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> *natural_size</parameter>);</programlisting>
<para>This is a convenience function for <link linkend="GtkCellArea"><type>GtkCellArea</type></link> implementations
to request size for cell renderers. It’s important to use this
function to request size and then use <link linkend="gtk-cell-area-inner-cell-area"><function>gtk_cell_area_inner_cell_area()</function></link>
at render and event time since this function will add padding
around the cell for focus painting.</para>
<refsect3 id="gtk-cell-area-request-renderer.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>area</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellArea"><type>GtkCellArea</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to request size for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>orientation</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkOrientation"><type>GtkOrientation</type></link> in which to request size</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> that <parameter>area</parameter>
is rendering onto</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>for_size</para></entry>
<entry role="parameter_description"><para>the allocation contextual size to request for, or -1 if
the base request for the orientation is to be returned.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum_size</para></entry>
<entry role="parameter_description"><para>location to store the minimum size, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>natural_size</para></entry>
<entry role="parameter_description"><para>location to store the natural size, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkCellArea.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkCellArea-struct" role="struct">
<title>struct GtkCellArea</title>
<indexterm zone="GtkCellArea-struct"><primary>GtkCellArea</primary></indexterm>
<programlisting language="C">struct GtkCellArea;</programlisting>
</refsect2>
<refsect2 id="GtkCellAreaClass" role="struct">
<title>struct GtkCellAreaClass</title>
<indexterm zone="GtkCellAreaClass"><primary>GtkCellAreaClass</primary></indexterm>
<programlisting language="C">struct GtkCellAreaClass {
  /* Basic methods */
  void               (* add)                             (GtkCellArea             *area,
                                                          GtkCellRenderer         *renderer);
  void               (* remove)                          (GtkCellArea             *area,
                                                          GtkCellRenderer         *renderer);
  void               (* foreach)                         (GtkCellArea             *area,
                                                          GtkCellCallback          callback,
                                                          gpointer                 callback_data);
  void               (* foreach_alloc)                   (GtkCellArea             *area,
                                                          GtkCellAreaContext      *context,
                                                          GtkWidget               *widget,
                                                          const GdkRectangle      *cell_area,
                                                          const GdkRectangle      *background_area,
                                                          GtkCellAllocCallback     callback,
                                                          gpointer                 callback_data);
  gint               (* event)                           (GtkCellArea             *area,
                                                          GtkCellAreaContext      *context,
                                                          GtkWidget               *widget,
                                                          GdkEvent                *event,
                                                          const GdkRectangle      *cell_area,
                                                          GtkCellRendererState     flags);
  void               (* snapshot)                        (GtkCellArea             *area,
                                                          GtkCellAreaContext      *context,
                                                          GtkWidget               *widget,
                                                          GtkSnapshot             *snapshot,
                                                          const GdkRectangle      *background_area,
                                                          const GdkRectangle      *cell_area,
                                                          GtkCellRendererState     flags,
                                                          gboolean                 paint_focus);
  void               (* apply_attributes)                (GtkCellArea             *area,
                                                          GtkTreeModel            *tree_model,
                                                          GtkTreeIter             *iter,
                                                          gboolean                 is_expander,
                                                          gboolean                 is_expanded);

  /* Geometry */
  GtkCellAreaContext *(* create_context)                 (GtkCellArea             *area);
  GtkCellAreaContext *(* copy_context)                   (GtkCellArea             *area,
                                                          GtkCellAreaContext      *context);
  GtkSizeRequestMode (* get_request_mode)                (GtkCellArea             *area);
  void               (* get_preferred_width)             (GtkCellArea             *area,
                                                          GtkCellAreaContext      *context,
                                                          GtkWidget               *widget,
                                                          gint                    *minimum_width,
                                                          gint                    *natural_width);
  void               (* get_preferred_height_for_width)  (GtkCellArea             *area,
                                                          GtkCellAreaContext      *context,
                                                          GtkWidget               *widget,
                                                          gint                     width,
                                                          gint                    *minimum_height,
                                                          gint                    *natural_height);
  void               (* get_preferred_height)            (GtkCellArea             *area,
                                                          GtkCellAreaContext      *context,
                                                          GtkWidget               *widget,
                                                          gint                    *minimum_height,
                                                          gint                    *natural_height);
  void               (* get_preferred_width_for_height)  (GtkCellArea             *area,
                                                          GtkCellAreaContext      *context,
                                                          GtkWidget               *widget,
                                                          gint                     height,
                                                          gint                    *minimum_width,
                                                          gint                    *natural_width);

  /* Cell Properties */
  void               (* set_cell_property)               (GtkCellArea             *area,
                                                          GtkCellRenderer         *renderer,
                                                          guint                    property_id,
                                                          const GValue            *value,
                                                          GParamSpec              *pspec);
  void               (* get_cell_property)               (GtkCellArea             *area,
                                                          GtkCellRenderer         *renderer,
                                                          guint                    property_id,
                                                          GValue                  *value,
                                                          GParamSpec              *pspec);

  /* Focus */
  gboolean           (* focus)                           (GtkCellArea             *area,
                                                          GtkDirectionType         direction);
  gboolean           (* is_activatable)                  (GtkCellArea             *area);
  gboolean           (* activate)                        (GtkCellArea             *area,
                                                          GtkCellAreaContext      *context,
                                                          GtkWidget               *widget,
                                                          const GdkRectangle      *cell_area,
                                                          GtkCellRendererState     flags,
                                                          gboolean                 edit_only);
};
</programlisting>
<refsect3 id="GtkCellAreaClass.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.add">add</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>adds a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to the area.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.remove">remove</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>removes a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> from the area.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.foreach">foreach</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>calls the <link linkend="GtkCellCallback"><type>GtkCellCallback</type></link> function on every <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> in
the area with the provided user data until the callback returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.foreach-alloc">foreach_alloc</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Calls the <link linkend="GtkCellAllocCallback"><type>GtkCellAllocCallback</type></link> function on every
<link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> in the area with the allocated area for the cell
and the provided user data until the callback returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.event">event</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Handle an event in the area, this is generally used to activate
a cell at the event location for button events but can also be used
to generically pass events to <link linkend="GtkWidgets"><type>GtkWidgets</type></link> drawn onto the area.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.snapshot">snapshot</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Actually snapshot the area’s cells to the specified rectangle,
<parameter>background_area</parameter>
should be correctly distributed to the cells
corresponding background areas.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.apply-attributes">apply_attributes</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Apply the cell attributes to the cells. This is
implemented as a signal and generally <link linkend="GtkCellArea"><type>GtkCellArea</type></link> subclasses don't
need to implement it since it is handled by the base class.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.create-context">create_context</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Creates and returns a class specific <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link>
to store cell alignment and allocation details for a said <link linkend="GtkCellArea"><type>GtkCellArea</type></link>
class.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.copy-context">copy_context</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Creates a new <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> in the same state as
the passed <parameter>context</parameter>
with any cell alignment data and allocations intact.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.get-request-mode">get_request_mode</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>This allows an area to tell its layouting widget whether
it prefers to be allocated in <link linkend="GTK-SIZE-REQUEST-HEIGHT-FOR-WIDTH:CAPS"><literal>GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH</literal></link> or
<link linkend="GTK-SIZE-REQUEST-WIDTH-FOR-HEIGHT:CAPS"><literal>GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT</literal></link> mode.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.get-preferred-width">get_preferred_width</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Calculates the minimum and natural width of the
areas cells with the current attributes applied while considering
the particular layouting details of the said <link linkend="GtkCellArea"><type>GtkCellArea</type></link>. While
requests are performed over a series of rows, alignments and overall
minimum and natural sizes should be stored in the corresponding
<link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.get-preferred-height-for-width">get_preferred_height_for_width</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Calculates the minimum and natural height
for the area if the passed <parameter>context</parameter>
would be allocated the given width.
When implementing this virtual method it is safe to assume that <parameter>context</parameter>
has already stored the aligned cell widths for every <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> row
that <parameter>context</parameter>
will be allocated for since this information was stored
at <link linkend="GtkCellAreaClass.get-preferred-width"><function>GtkCellAreaClass.get_preferred_width()</function></link> time. This virtual method
should also store any necessary alignments of cell heights for the
case that the context is allocated a height.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.get-preferred-height">get_preferred_height</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Calculates the minimum and natural height of the
areas cells with the current attributes applied. Essentially this is
the same as <link linkend="GtkCellAreaClass.get-preferred-width"><function>GtkCellAreaClass.get_preferred_width()</function></link> only for areas
that are being requested as <link linkend="GTK-SIZE-REQUEST-WIDTH-FOR-HEIGHT:CAPS"><literal>GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT</literal></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.get-preferred-width-for-height">get_preferred_width_for_height</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Calculates the minimum and natural width
for the area if the passed <parameter>context</parameter>
would be allocated the given
height. The same as <link linkend="GtkCellAreaClass.get-preferred-height-for-width"><function>GtkCellAreaClass.get_preferred_height_for_width()</function></link>
only for handling requests in the <link linkend="GTK-SIZE-REQUEST-WIDTH-FOR-HEIGHT:CAPS"><literal>GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT</literal></link>
mode.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.set-cell-property">set_cell_property</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>This should be implemented to handle changes in child
cell properties for a given <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> that were previously
installed on the <link linkend="GtkCellAreaClass"><type>GtkCellAreaClass</type></link> with <link linkend="gtk-cell-area-class-install-cell-property"><function>gtk_cell_area_class_install_cell_property()</function></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.get-cell-property">get_cell_property</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>This should be implemented to report the values of
child cell properties for a given child <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.focus">focus</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>This virtual method should be implemented to navigate focus from
cell to cell inside the <link linkend="GtkCellArea"><type>GtkCellArea</type></link>. The <link linkend="GtkCellArea"><type>GtkCellArea</type></link> should move
focus from cell to cell inside the area and return <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if focus
logically leaves the area with the following exceptions: When the
area contains no activatable cells, the entire area recieves focus.
Focus should not be given to cells that are actually “focus siblings”
of other sibling cells (see <link linkend="gtk-cell-area-get-focus-from-sibling"><function>gtk_cell_area_get_focus_from_sibling()</function></link>).
Focus is set by calling <link linkend="gtk-cell-area-set-focus-cell"><function>gtk_cell_area_set_focus_cell()</function></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.is-activatable">is_activatable</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Returns whether the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> can respond to
<link linkend="GtkCellAreaClass.activate"><function>GtkCellAreaClass.activate()</function></link>, usually this does not need to be
implemented since the base class takes care of this however it can
be enhanced if the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> subclass can handle activation in
other ways than activating its <link linkend="GtkCellRenderers"><type>GtkCellRenderers</type></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkCellAreaClass.activate">activate</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>This is called when the layouting widget rendering the
<link linkend="GtkCellArea"><type>GtkCellArea</type></link> activates the focus cell (see <link linkend="gtk-cell-area-get-focus-cell"><function>gtk_cell_area_get_focus_cell()</function></link>).</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>

</refsect1>
<refsect1 id="GtkCellArea.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkCellArea--edit-widget" role="property"><title>The <literal>“edit-widget”</literal> property</title>
<indexterm zone="GtkCellArea--edit-widget"><primary>GtkCellArea:edit-widget</primary></indexterm>
<programlisting>  “edit-widget”              <link linkend="GtkCellEditable"><type>GtkCellEditable</type></link>&#160;*</programlisting>
<para>The widget currently editing the edited cell</para>
<para>This property is read-only and only changes as
a result of a call <link linkend="gtk-cell-area-activate-cell"><function>gtk_cell_area_activate_cell()</function></link>.</para>
<para>Owner: GtkCellArea</para>
<para>Flags: Read</para>
</refsect2>
<refsect2 id="GtkCellArea--edited-cell" role="property"><title>The <literal>“edited-cell”</literal> property</title>
<indexterm zone="GtkCellArea--edited-cell"><primary>GtkCellArea:edited-cell</primary></indexterm>
<programlisting>  “edited-cell”              <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>&#160;*</programlisting>
<para>The cell in the area that is currently edited</para>
<para>This property is read-only and only changes as
a result of a call <link linkend="gtk-cell-area-activate-cell"><function>gtk_cell_area_activate_cell()</function></link>.</para>
<para>Owner: GtkCellArea</para>
<para>Flags: Read</para>
</refsect2>
<refsect2 id="GtkCellArea--focus-cell" role="property"><title>The <literal>“focus-cell”</literal> property</title>
<indexterm zone="GtkCellArea--focus-cell"><primary>GtkCellArea:focus-cell</primary></indexterm>
<programlisting>  “focus-cell”               <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>&#160;*</programlisting>
<para>The cell in the area that currently has focus</para>
<para>Owner: GtkCellArea</para>
<para>Flags: Read / Write</para>
</refsect2>

</refsect1>
<refsect1 id="GtkCellArea.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkCellArea-add-editable" role="signal"><title>The <literal>“add-editable”</literal> signal</title>
<indexterm zone="GtkCellArea-add-editable"><primary>GtkCellArea::add-editable</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkCellArea"><type>GtkCellArea</type></link>     *area,
               <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer,
               <link linkend="GtkCellEditable"><type>GtkCellEditable</type></link> *editable,
               <link linkend="GdkRectangle"><type>GdkRectangle</type></link>    *cell_area,
               <link linkend="gchar"><type>gchar</type></link>           *path,
               <link linkend="gpointer"><type>gpointer</type></link>         user_data)</programlisting>
<para>Indicates that editing has started on <parameter>renderer</parameter>
 and that <parameter>editable</parameter>

should be added to the owning cell-layouting widget at <parameter>cell_area</parameter>
.</para>
<refsect3 id="GtkCellArea-add-editable.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>area</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> where editing started</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> that started the edited</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>editable</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellEditable"><type>GtkCellEditable</type></link> widget to add</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell_area</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> relative <link linkend="GdkRectangle"><type>GdkRectangle</type></link> coordinates
where <parameter>editable</parameter>
should be added</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkTreePath"><type>GtkTreePath</type></link> string this edit was initiated for</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-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkCellArea-apply-attributes" role="signal"><title>The <literal>“apply-attributes”</literal> signal</title>
<indexterm zone="GtkCellArea-apply-attributes"><primary>GtkCellArea::apply-attributes</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkCellArea"><type>GtkCellArea</type></link>  *area,
               <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> *model,
               <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link>  *iter,
               <link linkend="gboolean"><type>gboolean</type></link>      is_expander,
               <link linkend="gboolean"><type>gboolean</type></link>      is_expanded,
               <link linkend="gpointer"><type>gpointer</type></link>      user_data)</programlisting>
<para>This signal is emitted whenever applying attributes to <parameter>area</parameter>
 from <parameter>model</parameter>
</para>
<refsect3 id="GtkCellArea-apply-attributes.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>area</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> to apply the attributes to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>model</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> to apply the attributes from</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>iter</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link> indicating which row to apply the attributes of</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>is_expander</para></entry>
<entry role="parameter_description"><para>whether the view shows children for this row</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>is_expanded</para></entry>
<entry role="parameter_description"><para>whether the view is currently showing the children of this row</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-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkCellArea-focus-changed" role="signal"><title>The <literal>“focus-changed”</literal> signal</title>
<indexterm zone="GtkCellArea-focus-changed"><primary>GtkCellArea::focus-changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkCellArea"><type>GtkCellArea</type></link>     *area,
               <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer,
               <link linkend="gchar"><type>gchar</type></link>           *path,
               <link linkend="gpointer"><type>gpointer</type></link>         user_data)</programlisting>
<para>Indicates that focus changed on this <parameter>area</parameter>
. This signal
is emitted either as a result of focus handling or event
handling.</para>
<para>It's possible that the signal is emitted even if the
currently focused renderer did not change, this is
because focus may change to the same renderer in the
same cell area for a different row of data.</para>
<refsect3 id="GtkCellArea-focus-changed.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>area</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> where focus changed</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> that has focus</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>the current <link linkend="GtkTreePath"><type>GtkTreePath</type></link> string set for <parameter>area</parameter>
</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-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkCellArea-remove-editable" role="signal"><title>The <literal>“remove-editable”</literal> signal</title>
<indexterm zone="GtkCellArea-remove-editable"><primary>GtkCellArea::remove-editable</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkCellArea"><type>GtkCellArea</type></link>     *area,
               <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *renderer,
               <link linkend="GtkCellEditable"><type>GtkCellEditable</type></link> *editable,
               <link linkend="gpointer"><type>gpointer</type></link>         user_data)</programlisting>
<para>Indicates that editing finished on <parameter>renderer</parameter>
 and that <parameter>editable</parameter>

should be removed from the owning cell-layouting widget.</para>
<refsect3 id="GtkCellArea-remove-editable.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>area</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> where editing finished</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>renderer</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> that finished editeding</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>editable</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellEditable"><type>GtkCellEditable</type></link> widget to remove</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-FIRST:CAPS">Run First</link></para>
</refsect2>
</refsect1>

</refentry>
