<refentry id="GtkTreeViewColumn">
<refmeta>
<refentrytitle>GtkTreeViewColumn</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkTreeViewColumn</refname><refpurpose>A visible column in a <link linkend="GtkTreeView">GtkTreeView</link> widget</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

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


enum        <link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link>;
void        (<link linkend="GtkTreeCellDataFunc">*GtkTreeCellDataFunc</link>)          (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                             <link linkend="GtkTreeModel">GtkTreeModel</link> *tree_model,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *iter,
                                             <link linkend="gpointer">gpointer</link> data);
struct      <link linkend="GtkTreeViewColumn-struct">GtkTreeViewColumn</link>;
<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>* <link linkend="gtk-tree-view-column-new">gtk_tree_view_column_new</link> (void);
<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>* <link linkend="gtk-tree-view-column-new-with-attributes">gtk_tree_view_column_new_with_attributes</link>
                                            (const <link linkend="gchar">gchar</link> *title,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                             ...);
void        <link linkend="gtk-tree-view-column-pack-start">gtk_tree_view_column_pack_start</link> (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                             <link linkend="gboolean">gboolean</link> expand);
void        <link linkend="gtk-tree-view-column-pack-end">gtk_tree_view_column_pack_end</link>   (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                             <link linkend="gboolean">gboolean</link> expand);
void        <link linkend="gtk-tree-view-column-clear">gtk_tree_view_column_clear</link>      (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
<link linkend="GList">GList</link>*      <link linkend="gtk-tree-view-column-get-cell-renderers">gtk_tree_view_column_get_cell_renderers</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-add-attribute">gtk_tree_view_column_add_attribute</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer,
                                             const <link linkend="gchar">gchar</link> *attribute,
                                             <link linkend="gint">gint</link> column);
void        <link linkend="gtk-tree-view-column-set-attributes">gtk_tree_view_column_set_attributes</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer,
                                             ...);
void        <link linkend="gtk-tree-view-column-set-cell-data-func">gtk_tree_view_column_set_cell_data_func</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer,
                                             <link linkend="GtkTreeCellDataFunc">GtkTreeCellDataFunc</link> func,
                                             <link linkend="gpointer">gpointer</link> func_data,
                                             <link linkend="GtkDestroyNotify">GtkDestroyNotify</link> destroy);
void        <link linkend="gtk-tree-view-column-clear-attributes">gtk_tree_view_column_clear_attributes</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer);
void        <link linkend="gtk-tree-view-column-set-spacing">gtk_tree_view_column_set_spacing</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> spacing);
<link linkend="gint">gint</link>        <link linkend="gtk-tree-view-column-get-spacing">gtk_tree_view_column_get_spacing</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-visible">gtk_tree_view_column_set_visible</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> visible);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-tree-view-column-get-visible">gtk_tree_view_column_get_visible</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-resizable">gtk_tree_view_column_set_resizable</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> resizable);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-tree-view-column-get-resizable">gtk_tree_view_column_get_resizable</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-sizing">gtk_tree_view_column_set_sizing</link> (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link> type);
<link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link> <link linkend="gtk-tree-view-column-get-sizing">gtk_tree_view_column_get_sizing</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
<link linkend="gint">gint</link>        <link linkend="gtk-tree-view-column-get-width">gtk_tree_view_column_get_width</link>  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
<link linkend="gint">gint</link>        <link linkend="gtk-tree-view-column-get-fixed-width">gtk_tree_view_column_get_fixed_width</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-fixed-width">gtk_tree_view_column_set_fixed_width</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> fixed_width);
void        <link linkend="gtk-tree-view-column-set-min-width">gtk_tree_view_column_set_min_width</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> min_width);
<link linkend="gint">gint</link>        <link linkend="gtk-tree-view-column-get-min-width">gtk_tree_view_column_get_min_width</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-max-width">gtk_tree_view_column_set_max_width</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> max_width);
<link linkend="gint">gint</link>        <link linkend="gtk-tree-view-column-get-max-width">gtk_tree_view_column_get_max_width</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-clicked">gtk_tree_view_column_clicked</link>    (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-title">gtk_tree_view_column_set_title</link>  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             const <link linkend="gchar">gchar</link> *title);
G_CONST_RETURN <link linkend="gchar">gchar</link>* <link linkend="gtk-tree-view-column-get-title">gtk_tree_view_column_get_title</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-clickable">gtk_tree_view_column_set_clickable</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> clickable);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-tree-view-column-get-clickable">gtk_tree_view_column_get_clickable</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-widget">gtk_tree_view_column_set_widget</link> (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkWidget">GtkWidget</link> *widget);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-tree-view-column-get-widget">gtk_tree_view_column_get_widget</link> (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-alignment">gtk_tree_view_column_set_alignment</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gfloat">gfloat</link> xalign);
<link linkend="gfloat">gfloat</link>      <link linkend="gtk-tree-view-column-get-alignment">gtk_tree_view_column_get_alignment</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-reorderable">gtk_tree_view_column_set_reorderable</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> reorderable);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-tree-view-column-get-reorderable">gtk_tree_view_column_get_reorderable</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-sort-column-id">gtk_tree_view_column_set_sort_column_id</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> sort_column_id);
<link linkend="gint">gint</link>        <link linkend="gtk-tree-view-column-get-sort-column-id">gtk_tree_view_column_get_sort_column_id</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-sort-indicator">gtk_tree_view_column_set_sort_indicator</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> setting);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-tree-view-column-get-sort-indicator">gtk_tree_view_column_get_sort_indicator</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-set-sort-order">gtk_tree_view_column_set_sort_order</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkSortType">GtkSortType</link> order);
<link linkend="GtkSortType">GtkSortType</link> <link linkend="gtk-tree-view-column-get-sort-order">gtk_tree_view_column_get_sort_order</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
void        <link linkend="gtk-tree-view-column-cell-set-cell-data">gtk_tree_view_column_cell_set_cell_data</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkTreeModel">GtkTreeModel</link> *tree_model,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *iter,
                                             <link linkend="gboolean">gboolean</link> is_expander,
                                             <link linkend="gboolean">gboolean</link> is_expanded);
void        <link linkend="gtk-tree-view-column-cell-get-size">gtk_tree_view_column_cell_get_size</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GdkRectangle">GdkRectangle</link> *cell_area,
                                             <link linkend="gint">gint</link> *x_offset,
                                             <link linkend="gint">gint</link> *y_offset,
                                             <link linkend="gint">gint</link> *width,
                                             <link linkend="gint">gint</link> *height);
<link linkend="gboolean">gboolean</link>    <link linkend="gtk-tree-view-column-cell-is-visible">gtk_tree_view_column_cell_is_visible</link>
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);


</synopsis>
</refsynopsisdiv>

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

  <link linkend="GObject">GObject</link>
   +----<link linkend="GtkObject">GtkObject</link>
         +----GtkTreeViewColumn
</synopsis>

</refsect1>

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

  &quot;<link linkend="GtkTreeViewColumn--visible">visible</link>&quot;              <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--resizable">resizable</link>&quot;            <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--width">width</link>&quot;                <link linkend="gint">gint</link>                 : Read
  &quot;<link linkend="GtkTreeViewColumn--sizing">sizing</link>&quot;               <link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link> : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--fixed-width">fixed-width</link>&quot;          <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--min-width">min-width</link>&quot;            <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--max-width">max-width</link>&quot;            <link linkend="gint">gint</link>                 : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--title">title</link>&quot;                <link linkend="gchararray">gchararray</link>           : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--clickable">clickable</link>&quot;            <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--widget">widget</link>&quot;               <link linkend="GtkWidget">GtkWidget</link>            : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--alignment">alignment</link>&quot;            <link linkend="gfloat">gfloat</link>               : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--reorderable">reorderable</link>&quot;          <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--sort-indicator">sort-indicator</link>&quot;       <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--sort-order">sort-order</link>&quot;           <link linkend="GtkSortType">GtkSortType</link>          : Read / Write
</synopsis>
</refsect1>

<refsect1>
<title>Signal Prototypes</title>
<synopsis>

&quot;<link linkend="GtkTreeViewColumn-clicked">clicked</link>&quot;   void        user_function      (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *treeviewcolumn,
                                            <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsect1>


<refsect1>
<title>Description</title>
<para>
The GtkTreeViewColumn object is a visible column in a <link linkend="GtkTreeView">GtkTreeView</link>
widget.  It determines the geometry, type 
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GtkTreeViewColumnSizing">enum GtkTreeViewColumnSizing</title>
<programlisting>typedef enum
{
  GTK_TREE_VIEW_COLUMN_GROW_ONLY,
  GTK_TREE_VIEW_COLUMN_AUTOSIZE,
  GTK_TREE_VIEW_COLUMN_FIXED
} GtkTreeViewColumnSizing;
</programlisting>
<para>
The sizing method the column uses to determine it's width.  Please note
that <parameter>GTK_TREE_VIEW_COLUMN_AUTOSIZE</parameter> are inefficient for large views, and
can make columns appear choppy.
</para><informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><literal>GTK_TREE_VIEW_COLUMN_GROW_ONLY</literal></entry>
<entry>Columns only get bigger in reaction to changes in the model
</entry>
</row>
<row>
<entry><literal>GTK_TREE_VIEW_COLUMN_AUTOSIZE</literal></entry>
<entry>Columns resize to be the optimal size everytime the model changes.
</entry>
</row>
<row>
<entry><literal>GTK_TREE_VIEW_COLUMN_FIXED</literal></entry>
<entry>Columns are a fixed numbers of pixels wide.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkTreeCellDataFunc">GtkTreeCellDataFunc ()</title>
<programlisting>void        (*GtkTreeCellDataFunc)          (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                             <link linkend="GtkTreeModel">GtkTreeModel</link> *tree_model,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *iter,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
A function to set the properties of a cell instead of just using the
straight mapping between the cell and the model.  This is useful for
customizing the cell renderer.  For example, a function might get an
integer from the <parameter>tree_model</parameter>, and render it to the "text" attribute of
"cell" by converting it to its written equivilent.  This is set by
calling <link linkend="gtk-tree-view-column-set-cell-data-func">gtk_tree_view_column_set_cell_data_func</link>()
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry>A <link linkend="GtkTreeColumn">GtkTreeColumn</link>
</entry></row>
<row><entry align="right"><parameter>cell</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCellRenderer">GtkCellRenderer</link> that is being rendered by <parameter>tree_column</parameter>
</entry></row>
<row><entry align="right"><parameter>tree_model</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkTreeModel">GtkTreeModel</link> being rendered
</entry></row>
<row><entry align="right"><parameter>iter</parameter>&nbsp;:</entry>
<entry>A <link linkend="GtkTreeIter">GtkTreeIter</link> of the current row rendered
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry>user data


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkTreeViewColumn-struct">struct GtkTreeViewColumn</title>
<programlisting>struct GtkTreeViewColumn;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-new">gtk_tree_view_column_new ()</title>
<programlisting><link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>* gtk_tree_view_column_new (void);</programlisting>
<para>
Creates a new <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A newly created <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-new-with-attributes">gtk_tree_view_column_new_with_attributes ()</title>
<programlisting><link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>* gtk_tree_view_column_new_with_attributes
                                            (const <link linkend="gchar">gchar</link> *title,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                             ...);</programlisting>
<para>
Creates a new <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> with a number of default values.  This is
equivalent to calling <link linkend="gtk-tree-view-column-set-title">gtk_tree_view_column_set_title</link>(),
<link linkend="gtk-tree-view-column-pack-start">gtk_tree_view_column_pack_start</link>(), and
<link linkend="gtk-tree-view-column-set-attributes">gtk_tree_view_column_set_attributes</link>() on the newly created <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</para>
<para>
Here's a simple example:
<informalexample><programlisting>
 <!>enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS };
 <!>...
 <!>{
 <!>  GtkTreeViewColumn *column;
 <!>  GtkCellRenderer   *renderer = <link linkend="gtk-cell-renderer-text-new">gtk_cell_renderer_text_new</link>();
 <!>
 <!>  column = gtk_tree_view_column_new_with_attributes ("Title",
 <!>                                                     renderer,
 <!>                                                     "text", TEXT_COLUMN,
 <!>                                                     "foreground", COLOR_COLUMN,
 <!>                                                     NULL);
 <!>}
</programlisting></informalexample></para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>title</parameter>&nbsp;:</entry>
<entry> The title to set the header to.
</entry></row>
<row><entry align="right"><parameter>cell</parameter>&nbsp;:</entry>
<entry> The <link linkend="GtkCellRenderer">GtkCellRenderer</link>.
</entry></row>
<row><entry align="right"><parameter>...</parameter>&nbsp;:</entry>
<entry> A <literal>NULL</literal>-terminated list of attributes.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A newly created <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-pack-start">gtk_tree_view_column_pack_start ()</title>
<programlisting>void        gtk_tree_view_column_pack_start (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                             <link linkend="gboolean">gboolean</link> expand);</programlisting>
<para>
Packs the <parameter>cell</parameter> into the beginning column.  If <parameter>expand</parameter> is <literal>TRUE</literal>, then the
<parameter>cell</parameter> is allocated a share of all available space that the <parameter>tree_column</parameter> has.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>cell</parameter>&nbsp;:</entry>
<entry> The <link linkend="GtkCellRenderer">GtkCellRenderer</link>. 
</entry></row>
<row><entry align="right"><parameter>expand</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> if <parameter>cell</parameter> is to be given extra space allocated to box.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-pack-end">gtk_tree_view_column_pack_end ()</title>
<programlisting>void        gtk_tree_view_column_pack_end   (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                             <link linkend="gboolean">gboolean</link> expand);</programlisting>
<para>
Packs the <parameter>cell</parameter> into the column.  If <parameter>expand</parameter> is <literal>TRUE</literal>, then the <parameter>cell</parameter> is
allocated a share of all available space that the <parameter>tree_column</parameter> has.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>cell</parameter>&nbsp;:</entry>
<entry> The <link linkend="GtkCellRenderer">GtkCellRenderer</link>. 
</entry></row>
<row><entry align="right"><parameter>expand</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> if <parameter>cell</parameter> is to be given extra space allocated to box.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-clear">gtk_tree_view_column_clear ()</title>
<programlisting>void        gtk_tree_view_column_clear      (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Unsets all the mappings on all renderers on the <parameter>tree_column</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-cell-renderers">gtk_tree_view_column_get_cell_renderers ()</title>
<programlisting><link linkend="GList">GList</link>*      gtk_tree_view_column_get_cell_renderers
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns a newly-allocated <link linkend="GList">GList</link> of all the cell renderers in the column, 
in no particular order.  The list must be freed with <link linkend="g-list-free">g_list_free</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> A list of <link linkend="GtkCellRenderers">GtkCellRenderers</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-add-attribute">gtk_tree_view_column_add_attribute ()</title>
<programlisting>void        gtk_tree_view_column_add_attribute
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer,
                                             const <link linkend="gchar">gchar</link> *attribute,
                                             <link linkend="gint">gint</link> column);</programlisting>
<para>
Adds an attribute mapping to the list in <parameter>tree_column</parameter>.  The <parameter>column</parameter> is the
column of the model to get a value from, and the <parameter>attribute</parameter> is the
parameter on <parameter>cell_renderer</parameter> to be set from the value. So for example
if column 2 of the model contains strings, you could have the
"text" attribute of a <link linkend="GtkCellRendererText">GtkCellRendererText</link> get its values from
column 2.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>cell_renderer</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkCellRenderer">GtkCellRenderer</link> to set attributes on
</entry></row>
<row><entry align="right"><parameter>attribute</parameter>&nbsp;:</entry>
<entry> An attribute on the renderer
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry> The column position on the model to get the attribute from.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-attributes">gtk_tree_view_column_set_attributes ()</title>
<programlisting>void        gtk_tree_view_column_set_attributes
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer,
                                             ...);</programlisting>
<para>
Sets the attributes in the list as the attributes of <parameter>tree_column</parameter>.
The attributes should be in attribute/column order, as in
<link linkend="gtk-tree-view-column-add-attribute">gtk_tree_view_column_add_attribute</link>(). All existing attributes
are removed, and replaced with the new attributes.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>cell_renderer</parameter>&nbsp;:</entry>
<entry> the <link linkend="GtkCellRenderer">GtkCellRenderer</link> we're setting the attributes of
</entry></row>
<row><entry align="right"><parameter>...</parameter>&nbsp;:</entry>
<entry> A <literal>NULL</literal>-terminated list of attributes.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-cell-data-func">gtk_tree_view_column_set_cell_data_func ()</title>
<programlisting>void        gtk_tree_view_column_set_cell_data_func
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer,
                                             <link linkend="GtkTreeCellDataFunc">GtkTreeCellDataFunc</link> func,
                                             <link linkend="gpointer">gpointer</link> func_data,
                                             <link linkend="GtkDestroyNotify">GtkDestroyNotify</link> destroy);</programlisting>
<para>
Sets the <link linkend="GtkTreeViewColumnFunc">GtkTreeViewColumnFunc</link> to use for the column.  This
function is used instead of the standard attributes mapping for
setting the column value, and should set the value of <parameter>tree_column</parameter>'s
cell renderer as appropriate.  <parameter>func</parameter> may be <literal>NULL</literal> to remove an
older one.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><parameter>cell_renderer</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkCellRenderer">GtkCellRenderer</link>
</entry></row>
<row><entry align="right"><parameter>func</parameter>&nbsp;:</entry>
<entry> The <link linkend="GtkTreeViewColumnFunc">GtkTreeViewColumnFunc</link> to use. 
</entry></row>
<row><entry align="right"><parameter>func_data</parameter>&nbsp;:</entry>
<entry> The user data for <parameter>func</parameter>.
</entry></row>
<row><entry align="right"><parameter>destroy</parameter>&nbsp;:</entry>
<entry> The destroy notification for <parameter>func_data</parameter>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-clear-attributes">gtk_tree_view_column_clear_attributes ()</title>
<programlisting>void        gtk_tree_view_column_clear_attributes
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer);</programlisting>
<para>
Clears all existing attributes previously set with
<link linkend="gtk-tree-view-column-set-attributes">gtk_tree_view_column_set_attributes</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><parameter>cell_renderer</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkCellRenderer">GtkCellRenderer</link> to clear the attribute mapping on.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-spacing">gtk_tree_view_column_set_spacing ()</title>
<programlisting>void        gtk_tree_view_column_set_spacing
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> spacing);</programlisting>
<para>
Sets the spacing field of <parameter>tree_column</parameter>, which is the number of pixels to
place between cell renderers packed into it.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>spacing</parameter>&nbsp;:</entry>
<entry> distance between cell renderers in pixels.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-spacing">gtk_tree_view_column_get_spacing ()</title>
<programlisting><link linkend="gint">gint</link>        gtk_tree_view_column_get_spacing
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns the spacing of <parameter>tree_column</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the spacing of <parameter>tree_column</parameter>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-visible">gtk_tree_view_column_set_visible ()</title>
<programlisting>void        gtk_tree_view_column_set_visible
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> visible);</programlisting>
<para>
Sets the visibility of <parameter>tree_column</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>visible</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> if the <parameter>tree_column</parameter> is visible.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-visible">gtk_tree_view_column_get_visible ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_tree_view_column_get_visible
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns <literal>TRUE</literal> if <parameter>tree_column</parameter> is visible.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> whether the column is visible or not.  If it is visible, then
the tree will show the column.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-resizable">gtk_tree_view_column_set_resizable ()</title>
<programlisting>void        gtk_tree_view_column_set_resizable
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> resizable);</programlisting>
<para>
If <parameter>resizable</parameter> is <literal>TRUE</literal>, then the user can explicitly resize the column by
grabbing the outer edge of the column button.  If resizable is TRUE and
sizing mode of the column is <link linkend="GTK-TREE-VIEW-COLUMN-AUTOSIZE-CAPS">GTK_TREE_VIEW_COLUMN_AUTOSIZE</link>, then the sizing
mode is changed to <link linkend="GTK-TREE-VIEW-COLUMN-GROW-ONLY-CAPS">GTK_TREE_VIEW_COLUMN_GROW_ONLY</link>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><parameter>resizable</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal>, if the column can be resized
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-resizable">gtk_tree_view_column_get_resizable ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_tree_view_column_get_resizable
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns <link linkend="TRUE-CAPS">TRUE</link> if the <parameter>tree_column</parameter> can be resized by the end user.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> <link linkend="TRUE-CAPS">TRUE</link>, if the <parameter>tree_column</parameter> can be resized.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-sizing">gtk_tree_view_column_set_sizing ()</title>
<programlisting>void        gtk_tree_view_column_set_sizing (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link> type);</programlisting>
<para>
Sets the growth behavior of <parameter>tree_column</parameter> to <parameter>type</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>type</parameter>&nbsp;:</entry>
<entry> The <link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-sizing">gtk_tree_view_column_get_sizing ()</title>
<programlisting><link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link> gtk_tree_view_column_get_sizing
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns the current type of <parameter>tree_column</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The type of <parameter>tree_column</parameter>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-width">gtk_tree_view_column_get_width ()</title>
<programlisting><link linkend="gint">gint</link>        gtk_tree_view_column_get_width  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns the current size of <parameter>tree_column</parameter> in pixels.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The current width of <parameter>tree_column</parameter>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-fixed-width">gtk_tree_view_column_get_fixed_width ()</title>
<programlisting><link linkend="gint">gint</link>        gtk_tree_view_column_get_fixed_width
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Gets the fixed width of the column.  This value is only meaning may not be
the actual width of the column on the screen, just what is requested.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the fixed width of the column
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-fixed-width">gtk_tree_view_column_set_fixed_width ()</title>
<programlisting>void        gtk_tree_view_column_set_fixed_width
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> fixed_width);</programlisting>
<para>
Sets the size of the column in pixels.  This is meaningful only if the sizing
type is <link linkend="GTK-TREE-VIEW-COLUMN-FIXED-CAPS">GTK_TREE_VIEW_COLUMN_FIXED</link>.  The size of the column is clamped to
the min/max width for the column.  Please note that the min/max width of the
column doesn't actually affect the "fixed_width" property of the widget, just
the actual size when displayed.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>fixed_width</parameter>&nbsp;:</entry>
<entry> The size to set <parameter>tree_column</parameter> to. Must be greater than 0.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-min-width">gtk_tree_view_column_set_min_width ()</title>
<programlisting>void        gtk_tree_view_column_set_min_width
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> min_width);</programlisting>
<para>
Sets the minimum width of the <parameter>tree_column</parameter>.  If <parameter>min_width</parameter> is -1, then the
minimum width is unset.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>min_width</parameter>&nbsp;:</entry>
<entry> The minimum width of the column in pixels, or -1.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-min-width">gtk_tree_view_column_get_min_width ()</title>
<programlisting><link linkend="gint">gint</link>        gtk_tree_view_column_get_min_width
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns the minimum width in pixels of the <parameter>tree_column</parameter>, or -1 if no minimum
width is set.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The minimum width of the <parameter>tree_column</parameter>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-max-width">gtk_tree_view_column_set_max_width ()</title>
<programlisting>void        gtk_tree_view_column_set_max_width
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> max_width);</programlisting>
<para>
Sets the maximum width of the <parameter>tree_column</parameter>.  If <parameter>max_width</parameter> is -1, then the
maximum width is unset.  Note, the column can actually be wider than max
width if it's the last column in a view.  In this case, the column expands to
fill any extra space.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>max_width</parameter>&nbsp;:</entry>
<entry> The maximum width of the column in pixels, or -1.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-max-width">gtk_tree_view_column_get_max_width ()</title>
<programlisting><link linkend="gint">gint</link>        gtk_tree_view_column_get_max_width
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns the maximum width in pixels of the <parameter>tree_column</parameter>, or -1 if no maximum
width is set.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The maximum width of the <parameter>tree_column</parameter>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-clicked">gtk_tree_view_column_clicked ()</title>
<programlisting>void        gtk_tree_view_column_clicked    (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Emits the "clicked" signal on the column.  This function will only work if
<parameter>tree_column</parameter> is clickable.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-title">gtk_tree_view_column_set_title ()</title>
<programlisting>void        gtk_tree_view_column_set_title  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             const <link linkend="gchar">gchar</link> *title);</programlisting>
<para>
Sets the title of the <parameter>tree_column</parameter>.  If a custom widget has been set, then
this value is ignored.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>title</parameter>&nbsp;:</entry>
<entry> The title of the <parameter>tree_column</parameter>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-title">gtk_tree_view_column_get_title ()</title>
<programlisting>G_CONST_RETURN <link linkend="gchar">gchar</link>* gtk_tree_view_column_get_title
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns the title of the widget.  This value should not be modified.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the title of the column.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-clickable">gtk_tree_view_column_set_clickable ()</title>
<programlisting>void        gtk_tree_view_column_set_clickable
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> clickable);</programlisting>
<para>
Sets the header to be active if <parameter>active</parameter> is <literal>TRUE</literal>.  When the header is active,
then it can take keyboard focus, and can be clicked.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>clickable</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> if the header is active.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-clickable">gtk_tree_view_column_get_clickable ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_tree_view_column_get_clickable
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns <literal>TRUE</literal> if the user can click on the header for the column.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> <literal>TRUE</literal> if user can click the column header.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-widget">gtk_tree_view_column_set_widget ()</title>
<programlisting>void        gtk_tree_view_column_set_widget (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkWidget">GtkWidget</link> *widget);</programlisting>
<para>
Sets the widget in the header to be <parameter>widget</parameter>.  If widget is <literal>NULL</literal>, then the
header button is set with a <link linkend="GtkLabel">GtkLabel</link> set to the title of <parameter>tree_column</parameter>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>widget</parameter>&nbsp;:</entry>
<entry> A child <link linkend="GtkWidget">GtkWidget</link>, or <literal>NULL</literal>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-widget">gtk_tree_view_column_get_widget ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_tree_view_column_get_widget (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns the <link linkend="GtkWidget">GtkWidget</link> in the button on the column header.  If a custom
widget has not been set then <literal>NULL</literal> is returned.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The <link linkend="GtkWidget">GtkWidget</link> in the column header, or <literal>NULL</literal>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-alignment">gtk_tree_view_column_set_alignment ()</title>
<programlisting>void        gtk_tree_view_column_set_alignment
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gfloat">gfloat</link> xalign);</programlisting>
<para>
Sets the alignment of the title or custom widget inside the column header.
The alignment determines its location inside the button -- 0.0 for left, 0.5
for center, 1.0 for right.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>xalign</parameter>&nbsp;:</entry>
<entry> The alignment, which is between [0.0 and 1.0] inclusive.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-alignment">gtk_tree_view_column_get_alignment ()</title>
<programlisting><link linkend="gfloat">gfloat</link>      gtk_tree_view_column_get_alignment
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns the current x alignment of <parameter>tree_column</parameter>.  This value can range
between 0.0 and 1.0.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The current alignent of <parameter>tree_column</parameter>.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-reorderable">gtk_tree_view_column_set_reorderable ()</title>
<programlisting>void        gtk_tree_view_column_set_reorderable
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> reorderable);</programlisting>
<para>
If <parameter>reorderable</parameter> is <link linkend="TRUE-CAPS">TRUE</link>, then the column can be reordered by the end user
dragging the header.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><parameter>reorderable</parameter>&nbsp;:</entry>
<entry> <link linkend="TRUE-CAPS">TRUE</link>, if the column can be reordered.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-reorderable">gtk_tree_view_column_get_reorderable ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_tree_view_column_get_reorderable
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns <link linkend="TRUE-CAPS">TRUE</link> if the <parameter>tree_column</parameter> can be reordered by the user.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> <link linkend="TRUE-CAPS">TRUE</link> if the <parameter>tree_column</parameter> can be reordered by the user.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-sort-column-id">gtk_tree_view_column_set_sort_column_id ()</title>
<programlisting>void        gtk_tree_view_column_set_sort_column_id
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gint">gint</link> sort_column_id);</programlisting>
<para>
Sets the logical <parameter>sort_column_id</parameter> that this column sorts on when this column 
is selected for sorting.  Doing so makes the column header clickable.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><parameter>sort_column_id</parameter>&nbsp;:</entry>
<entry> The <parameter>sort_column_id</parameter> of the model to sort on.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-sort-column-id">gtk_tree_view_column_get_sort_column_id ()</title>
<programlisting><link linkend="gint">gint</link>        gtk_tree_view_column_get_sort_column_id
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Gets the logical <parameter>sort_column_id</parameter> that the model sorts on when this
column is selected for sorting. See <link linkend="gtk-tree-view-column-set-sort-column-id">gtk_tree_view_column_set_sort_column_id</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the current <parameter>sort_column_id</parameter> for this column, or -1 if
              this column can't be used for sorting.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-sort-indicator">gtk_tree_view_column_set_sort_indicator ()</title>
<programlisting>void        gtk_tree_view_column_set_sort_indicator
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="gboolean">gboolean</link> setting);</programlisting>
<para>
Call this function with a <parameter>setting</parameter> of <literal>TRUE</literal> to display an arrow in
the header button indicating the column is sorted. Call
<link linkend="gtk-tree-view-column-set-sort-order">gtk_tree_view_column_set_sort_order</link>() to change the direction of
the arrow.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><parameter>setting</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> to display an indicator that the column is sorted
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-sort-indicator">gtk_tree_view_column_get_sort_indicator ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_tree_view_column_get_sort_indicator
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Gets the value set by <link linkend="gtk-tree-view-column-set-sort-indicator">gtk_tree_view_column_set_sort_indicator</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> whether the sort indicator arrow is displayed
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-set-sort-order">gtk_tree_view_column_set_sort_order ()</title>
<programlisting>void        gtk_tree_view_column_set_sort_order
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkSortType">GtkSortType</link> order);</programlisting>
<para>
Changes the appearance of the sort indicator. 
</para>
<para>
This <emphasis>does not</emphasis> actually sort the model.  Use
<link linkend="gtk-tree-view-column-set-sort-column-id">gtk_tree_view_column_set_sort_column_id</link>() if you want automatic sorting
support.  This function is primarily for custom sorting behavior, and should
be used in conjunction with <link linkend="gtk-tree-sortable-set-sort-column">gtk_tree_sortable_set_sort_column</link>() to do
that. For custom models, the mechanism will vary. 
</para>
<para>
The sort indicator changes direction to indicate normal sort or reverse sort.
Note that you must have the sort indicator enabled to see anything when 
calling this function; see <link linkend="gtk-tree-view-column-set-sort-indicator">gtk_tree_view_column_set_sort_indicator</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><parameter>order</parameter>&nbsp;:</entry>
<entry> sort order that the sort indicator should indicate
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-get-sort-order">gtk_tree_view_column_get_sort_order ()</title>
<programlisting><link linkend="GtkSortType">GtkSortType</link> gtk_tree_view_column_get_sort_order
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Gets the value set by <link linkend="gtk-tree-view-column-set-sort-order">gtk_tree_view_column_set_sort_order</link>().</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> a <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> the sort order the sort indicator is indicating
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-cell-set-cell-data">gtk_tree_view_column_cell_set_cell_data ()</title>
<programlisting>void        gtk_tree_view_column_cell_set_cell_data
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GtkTreeModel">GtkTreeModel</link> *tree_model,
                                             <link linkend="GtkTreeIter">GtkTreeIter</link> *iter,
                                             <link linkend="gboolean">gboolean</link> is_expander,
                                             <link linkend="gboolean">gboolean</link> is_expanded);</programlisting>
<para>
Sets the cell renderer based on the <parameter>tree_model</parameter> and <parameter>tree_node</parameter>.  That is, for
every attribute mapping in <parameter>tree_column</parameter>, it will get a value from the set
column on the <parameter>tree_node</parameter>, and use that value to set the attribute on the cell
renderer.  This is used primarily by the <link linkend="GtkTreeView">GtkTreeView</link>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>tree_model</parameter>&nbsp;:</entry>
<entry> The <link linkend="GtkTreeModel">GtkTreeModel</link> to to get the cell renderers attributes from.
</entry></row>
<row><entry align="right"><parameter>iter</parameter>&nbsp;:</entry>
<entry> The <link linkend="GtkTreeIter">GtkTreeIter</link> to to get the cell renderer's attributes from.
</entry></row>
<row><entry align="right"><parameter>is_expander</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal>, if the row has children
</entry></row>
<row><entry align="right"><parameter>is_expanded</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal>, if the row has visible children
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-cell-get-size">gtk_tree_view_column_cell_get_size ()</title>
<programlisting>void        gtk_tree_view_column_cell_get_size
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                             <link linkend="GdkRectangle">GdkRectangle</link> *cell_area,
                                             <link linkend="gint">gint</link> *x_offset,
                                             <link linkend="gint">gint</link> *y_offset,
                                             <link linkend="gint">gint</link> *width,
                                             <link linkend="gint">gint</link> *height);</programlisting>
<para>
Obtains the width and height needed to render the column.  This is used
primarily by the <link linkend="GtkTreeView">GtkTreeView</link>.</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>.
</entry></row>
<row><entry align="right"><parameter>cell_area</parameter>&nbsp;:</entry>
<entry> The area a the column will be allocated, or <literal>NULL</literal>
</entry></row>
<row><entry align="right"><parameter>x_offset</parameter>&nbsp;:</entry>
<entry> location to return x offset of cell relative to <parameter>cell_area</parameter>, or <literal>NULL</literal>
</entry></row>
<row><entry align="right"><parameter>y_offset</parameter>&nbsp;:</entry>
<entry> location to return y offset of cell relative to <parameter>cell_area</parameter>, or <literal>NULL</literal>
</entry></row>
<row><entry align="right"><parameter>width</parameter>&nbsp;:</entry>
<entry> location to return width needed to render a cell, or <literal>NULL</literal>
</entry></row>
<row><entry align="right"><parameter>height</parameter>&nbsp;:</entry>
<entry> location to return height needed to render a cell, or <literal>NULL</literal>
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-view-column-cell-is-visible">gtk_tree_view_column_cell_is_visible ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gtk_tree_view_column_cell_is_visible
                                            (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns <link linkend="TRUE-CAPS">TRUE</link> if any of the cells packed into the <parameter>tree_column</parameter> are visible.
For this to be meaningful, you must first initialize the cells with
<link linkend="gtk-tree-view-column-cell-set-cell-data">gtk_tree_view_column_cell_set_cell_data</link>()</para>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_column</parameter>&nbsp;:</entry>
<entry> A <link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> <link linkend="TRUE-CAPS">TRUE</link>, if any of the cells packed into the <parameter>tree_column</parameter> are currently visible
</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>
<refsect1>
<title>Properties</title>
<variablelist>
<varlistentry><term><anchor id="GtkTreeViewColumn--visible">&quot;<literal>visible</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--resizable">&quot;<literal>resizable</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--width">&quot;<literal>width</literal>&quot; (<link linkend="gint">gint</link> : Read)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--sizing">&quot;<literal>sizing</literal>&quot; (<link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--fixed-width">&quot;<literal>fixed-width</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--min-width">&quot;<literal>min-width</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--max-width">&quot;<literal>max-width</literal>&quot; (<link linkend="gint">gint</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--title">&quot;<literal>title</literal>&quot; (<link linkend="gchararray">gchararray</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--clickable">&quot;<literal>clickable</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--widget">&quot;<literal>widget</literal>&quot; (<link linkend="GtkWidget">GtkWidget</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--alignment">&quot;<literal>alignment</literal>&quot; (<link linkend="gfloat">gfloat</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--reorderable">&quot;<literal>reorderable</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--sort-indicator">&quot;<literal>sort-indicator</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkTreeViewColumn--sort-order">&quot;<literal>sort-order</literal>&quot; (<link linkend="GtkSortType">GtkSortType</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>

</variablelist>
</refsect1>

<refsect1>
<title>Signals</title>
<refsect2><title><anchor id="GtkTreeViewColumn-clicked">The &quot;clicked&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *treeviewcolumn,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>treeviewcolumn</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2>
</refsect1>


<refsect1>
<title>See Also</title>
<para>
<link linkend="GtkTreeView">GtkTreeView</link>, <link linkend="GtkTreeSelection">GtkTreeSelection</link>, <link linkend="GtkTreeDnd">GtkTreeDnd</link>, <link linkend="GtkTreeMode">GtkTreeMode</link>, <link linkend="GtkTreeSortable">GtkTreeSortable</link>, <link linkend="GtkTreeModelSort">GtkTreeModelSort</link>, <link linkend="GtkListStore">GtkListStore</link>, <link linkend="GtkTreeStore">GtkTreeStore</link>, <link linkend="GtkCellRenderer">GtkCellRenderer</link>, <link linkend="GtkCellEditable">GtkCellEditable</link>, <link linkend="GtkCellRendererPixbuf">GtkCellRendererPixbuf</link>, <link linkend="GtkCellRendererText">GtkCellRendererText</link>, <link linkend="GtkCellRendererToggle">GtkCellRendererToggle</link>

</para>
</refsect1>

</refentry>
