<?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="GtkCellView">
<refmeta>
<refentrytitle role="top_of_page" id="GtkCellView.top_of_page">GtkCellView</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkCellView</refname>
<refpurpose>A widget displaying a single row of a GtkTreeModel</refpurpose>
</refnamediv>

<refsect1 id="GtkCellView.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="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-view-new">gtk_cell_view_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-view-new-with-context">gtk_cell_view_new_with_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-view-new-with-text">gtk_cell_view_new_with_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-view-new-with-markup">gtk_cell_view_new_with_markup</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-view-new-with-texture">gtk_cell_view_new_with_texture</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-view-set-model">gtk_cell_view_set_model</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkTreeModel"><returnvalue>GtkTreeModel</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-view-get-model">gtk_cell_view_get_model</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-view-set-displayed-row">gtk_cell_view_set_displayed_row</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkTreePath"><returnvalue>GtkTreePath</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-cell-view-get-displayed-row">gtk_cell_view_get_displayed_row</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-view-set-draw-sensitive">gtk_cell_view_set_draw_sensitive</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-view-get-draw-sensitive">gtk_cell_view_get_draw_sensitive</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-view-set-fit-model">gtk_cell_view_set_fit_model</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-view-get-fit-model">gtk_cell_view_get_fit_model</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellView.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="GtkCellArea"><type>GtkCellArea</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellView--cell-area">cell-area</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellView--cell-area-context">cell-area-context</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellView--draw-sensitive">draw-sensitive</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkCellView--fit-model">fit-model</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkCellView--model">model</link></entry><entry role="property_flags">Read / Write</entry></row>

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

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkCellView.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkWidget">GtkWidget</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkCellView
</screen>
</refsect1>
<refsect1 id="GtkCellView.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkCellView implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link>,  <link linkend="GtkCellLayout">GtkCellLayout</link> and  <link linkend="GtkOrientable">GtkOrientable</link>.</para>

</refsect1>

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

<refsect1 id="GtkCellView.description" role="desc">
<title role="desc.title">Description</title>
<para>A <link linkend="GtkCellView"><type>GtkCellView</type></link> displays a single row of a <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> using a <link linkend="GtkCellArea"><type>GtkCellArea</type></link>
and <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link>. A <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> can be provided to the 
<link linkend="GtkCellView"><type>GtkCellView</type></link> at construction time in order to keep the cellview in context
of a group of cell views, this ensures that the renderers displayed will
be properly aligned with eachother (like the aligned cells in the menus
of <link linkend="GtkComboBox"><type>GtkComboBox</type></link>).</para>
<para><link linkend="GtkCellView"><type>GtkCellView</type></link> is <link linkend="GtkOrientable"><type>GtkOrientable</type></link> in order to decide in which orientation
the underlying <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> should be allocated. Taking the <link linkend="GtkComboBox"><type>GtkComboBox</type></link>
menu as an example, cellviews should be oriented horizontally if the menus are
listed top-to-bottom and thus all share the same width but may have separate
individual heights (left-to-right menus should be allocated vertically since
they all share the same height but may have variable widths).</para>
<refsect2><title>CSS nodes</title><para>GtkCellView has a single CSS node with name cellview.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkCellView.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-cell-view-new" role="function">
<title>gtk_cell_view_new&#160;()</title>
<indexterm zone="gtk-cell-view-new"><primary>gtk_cell_view_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_cell_view_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new <link linkend="GtkCellView"><type>GtkCellView</type></link> widget.</para>
<refsect3 id="gtk-cell-view-new.returns" role="returns">
<title>Returns</title>
<para> A newly created <link linkend="GtkCellView"><type>GtkCellView</type></link> widget.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-new-with-context" role="function">
<title>gtk_cell_view_new_with_context&#160;()</title>
<indexterm zone="gtk-cell-view-new-with-context"><primary>gtk_cell_view_new_with_context</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_cell_view_new_with_context (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>,
                                <parameter><link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> *context</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkCellView"><type>GtkCellView</type></link> widget with a specific <link linkend="GtkCellArea"><type>GtkCellArea</type></link>
to layout cells and a specific <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link>.</para>
<para>Specifying the same context for a handfull of cells lets
the underlying area synchronize the geometry for those cells,
in this way alignments with cellviews for other rows are
possible.</para>
<refsect3 id="gtk-cell-view-new-with-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>the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> to layout cells</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 which to calculate cell geometry</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-view-new-with-context.returns" role="returns">
<title>Returns</title>
<para> A newly created <link linkend="GtkCellView"><type>GtkCellView</type></link> widget.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-new-with-text" role="function">
<title>gtk_cell_view_new_with_text&#160;()</title>
<indexterm zone="gtk-cell-view-new-with-text"><primary>gtk_cell_view_new_with_text</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_cell_view_new_with_text (<parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkCellView"><type>GtkCellView</type></link> widget, adds a <link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link> 
to it, and makes it show <parameter>text</parameter>
.</para>
<refsect3 id="gtk-cell-view-new-with-text.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>text</para></entry>
<entry role="parameter_description"><para>the text to display in the cell view</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-view-new-with-text.returns" role="returns">
<title>Returns</title>
<para> A newly created <link linkend="GtkCellView"><type>GtkCellView</type></link> widget.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-new-with-markup" role="function">
<title>gtk_cell_view_new_with_markup&#160;()</title>
<indexterm zone="gtk-cell-view-new-with-markup"><primary>gtk_cell_view_new_with_markup</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_cell_view_new_with_markup (<parameter>const <link linkend="gchar"><type>gchar</type></link> *markup</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkCellView"><type>GtkCellView</type></link> widget, adds a <link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link> 
to it, and makes it show <parameter>markup</parameter>
. The text can be
marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.</para>
<refsect3 id="gtk-cell-view-new-with-markup.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>markup</para></entry>
<entry role="parameter_description"><para>the text to display in the cell view</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-view-new-with-markup.returns" role="returns">
<title>Returns</title>
<para> A newly created <link linkend="GtkCellView"><type>GtkCellView</type></link> widget.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-new-with-texture" role="function">
<title>gtk_cell_view_new_with_texture&#160;()</title>
<indexterm zone="gtk-cell-view-new-with-texture"><primary>gtk_cell_view_new_with_texture</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_cell_view_new_with_texture (<parameter><link linkend="GdkTexture"><type>GdkTexture</type></link> *texture</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkCellView"><type>GtkCellView</type></link> widget, adds a <link linkend="GtkCellRendererPixbuf"><type>GtkCellRendererPixbuf</type></link>
to it, and makes it show <parameter>texture</parameter>
.</para>
<refsect3 id="gtk-cell-view-new-with-texture.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>texture</para></entry>
<entry role="parameter_description"><para>the image to display in the cell view</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-view-new-with-texture.returns" role="returns">
<title>Returns</title>
<para> A newly created <link linkend="GtkCellView"><type>GtkCellView</type></link> widget.</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-set-model" role="function">
<title>gtk_cell_view_set_model&#160;()</title>
<indexterm zone="gtk-cell-view-set-model"><primary>gtk_cell_view_set_model</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_view_set_model (<parameter><link linkend="GtkCellView"><type>GtkCellView</type></link> *cell_view</parameter>,
                         <parameter><link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> *model</parameter>);</programlisting>
<para>Sets the model for <parameter>cell_view</parameter>
.  If <parameter>cell_view</parameter>
 already has a model
set, it will remove it before setting the new model.  If <parameter>model</parameter>
 is
<link linkend="NULL:CAPS"><literal>NULL</literal></link>, then it will unset the old model.</para>
<refsect3 id="gtk-cell-view-set-model.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>cell_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellView"><type>GtkCellView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>model</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-get-model" role="function">
<title>gtk_cell_view_get_model&#160;()</title>
<indexterm zone="gtk-cell-view-get-model"><primary>gtk_cell_view_get_model</primary></indexterm>
<programlisting language="C"><link linkend="GtkTreeModel"><returnvalue>GtkTreeModel</returnvalue></link>&#160;*
gtk_cell_view_get_model (<parameter><link linkend="GtkCellView"><type>GtkCellView</type></link> *cell_view</parameter>);</programlisting>
<para>Returns the model for <parameter>cell_view</parameter>
. If no model is used <link linkend="NULL:CAPS"><literal>NULL</literal></link> is
returned.</para>
<refsect3 id="gtk-cell-view-get-model.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>cell_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellView"><type>GtkCellView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-view-get-model.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> used 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-view-set-displayed-row" role="function">
<title>gtk_cell_view_set_displayed_row&#160;()</title>
<indexterm zone="gtk-cell-view-set-displayed-row"><primary>gtk_cell_view_set_displayed_row</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_view_set_displayed_row (<parameter><link linkend="GtkCellView"><type>GtkCellView</type></link> *cell_view</parameter>,
                                 <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>);</programlisting>
<para>Sets the row of the model that is currently displayed
by the <link linkend="GtkCellView"><type>GtkCellView</type></link>. If the path is unset, then the
contents of the cellview “stick” at their last value;
this is not normally a desired result, but may be
a needed intermediate state if say, the model for
the <link linkend="GtkCellView"><type>GtkCellView</type></link> becomes temporarily empty.</para>
<refsect3 id="gtk-cell-view-set-displayed-row.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>cell_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellView"><type>GtkCellView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to unset. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-get-displayed-row" role="function">
<title>gtk_cell_view_get_displayed_row&#160;()</title>
<indexterm zone="gtk-cell-view-get-displayed-row"><primary>gtk_cell_view_get_displayed_row</primary></indexterm>
<programlisting language="C"><link linkend="GtkTreePath"><returnvalue>GtkTreePath</returnvalue></link>&#160;*
gtk_cell_view_get_displayed_row (<parameter><link linkend="GtkCellView"><type>GtkCellView</type></link> *cell_view</parameter>);</programlisting>
<para>Returns a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> referring to the currently 
displayed row. If no row is currently displayed, 
<link linkend="NULL:CAPS"><literal>NULL</literal></link> is returned.</para>
<refsect3 id="gtk-cell-view-get-displayed-row.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>cell_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellView"><type>GtkCellView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-view-get-displayed-row.returns" role="returns">
<title>Returns</title>
<para>the currently displayed row or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-set-draw-sensitive" role="function">
<title>gtk_cell_view_set_draw_sensitive&#160;()</title>
<indexterm zone="gtk-cell-view-set-draw-sensitive"><primary>gtk_cell_view_set_draw_sensitive</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_view_set_draw_sensitive (<parameter><link linkend="GtkCellView"><type>GtkCellView</type></link> *cell_view</parameter>,
                                  <parameter><link linkend="gboolean"><type>gboolean</type></link> draw_sensitive</parameter>);</programlisting>
<para>Sets whether <parameter>cell_view</parameter>
 should draw all of its
cells in a sensitive state, this is used by <link linkend="GtkComboBox"><type>GtkComboBox</type></link> menus
to ensure that rows with insensitive cells that contain
children appear sensitive in the parent menu item.</para>
<refsect3 id="gtk-cell-view-set-draw-sensitive.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>cell_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellView"><type>GtkCellView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>draw_sensitive</para></entry>
<entry role="parameter_description"><para>whether to draw all cells in a sensitive state.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-get-draw-sensitive" role="function">
<title>gtk_cell_view_get_draw_sensitive&#160;()</title>
<indexterm zone="gtk-cell-view-get-draw-sensitive"><primary>gtk_cell_view_get_draw_sensitive</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_cell_view_get_draw_sensitive (<parameter><link linkend="GtkCellView"><type>GtkCellView</type></link> *cell_view</parameter>);</programlisting>
<para>Gets whether <parameter>cell_view</parameter>
 is configured to draw all of its
cells in a sensitive state.</para>
<refsect3 id="gtk-cell-view-get-draw-sensitive.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>cell_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellView"><type>GtkCellView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-view-get-draw-sensitive.returns" role="returns">
<title>Returns</title>
<para> whether <parameter>cell_view</parameter>
draws all of its
cells in a sensitive state</para>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-set-fit-model" role="function">
<title>gtk_cell_view_set_fit_model&#160;()</title>
<indexterm zone="gtk-cell-view-set-fit-model"><primary>gtk_cell_view_set_fit_model</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_cell_view_set_fit_model (<parameter><link linkend="GtkCellView"><type>GtkCellView</type></link> *cell_view</parameter>,
                             <parameter><link linkend="gboolean"><type>gboolean</type></link> fit_model</parameter>);</programlisting>
<para>Sets whether <parameter>cell_view</parameter>
 should request space to fit the entire <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>.</para>
<para>This is used by <link linkend="GtkComboBox"><type>GtkComboBox</type></link> to ensure that the cell view displayed on
the combo box’s button always gets enough space and does not resize
when selection changes.</para>
<refsect3 id="gtk-cell-view-set-fit-model.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>cell_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellView"><type>GtkCellView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>fit_model</para></entry>
<entry role="parameter_description"><para>whether <parameter>cell_view</parameter>
should request space for the whole model.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-cell-view-get-fit-model" role="function">
<title>gtk_cell_view_get_fit_model&#160;()</title>
<indexterm zone="gtk-cell-view-get-fit-model"><primary>gtk_cell_view_get_fit_model</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_cell_view_get_fit_model (<parameter><link linkend="GtkCellView"><type>GtkCellView</type></link> *cell_view</parameter>);</programlisting>
<para>Gets whether <parameter>cell_view</parameter>
 is configured to request space
to fit the entire <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>.</para>
<refsect3 id="gtk-cell-view-get-fit-model.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>cell_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellView"><type>GtkCellView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-cell-view-get-fit-model.returns" role="returns">
<title>Returns</title>
<para> whether <parameter>cell_view</parameter>
requests space to fit
the entire <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>.</para>
</refsect3></refsect2>

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

</refsect1>
<refsect1 id="GtkCellView.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkCellView--cell-area" role="property"><title>The <literal>“cell-area”</literal> property</title>
<indexterm zone="GtkCellView--cell-area"><primary>GtkCellView:cell-area</primary></indexterm>
<programlisting>  “cell-area”                <link linkend="GtkCellArea"><type>GtkCellArea</type></link>&#160;*</programlisting>
<para>The <link linkend="GtkCellArea"><type>GtkCellArea</type></link> rendering cells</para>
<para>If no area is specified when creating the cell view with <link linkend="gtk-cell-view-new-with-context"><function>gtk_cell_view_new_with_context()</function></link>

a horizontally oriented <link linkend="GtkCellAreaBox"><type>GtkCellAreaBox</type></link> will be used.</para>
<para>since 3.0</para>
<para>Owner: GtkCellView</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
</refsect2>
<refsect2 id="GtkCellView--cell-area-context" role="property"><title>The <literal>“cell-area-context”</literal> property</title>
<indexterm zone="GtkCellView--cell-area-context"><primary>GtkCellView:cell-area-context</primary></indexterm>
<programlisting>  “cell-area-context”        <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link>&#160;*</programlisting>
<para>The <link linkend="GtkCellAreaContext"><type>GtkCellAreaContext</type></link> used to compute the geometry of the cell view.</para>
<para>A group of cell views can be assigned the same context in order to
ensure the sizes and cell alignments match across all the views with
the same context.</para>
<para><link linkend="GtkComboBox"><type>GtkComboBox</type></link> menus uses this to assign the same context to all cell views
in the menu items for a single menu (each submenu creates its own
context since the size of each submenu does not depend on parent
or sibling menus).</para>
<para>since 3.0</para>
<para>Owner: GtkCellView</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
</refsect2>
<refsect2 id="GtkCellView--draw-sensitive" role="property"><title>The <literal>“draw-sensitive”</literal> property</title>
<indexterm zone="GtkCellView--draw-sensitive"><primary>GtkCellView:draw-sensitive</primary></indexterm>
<programlisting>  “draw-sensitive”           <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether all cells should be draw as sensitive for this view regardless
of the actual cell properties (used to make menus with submenus appear
sensitive when the items in submenus might be insensitive).</para>
<para>since 3.0</para>
<para>Owner: GtkCellView</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellView--fit-model" role="property"><title>The <literal>“fit-model”</literal> property</title>
<indexterm zone="GtkCellView--fit-model"><primary>GtkCellView:fit-model</primary></indexterm>
<programlisting>  “fit-model”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the view should request enough space to always fit
the size of every row in the model (used by the combo box to
ensure the combo box size doesnt change when different items
are selected).</para>
<para>since 3.0</para>
<para>Owner: GtkCellView</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCellView--model" role="property"><title>The <literal>“model”</literal> property</title>
<indexterm zone="GtkCellView--model"><primary>GtkCellView:model</primary></indexterm>
<programlisting>  “model”                    <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>&#160;*</programlisting>
<para>The model for cell view</para>
<para>since 2.10</para>
<para>Owner: GtkCellView</para>
<para>Flags: Read / Write</para>
</refsect2>

</refsect1>

</refentry>
