<?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 index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkTreeViewColumn">
<refmeta>
<refentrytitle role="top_of_page" id="GtkTreeViewColumn.top_of_page">GtkTreeViewColumn</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkTreeViewColumn</refname>
<refpurpose>A visible column in a GtkTreeView widget</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkTreeViewColumn.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

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

enum                <link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link>;
<link linkend="void">void</link>                (<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);
                    <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,
                                                         ...);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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,
                                                         ...);
<link linkend="void">void</link>                <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="GDestroyNotify">GDestroyNotify</link> destroy);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <link linkend="gtk-tree-view-column-clicked">gtk_tree_view_column_clicked</link>        (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
<link linkend="void">void</link>                <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);
const <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);
<link linkend="void">void</link>                <link linkend="gtk-tree-view-column-set-expand">gtk_tree_view_column_set_expand</link>     (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                                         <link linkend="gboolean">gboolean</link> expand);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-tree-view-column-get-expand">gtk_tree_view_column_get_expand</link>     (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <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);
<link linkend="void">void</link>                <link linkend="gtk-tree-view-column-cell-get-size">gtk_tree_view_column_cell_get_size</link>  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                                         const <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-get-position">gtk_tree_view_column_cell_get_position</link>
                                                        (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer,
                                                         <link linkend="gint">gint</link> *start_pos,
                                                         <link linkend="gint">gint</link> *width);
<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);
<link linkend="void">void</link>                <link linkend="gtk-tree-view-column-focus-cell">gtk_tree_view_column_focus_cell</link>     (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell);
<link linkend="void">void</link>                <link linkend="gtk-tree-view-column-queue-resize">gtk_tree_view_column_queue_resize</link>   (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-tree-view-column-get-tree-view">gtk_tree_view_column_get_tree_view</link>  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkTreeViewColumn.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----GtkTreeViewColumn
</synopsis>
</refsect1>



<refsect1 id="GtkTreeViewColumn.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkTreeViewColumn implements
 <link linkend="GtkBuildable">GtkBuildable</link> and  <link linkend="GtkCellLayout">GtkCellLayout</link>.</para>
</refsect1>


<refsect1 id="GtkTreeViewColumn.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkTreeViewColumn--alignment">alignment</link>&quot;                <link linkend="gfloat">gfloat</link>                : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--clickable">clickable</link>&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--expand">expand</link>&quot;                   <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--fixed-width">fixed-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--min-width">min-width</link>&quot;                <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--reorderable">reorderable</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--sizing">sizing</link>&quot;                   <link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link>  : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--sort-column-id">sort-column-id</link>&quot;           <link linkend="gint">gint</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
  &quot;<link linkend="GtkTreeViewColumn--spacing">spacing</link>&quot;                  <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--title">title</link>&quot;                    <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkTreeViewColumn--visible">visible</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--width">width</link>&quot;                    <link linkend="gint">gint</link>                  : Read
</synopsis>
</refsect1>

<refsect1 id="GtkTreeViewColumn.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkTreeViewColumn-clicked">clicked</link>&quot;                                        : Run Last
</synopsis>
</refsect1>


<refsect1 id="GtkTreeViewColumn.description" role="desc">
<title role="desc.title">Description</title>
<para>
The GtkTreeViewColumn object represents a visible column in a <link linkend="GtkTreeView"><type>GtkTreeView</type></link> widget.
It allows to set properties of the column header, and functions as a holding pen for
the cell renderers which determine how the data in the column is displayed.
</para>
<para>
Please refer to the <link linkend="TreeWidget">tree widget conceptual overview</link>
for an overview of all the objects and data types related to the tree widget and how
they work together.
</para>
</refsect1>

<refsect1 id="GtkTreeViewColumn.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkTreeViewColumnSizing" role="enum">
<title>enum GtkTreeViewColumnSizing</title>
<indexterm zone="GtkTreeViewColumnSizing"><primary sortas="TreeViewColumnSizing">GtkTreeViewColumnSizing</primary></indexterm><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 its width.  Please note
that <parameter>GTK_TREE_VIEW_COLUMN_AUTOSIZE</parameter> are inefficient for large views, and
can make columns appear choppy.
</para><variablelist role="enum">
<varlistentry id="GTK-TREE-VIEW-COLUMN-GROW-ONLY--CAPS" role="constant">
<term><literal>GTK_TREE_VIEW_COLUMN_GROW_ONLY</literal></term>
<listitem><simpara>Columns only get bigger in reaction to changes in the model
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-TREE-VIEW-COLUMN-AUTOSIZE--CAPS" role="constant">
<term><literal>GTK_TREE_VIEW_COLUMN_AUTOSIZE</literal></term>
<listitem><simpara>Columns resize to be the optimal size everytime the model changes.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-TREE-VIEW-COLUMN-FIXED--CAPS" role="constant">
<term><literal>GTK_TREE_VIEW_COLUMN_FIXED</literal></term>
<listitem><simpara>Columns are a fixed numbers of pixels wide.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="GtkTreeCellDataFunc" role="function">
<title>GtkTreeCellDataFunc ()</title>
<indexterm zone="GtkTreeCellDataFunc"><primary sortas="TreeCellDataFunc">GtkTreeCellDataFunc</primary></indexterm><programlisting><link linkend="void">void</link>                (*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"><function>gtk_tree_view_column_set_cell_data_func()</function></link>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="GtkTreeColumn"><type>GtkTreeColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> that is being rendered by <parameter>tree_column</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tree_model</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> being rendered
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link> of the current row rendered
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>user data
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GtkTreeViewColumn-struct" role="struct">
<title>GtkTreeViewColumn</title>
<indexterm zone="GtkTreeViewColumn-struct"><primary sortas="TreeViewColumn">GtkTreeViewColumn</primary></indexterm><programlisting>typedef struct _GtkTreeViewColumn GtkTreeViewColumn;</programlisting>
<para>
</para></refsect2>
<refsect2 id="gtk-tree-view-column-new" role="function">
<title>gtk_tree_view_column_new ()</title>
<indexterm zone="gtk-tree-view-column-new"><primary sortas="tree_view_column_new">gtk_tree_view_column_new</primary></indexterm><programlisting><link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> * gtk_tree_view_column_new            (void);</programlisting>
<para>
Creates a new <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A newly created <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-new-with-attributes" role="function">
<title>gtk_tree_view_column_new_with_attributes ()</title>
<indexterm zone="gtk-tree-view-column-new-with-attributes"><primary sortas="tree_view_column_new_with_attributes">gtk_tree_view_column_new_with_attributes</primary></indexterm><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"><type>GtkTreeViewColumn</type></link> with a number of default values.  This is
equivalent to calling <link linkend="gtk-tree-view-column-set-title"><function>gtk_tree_view_column_set_title()</function></link>,
<link linkend="gtk-tree-view-column-pack-start"><function>gtk_tree_view_column_pack_start()</function></link>, and
<link linkend="gtk-tree-view-column-set-attributes"><function>gtk_tree_view_column_set_attributes()</function></link> on the newly created <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</para>
<para>
Here's a simple example:
<informalexample><programlisting>
 enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS };
 ...
 {
   GtkTreeViewColumn *column;
   GtkCellRenderer   *renderer = gtk_cell_renderer_text_new ();
 
   column = gtk_tree_view_column_new_with_attributes ("Title",
                                                      renderer,
                                                      "text", TEXT_COLUMN,
                                                      "foreground", COLOR_COLUMN,
                                                      NULL);
 }
</programlisting></informalexample></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>title</parameter>&#160;:</term>
<listitem><simpara> The title to set the header to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated list of attributes.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A newly created <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-pack-start" role="function">
<title>gtk_tree_view_column_pack_start ()</title>
<indexterm zone="gtk-tree-view-column-pack-start"><primary sortas="tree_view_column_pack_start">gtk_tree_view_column_pack_start</primary></indexterm><programlisting><link linkend="void">void</link>                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 of the column. If <parameter>expand</parameter> is <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>, then
the <parameter>cell</parameter> is allocated no more space than it needs. Any unused space is divided
evenly between cells for which <parameter>expand</parameter> is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>. 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>expand</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if <parameter>cell</parameter> is to be given extra space allocated to <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-pack-end" role="function">
<title>gtk_tree_view_column_pack_end ()</title>
<indexterm zone="gtk-tree-view-column-pack-end"><primary sortas="tree_view_column_pack_end">gtk_tree_view_column_pack_end</primary></indexterm><programlisting><link linkend="void">void</link>                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>
Adds the <parameter>cell</parameter> to end of the column. If <parameter>expand</parameter> is <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>, then the <parameter>cell</parameter>
is allocated no more space than it needs. Any unused space is divided
evenly between cells for which <parameter>expand</parameter> is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>. 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>expand</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if <parameter>cell</parameter> is to be given extra space allocated to <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-clear" role="function">
<title>gtk_tree_view_column_clear ()</title>
<indexterm zone="gtk-tree-view-column-clear"><primary sortas="tree_view_column_clear">gtk_tree_view_column_clear</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-cell-renderers" role="function" condition="deprecated:2.18: use gtk_cell_layout_get_cells() instead.">
<title>gtk_tree_view_column_get_cell_renderers ()</title>
<indexterm zone="gtk-tree-view-column-get-cell-renderers" role="deprecated"><primary sortas="tree_view_column_get_cell_renderers">gtk_tree_view_column_get_cell_renderers</primary></indexterm><programlisting><link linkend="GList">GList</link> *             gtk_tree_view_column_get_cell_renderers
                                                        (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<warning><para><literal>gtk_tree_view_column_get_cell_renderers</literal> has been deprecated since version 2.18 and should not be used in newly-written code. use <link linkend="gtk-cell-layout-get-cells"><function>gtk_cell_layout_get_cells()</function></link> instead.</para></warning>
<para>
Returns a newly-allocated <link linkend="GList"><type>GList</type></link> of all the cell renderers in the column,
in no particular order.  The list must be freed with <link linkend="g-list-free"><function>g_list_free()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A list of <link linkend="GtkCellRenderers"><type>GtkCellRenderers</type></link>

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-add-attribute" role="function">
<title>gtk_tree_view_column_add_attribute ()</title>
<indexterm zone="gtk-tree-view-column-add-attribute"><primary sortas="tree_view_column_add_attribute">gtk_tree_view_column_add_attribute</primary></indexterm><programlisting><link linkend="void">void</link>                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"><type>GtkCellRendererText</type></link> get its values from
column 2.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell_renderer</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to set attributes on
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attribute</parameter>&#160;:</term>
<listitem><simpara> An attribute on the renderer
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara> The column position on the model to get the attribute from.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-attributes" role="function">
<title>gtk_tree_view_column_set_attributes ()</title>
<indexterm zone="gtk-tree-view-column-set-attributes"><primary sortas="tree_view_column_set_attributes">gtk_tree_view_column_set_attributes</primary></indexterm><programlisting><link linkend="void">void</link>                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"><function>gtk_tree_view_column_add_attribute()</function></link>. All existing attributes
are removed, and replaced with the new attributes.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell_renderer</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> we're setting the attributes of
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated list of attributes.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-cell-data-func" role="function">
<title>gtk_tree_view_column_set_cell_data_func ()</title>
<indexterm zone="gtk-tree-view-column-set-cell-data-func"><primary sortas="tree_view_column_set_cell_data_func">gtk_tree_view_column_set_cell_data_func</primary></indexterm><programlisting><link linkend="void">void</link>                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="GDestroyNotify">GDestroyNotify</link> destroy);</programlisting>
<para>
Sets the <link linkend="GtkTreeViewColumnFunc"><type>GtkTreeViewColumnFunc</type></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 <link linkend="NULL--CAPS"><literal>NULL</literal></link> to remove an
older one.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell_renderer</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkTreeViewColumnFunc"><type>GtkTreeViewColumnFunc</type></link> to use. 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func_data</parameter>&#160;:</term>
<listitem><simpara> The user data for <parameter>func</parameter>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>destroy</parameter>&#160;:</term>
<listitem><simpara> The destroy notification for <parameter>func_data</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-clear-attributes" role="function">
<title>gtk_tree_view_column_clear_attributes ()</title>
<indexterm zone="gtk-tree-view-column-clear-attributes"><primary sortas="tree_view_column_clear_attributes">gtk_tree_view_column_clear_attributes</primary></indexterm><programlisting><link linkend="void">void</link>                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"><function>gtk_tree_view_column_set_attributes()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell_renderer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> to clear the attribute mapping on.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-spacing" role="function">
<title>gtk_tree_view_column_set_spacing ()</title>
<indexterm zone="gtk-tree-view-column-set-spacing"><primary sortas="tree_view_column_set_spacing">gtk_tree_view_column_set_spacing</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>spacing</parameter>&#160;:</term>
<listitem><simpara> distance between cell renderers in pixels.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-spacing" role="function">
<title>gtk_tree_view_column_get_spacing ()</title>
<indexterm zone="gtk-tree-view-column-get-spacing"><primary sortas="tree_view_column_get_spacing">gtk_tree_view_column_get_spacing</primary></indexterm><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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the spacing of <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-visible" role="function">
<title>gtk_tree_view_column_set_visible ()</title>
<indexterm zone="gtk-tree-view-column-set-visible"><primary sortas="tree_view_column_set_visible">gtk_tree_view_column_set_visible</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>visible</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the <parameter>tree_column</parameter> is visible.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-visible" role="function">
<title>gtk_tree_view_column_get_visible ()</title>
<indexterm zone="gtk-tree-view-column-get-visible"><primary sortas="tree_view_column_get_visible">gtk_tree_view_column_get_visible</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_tree_view_column_get_visible    (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if <parameter>tree_column</parameter> is visible.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> whether the column is visible or not.  If it is visible, then
the tree will show the column.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-resizable" role="function">
<title>gtk_tree_view_column_set_resizable ()</title>
<indexterm zone="gtk-tree-view-column-set-resizable"><primary sortas="tree_view_column_set_resizable">gtk_tree_view_column_set_resizable</primary></indexterm><programlisting><link linkend="void">void</link>                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 <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, then the user can explicitly resize the column by
grabbing the outer edge of the column button.  If resizable is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> and
sizing mode of the column is <link linkend="GTK-TREE-VIEW-COLUMN-AUTOSIZE--CAPS"><type>GTK_TREE_VIEW_COLUMN_AUTOSIZE</type></link>, then the sizing
mode is changed to <link linkend="GTK-TREE-VIEW-COLUMN-GROW-ONLY--CAPS"><type>GTK_TREE_VIEW_COLUMN_GROW_ONLY</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>resizable</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, if the column can be resized
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-resizable" role="function">
<title>gtk_tree_view_column_get_resizable ()</title>
<indexterm zone="gtk-tree-view-column-get-resizable"><primary sortas="tree_view_column_get_resizable">gtk_tree_view_column_get_resizable</primary></indexterm><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"><literal>TRUE</literal></link> if the <parameter>tree_column</parameter> can be resized by the end user.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, if the <parameter>tree_column</parameter> can be resized.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-sizing" role="function">
<title>gtk_tree_view_column_set_sizing ()</title>
<indexterm zone="gtk-tree-view-column-set-sizing"><primary sortas="tree_view_column_set_sizing">gtk_tree_view_column_set_sizing</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkTreeViewColumnSizing"><type>GtkTreeViewColumnSizing</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-sizing" role="function">
<title>gtk_tree_view_column_get_sizing ()</title>
<indexterm zone="gtk-tree-view-column-get-sizing"><primary sortas="tree_view_column_get_sizing">gtk_tree_view_column_get_sizing</primary></indexterm><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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The type of <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-width" role="function">
<title>gtk_tree_view_column_get_width ()</title>
<indexterm zone="gtk-tree-view-column-get-width"><primary sortas="tree_view_column_get_width">gtk_tree_view_column_get_width</primary></indexterm><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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The current width of <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-fixed-width" role="function">
<title>gtk_tree_view_column_get_fixed_width ()</title>
<indexterm zone="gtk-tree-view-column-get-fixed-width"><primary sortas="tree_view_column_get_fixed_width">gtk_tree_view_column_get_fixed_width</primary></indexterm><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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the fixed width of the column
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-fixed-width" role="function">
<title>gtk_tree_view_column_set_fixed_width ()</title>
<indexterm zone="gtk-tree-view-column-set-fixed-width"><primary sortas="tree_view_column_set_fixed_width">gtk_tree_view_column_set_fixed_width</primary></indexterm><programlisting><link linkend="void">void</link>                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"><type>GTK_TREE_VIEW_COLUMN_FIXED</type></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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>fixed_width</parameter>&#160;:</term>
<listitem><simpara> The size to set <parameter>tree_column</parameter> to. Must be greater than 0.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-min-width" role="function">
<title>gtk_tree_view_column_set_min_width ()</title>
<indexterm zone="gtk-tree-view-column-set-min-width"><primary sortas="tree_view_column_set_min_width">gtk_tree_view_column_set_min_width</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>min_width</parameter>&#160;:</term>
<listitem><simpara> The minimum width of the column in pixels, or -1.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-min-width" role="function">
<title>gtk_tree_view_column_get_min_width ()</title>
<indexterm zone="gtk-tree-view-column-get-min-width"><primary sortas="tree_view_column_get_min_width">gtk_tree_view_column_get_min_width</primary></indexterm><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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The minimum width of the <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-max-width" role="function">
<title>gtk_tree_view_column_set_max_width ()</title>
<indexterm zone="gtk-tree-view-column-set-max-width"><primary sortas="tree_view_column_set_max_width">gtk_tree_view_column_set_max_width</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>max_width</parameter>&#160;:</term>
<listitem><simpara> The maximum width of the column in pixels, or -1.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-max-width" role="function">
<title>gtk_tree_view_column_get_max_width ()</title>
<indexterm zone="gtk-tree-view-column-get-max-width"><primary sortas="tree_view_column_get_max_width">gtk_tree_view_column_get_max_width</primary></indexterm><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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The maximum width of the <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-clicked" role="function">
<title>gtk_tree_view_column_clicked ()</title>
<indexterm zone="gtk-tree-view-column-clicked"><primary sortas="tree_view_column_clicked">gtk_tree_view_column_clicked</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-title" role="function">
<title>gtk_tree_view_column_set_title ()</title>
<indexterm zone="gtk-tree-view-column-set-title"><primary sortas="tree_view_column_set_title">gtk_tree_view_column_set_title</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>title</parameter>&#160;:</term>
<listitem><simpara> The title of the <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-title" role="function">
<title>gtk_tree_view_column_get_title ()</title>
<indexterm zone="gtk-tree-view-column-get-title"><primary sortas="tree_view_column_get_title">gtk_tree_view_column_get_title</primary></indexterm><programlisting>const <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.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the title of the column. This string should not be
modified or freed.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-expand" role="function" condition="since:2.4">
<title>gtk_tree_view_column_set_expand ()</title>
<indexterm zone="gtk-tree-view-column-set-expand" role="2.4"><primary sortas="tree_view_column_set_expand">gtk_tree_view_column_set_expand</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_tree_view_column_set_expand     (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                                         <link linkend="gboolean">gboolean</link> expand);</programlisting>
<para>
Sets the column to take available extra space.  This space is shared equally
amongst all columns that have the expand set to <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>.  If no column has this
option set, then the last column gets all extra space.  By default, every
column is created with this <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>expand</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the column should take available extra space, <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> if not
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-tree-view-column-get-expand" role="function" condition="since:2.4">
<title>gtk_tree_view_column_get_expand ()</title>
<indexterm zone="gtk-tree-view-column-get-expand" role="2.4"><primary sortas="tree_view_column_get_expand">gtk_tree_view_column_get_expand</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_tree_view_column_get_expand     (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Return <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the column expands to take any available space.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, if the column expands

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-tree-view-column-set-clickable" role="function">
<title>gtk_tree_view_column_set_clickable ()</title>
<indexterm zone="gtk-tree-view-column-set-clickable"><primary sortas="tree_view_column_set_clickable">gtk_tree_view_column_set_clickable</primary></indexterm><programlisting><link linkend="void">void</link>                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 <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>.  When the header is active,
then it can take keyboard focus, and can be clicked.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>clickable</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the header is active.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-clickable" role="function">
<title>gtk_tree_view_column_get_clickable ()</title>
<indexterm zone="gtk-tree-view-column-get-clickable"><primary sortas="tree_view_column_get_clickable">gtk_tree_view_column_get_clickable</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_tree_view_column_get_clickable  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the user can click on the header for the column.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if user can click the column header.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-widget" role="function">
<title>gtk_tree_view_column_set_widget ()</title>
<indexterm zone="gtk-tree-view-column-set-widget"><primary sortas="tree_view_column_set_widget">gtk_tree_view_column_set_widget</primary></indexterm><programlisting><link linkend="void">void</link>                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 <link linkend="NULL--CAPS"><literal>NULL</literal></link>, then the
header button is set with a <link linkend="GtkLabel"><type>GtkLabel</type></link> set to the title of <parameter>tree_column</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
<listitem><simpara> A child <link linkend="GtkWidget"><type>GtkWidget</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-widget" role="function">
<title>gtk_tree_view_column_get_widget ()</title>
<indexterm zone="gtk-tree-view-column-get-widget"><primary sortas="tree_view_column_get_widget">gtk_tree_view_column_get_widget</primary></indexterm><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"><type>GtkWidget</type></link> in the button on the column header.  If a custom
widget has not been set then <link linkend="NULL--CAPS"><literal>NULL</literal></link> is returned.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The <link linkend="GtkWidget"><type>GtkWidget</type></link> in the column header, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-alignment" role="function">
<title>gtk_tree_view_column_set_alignment ()</title>
<indexterm zone="gtk-tree-view-column-set-alignment"><primary sortas="tree_view_column_set_alignment">gtk_tree_view_column_set_alignment</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>xalign</parameter>&#160;:</term>
<listitem><simpara> The alignment, which is between [0.0 and 1.0] inclusive.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-alignment" role="function">
<title>gtk_tree_view_column_get_alignment ()</title>
<indexterm zone="gtk-tree-view-column-get-alignment"><primary sortas="tree_view_column_get_alignment">gtk_tree_view_column_get_alignment</primary></indexterm><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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The current alignent of <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-reorderable" role="function">
<title>gtk_tree_view_column_set_reorderable ()</title>
<indexterm zone="gtk-tree-view-column-set-reorderable"><primary sortas="tree_view_column_set_reorderable">gtk_tree_view_column_set_reorderable</primary></indexterm><programlisting><link linkend="void">void</link>                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"><literal>TRUE</literal></link>, then the column can be reordered by the end user
dragging the header.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>reorderable</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, if the column can be reordered.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-reorderable" role="function">
<title>gtk_tree_view_column_get_reorderable ()</title>
<indexterm zone="gtk-tree-view-column-get-reorderable"><primary sortas="tree_view_column_get_reorderable">gtk_tree_view_column_get_reorderable</primary></indexterm><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"><literal>TRUE</literal></link> if the <parameter>tree_column</parameter> can be reordered by the user.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the <parameter>tree_column</parameter> can be reordered by the user.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-sort-column-id" role="function">
<title>gtk_tree_view_column_set_sort_column_id ()</title>
<indexterm zone="gtk-tree-view-column-set-sort-column-id"><primary sortas="tree_view_column_set_sort_column_id">gtk_tree_view_column_set_sort_column_id</primary></indexterm><programlisting><link linkend="void">void</link>                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><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sort_column_id</parameter>&#160;:</term>
<listitem><simpara> The <parameter>sort_column_id</parameter> of the model to sort on.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-sort-column-id" role="function">
<title>gtk_tree_view_column_get_sort_column_id ()</title>
<indexterm zone="gtk-tree-view-column-get-sort-column-id"><primary sortas="tree_view_column_get_sort_column_id">gtk_tree_view_column_get_sort_column_id</primary></indexterm><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"><function>gtk_tree_view_column_set_sort_column_id()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the current <parameter>sort_column_id</parameter> for this column, or -1 if
              this column can't be used for sorting.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-sort-indicator" role="function">
<title>gtk_tree_view_column_set_sort_indicator ()</title>
<indexterm zone="gtk-tree-view-column-set-sort-indicator"><primary sortas="tree_view_column_set_sort_indicator">gtk_tree_view_column_set_sort_indicator</primary></indexterm><programlisting><link linkend="void">void</link>                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 <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> to display an arrow in
the header button indicating the column is sorted. Call
<link linkend="gtk-tree-view-column-set-sort-order"><function>gtk_tree_view_column_set_sort_order()</function></link> to change the direction of
the arrow.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>setting</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> to display an indicator that the column is sorted
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-sort-indicator" role="function">
<title>gtk_tree_view_column_get_sort_indicator ()</title>
<indexterm zone="gtk-tree-view-column-get-sort-indicator"><primary sortas="tree_view_column_get_sort_indicator">gtk_tree_view_column_get_sort_indicator</primary></indexterm><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"><function>gtk_tree_view_column_set_sort_indicator()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> whether the sort indicator arrow is displayed
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-set-sort-order" role="function">
<title>gtk_tree_view_column_set_sort_order ()</title>
<indexterm zone="gtk-tree-view-column-set-sort-order"><primary sortas="tree_view_column_set_sort_order">gtk_tree_view_column_set_sort_order</primary></indexterm><programlisting><link linkend="void">void</link>                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"><function>gtk_tree_view_column_set_sort_column_id()</function></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"><function>gtk_tree_sortable_set_sort_column()</function></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"><function>gtk_tree_view_column_set_sort_indicator()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>order</parameter>&#160;:</term>
<listitem><simpara> sort order that the sort indicator should indicate
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-get-sort-order" role="function">
<title>gtk_tree_view_column_get_sort_order ()</title>
<indexterm zone="gtk-tree-view-column-get-sort-order"><primary sortas="tree_view_column_get_sort_order">gtk_tree_view_column_get_sort_order</primary></indexterm><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"><function>gtk_tree_view_column_set_sort_order()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the sort order the sort indicator is indicating
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-cell-set-cell-data" role="function">
<title>gtk_tree_view_column_cell_set_cell_data ()</title>
<indexterm zone="gtk-tree-view-column-cell-set-cell-data"><primary sortas="tree_view_column_cell_set_cell_data">gtk_tree_view_column_cell_set_cell_data</primary></indexterm><programlisting><link linkend="void">void</link>                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>iter</parameter>.  That is, for
every attribute mapping in <parameter>tree_column</parameter>, it will get a value from the set
column on the <parameter>iter</parameter>, and use that value to set the attribute on the cell
renderer.  This is used primarily by the <link linkend="GtkTreeView"><type>GtkTreeView</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tree_model</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> to to get the cell renderers attributes from.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link> to to get the cell renderer's attributes from.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>is_expander</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, if the row has children
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>is_expanded</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, if the row has visible children
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-cell-get-size" role="function">
<title>gtk_tree_view_column_cell_get_size ()</title>
<indexterm zone="gtk-tree-view-column-cell-get-size"><primary sortas="tree_view_column_cell_get_size">gtk_tree_view_column_cell_get_size</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_tree_view_column_cell_get_size  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                                         const <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"><type>GtkTreeView</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell_area</parameter>&#160;:</term>
<listitem><simpara> The area a cell in the column will be allocated, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>x_offset</parameter>&#160;:</term>
<listitem><simpara> location to return x offset of a cell relative to <parameter>cell_area</parameter>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>y_offset</parameter>&#160;:</term>
<listitem><simpara> location to return y offset of a cell relative to <parameter>cell_area</parameter>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>width</parameter>&#160;:</term>
<listitem><simpara> location to return width needed to render a cell, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>height</parameter>&#160;:</term>
<listitem><simpara> location to return height needed to render a cell, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-cell-get-position" role="function">
<title>gtk_tree_view_column_cell_get_position ()</title>
<indexterm zone="gtk-tree-view-column-cell-get-position"><primary sortas="tree_view_column_cell_get_position">gtk_tree_view_column_cell_get_position</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_tree_view_column_cell_get_position
                                                        (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell_renderer,
                                                         <link linkend="gint">gint</link> *start_pos,
                                                         <link linkend="gint">gint</link> *width);</programlisting>
<para>
Obtains the horizontal position and size of a cell in a column. If the
cell is not found in the column, <parameter>start_pos</parameter> and <parameter>width</parameter> are not changed and
<link linkend="FALSE--CAPS"><literal>FALSE</literal></link> is returned.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell_renderer</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>start_pos</parameter>&#160;:</term>
<listitem><simpara> return location for the horizontal position of <parameter>cell</parameter> within
           <parameter>tree_column</parameter>, may be <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>width</parameter>&#160;:</term>
<listitem><simpara> return location for the width of <parameter>cell</parameter>, may be <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if <parameter>cell</parameter> belongs to <parameter>tree_column</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-cell-is-visible" role="function">
<title>gtk_tree_view_column_cell_is_visible ()</title>
<indexterm zone="gtk-tree-view-column-cell-is-visible"><primary sortas="tree_view_column_cell_is_visible">gtk_tree_view_column_cell_is_visible</primary></indexterm><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"><literal>TRUE</literal></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"><function>gtk_tree_view_column_cell_set_cell_data()</function></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, if any of the cells packed into the <parameter>tree_column</parameter> are currently visible
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-tree-view-column-focus-cell" role="function" condition="since:2.2">
<title>gtk_tree_view_column_focus_cell ()</title>
<indexterm zone="gtk-tree-view-column-focus-cell" role="2.2"><primary sortas="tree_view_column_focus_cell">gtk_tree_view_column_focus_cell</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_tree_view_column_focus_cell     (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell);</programlisting>
<para>
Sets the current keyboard focus to be at <parameter>cell</parameter>, if the column contains
2 or more editable and activatable cells.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.2</para></refsect2>
<refsect2 id="gtk-tree-view-column-queue-resize" role="function" condition="since:2.8">
<title>gtk_tree_view_column_queue_resize ()</title>
<indexterm zone="gtk-tree-view-column-queue-resize" role="2.8"><primary sortas="tree_view_column_queue_resize">gtk_tree_view_column_queue_resize</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_tree_view_column_queue_resize   (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Flags the column, and the cell renderers added to this column, to have
their sizes renegotiated.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-tree-view-column-get-tree-view" role="function" condition="since:2.12">
<title>gtk_tree_view_column_get_tree_view ()</title>
<indexterm zone="gtk-tree-view-column-get-tree-view" role="2.12"><primary sortas="tree_view_column_get_tree_view">gtk_tree_view_column_get_tree_view</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_tree_view_column_get_tree_view  (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *tree_column);</programlisting>
<para>
Returns the <link linkend="GtkTreeView"><type>GtkTreeView</type></link> wherein <parameter>tree_column</parameter> has been inserted.  If
<parameter>column</parameter> is currently not inserted in any tree view, <link linkend="NULL--CAPS"><literal>NULL</literal></link> is
returned.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>tree_column</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The tree view wherein <parameter>column</parameter> has been inserted if any,
              <link linkend="NULL--CAPS"><literal>NULL</literal></link> otherwise.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.12</para></refsect2>

</refsect1>
<refsect1 id="GtkTreeViewColumn.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkTreeViewColumn--alignment" role="property"><title>The <literal>&quot;alignment&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--alignment"><primary sortas="TreeViewColumn:alignment">GtkTreeViewColumn:alignment</primary></indexterm><programlisting>  &quot;alignment&quot;                <link linkend="gfloat">gfloat</link>                : Read / Write</programlisting>
<para>X Alignment of the column header text or widget.</para><para>Allowed values: [0,1]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--clickable" role="property"><title>The <literal>&quot;clickable&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--clickable"><primary sortas="TreeViewColumn:clickable">GtkTreeViewColumn:clickable</primary></indexterm><programlisting>  &quot;clickable&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether the header can be clicked.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--expand" role="property"><title>The <literal>&quot;expand&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--expand"><primary sortas="TreeViewColumn:expand">GtkTreeViewColumn:expand</primary></indexterm><programlisting>  &quot;expand&quot;                   <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Column gets share of extra width allocated to the widget.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--fixed-width" role="property"><title>The <literal>&quot;fixed-width&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--fixed-width"><primary sortas="TreeViewColumn:fixed-width">GtkTreeViewColumn:fixed-width</primary></indexterm><programlisting>  &quot;fixed-width&quot;              <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>Current fixed width of the column.</para><para>Allowed values: &gt;= 1</para>
<para>Default value: 1</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--max-width" role="property"><title>The <literal>&quot;max-width&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--max-width"><primary sortas="TreeViewColumn:max-width">GtkTreeViewColumn:max-width</primary></indexterm><programlisting>  &quot;max-width&quot;                <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>Maximum allowed width of the column.</para><para>Allowed values: &gt;= G_MAXULONG</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--min-width" role="property"><title>The <literal>&quot;min-width&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--min-width"><primary sortas="TreeViewColumn:min-width">GtkTreeViewColumn:min-width</primary></indexterm><programlisting>  &quot;min-width&quot;                <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>Minimum allowed width of the column.</para><para>Allowed values: &gt;= G_MAXULONG</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--reorderable" role="property"><title>The <literal>&quot;reorderable&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--reorderable"><primary sortas="TreeViewColumn:reorderable">GtkTreeViewColumn:reorderable</primary></indexterm><programlisting>  &quot;reorderable&quot;              <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether the column can be reordered around the headers.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--resizable" role="property"><title>The <literal>&quot;resizable&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--resizable"><primary sortas="TreeViewColumn:resizable">GtkTreeViewColumn:resizable</primary></indexterm><programlisting>  &quot;resizable&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Column is user-resizable.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--sizing" role="property"><title>The <literal>&quot;sizing&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--sizing"><primary sortas="TreeViewColumn:sizing">GtkTreeViewColumn:sizing</primary></indexterm><programlisting>  &quot;sizing&quot;                   <link linkend="GtkTreeViewColumnSizing">GtkTreeViewColumnSizing</link>  : Read / Write</programlisting>
<para>Resize mode of the column.</para><para>Default value: GTK_TREE_VIEW_COLUMN_GROW_ONLY</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--sort-column-id" role="property"><title>The <literal>&quot;sort-column-id&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--sort-column-id" role="2.18"><primary sortas="TreeViewColumn:sort-column-id">GtkTreeViewColumn:sort-column-id</primary></indexterm><programlisting>  &quot;sort-column-id&quot;           <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
Logical sort column ID this column sorts on when selected for sorting. Setting the sort column ID makes the column header
clickable. Set to <link linkend="1--CAPS"><literal>-1</literal></link> to make the column unsortable.</para>
<para>
</para><para>Allowed values: &gt;= G_MAXULONG</para>
<para>Default value: -1</para>
<para>Since 2.18</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--sort-indicator" role="property"><title>The <literal>&quot;sort-indicator&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--sort-indicator"><primary sortas="TreeViewColumn:sort-indicator">GtkTreeViewColumn:sort-indicator</primary></indexterm><programlisting>  &quot;sort-indicator&quot;           <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether to show a sort indicator.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--sort-order" role="property"><title>The <literal>&quot;sort-order&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--sort-order"><primary sortas="TreeViewColumn:sort-order">GtkTreeViewColumn:sort-order</primary></indexterm><programlisting>  &quot;sort-order&quot;               <link linkend="GtkSortType">GtkSortType</link>           : Read / Write</programlisting>
<para>Sort direction the sort indicator should indicate.</para><para>Default value: GTK_SORT_ASCENDING</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--spacing" role="property"><title>The <literal>&quot;spacing&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--spacing"><primary sortas="TreeViewColumn:spacing">GtkTreeViewColumn:spacing</primary></indexterm><programlisting>  &quot;spacing&quot;                  <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>Space which is inserted between cells.</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--title" role="property"><title>The <literal>&quot;title&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--title"><primary sortas="TreeViewColumn:title">GtkTreeViewColumn:title</primary></indexterm><programlisting>  &quot;title&quot;                    <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>Title to appear in column header.</para><para>Default value: ""</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--visible" role="property"><title>The <literal>&quot;visible&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--visible"><primary sortas="TreeViewColumn:visible">GtkTreeViewColumn:visible</primary></indexterm><programlisting>  &quot;visible&quot;                  <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether to display the column.</para><para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkTreeViewColumn--widget" role="property"><title>The <literal>&quot;widget&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--widget"><primary sortas="TreeViewColumn:widget">GtkTreeViewColumn:widget</primary></indexterm><programlisting>  &quot;widget&quot;                   <link linkend="GtkWidget">GtkWidget</link>*            : Read / Write</programlisting>
<para>Widget to put in column header button instead of column title.</para></refsect2>
<refsect2 id="GtkTreeViewColumn--width" role="property"><title>The <literal>&quot;width&quot;</literal> property</title>
<indexterm zone="GtkTreeViewColumn--width"><primary sortas="TreeViewColumn:width">GtkTreeViewColumn:width</primary></indexterm><programlisting>  &quot;width&quot;                    <link linkend="gint">gint</link>                  : Read</programlisting>
<para>Current width of the column.</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
</refsect1>

<refsect1 id="GtkTreeViewColumn.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkTreeViewColumn-clicked" role="signal"><title>The <literal>&quot;clicked&quot;</literal> signal</title>
<indexterm zone="GtkTreeViewColumn-clicked"><primary sortas="TreeViewColumn::clicked">GtkTreeViewColumn::clicked</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkTreeViewColumn">GtkTreeViewColumn</link> *treeviewcolumn,
                                                        <link linkend="gpointer">gpointer</link>           user_data)           : Run Last</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>treeviewcolumn</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>


<refsect1 id="GtkTreeViewColumn.see-also">
<title>See Also</title>
<para>
<link linkend="GtkTreeView"><type>GtkTreeView</type></link>, <link linkend="GtkTreeSelection"><type>GtkTreeSelection</type></link>, <link linkend="GtkTreeDnd"><type>GtkTreeDnd</type></link>, <link linkend="GtkTreeMode"><type>GtkTreeMode</type></link>, <link linkend="GtkTreeSortable"><type>GtkTreeSortable</type></link>, <link linkend="GtkTreeModelSort"><type>GtkTreeModelSort</type></link>, <link linkend="GtkListStore"><type>GtkListStore</type></link>, <link linkend="GtkTreeStore"><type>GtkTreeStore</type></link>, <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link>, <link linkend="GtkCellEditable"><type>GtkCellEditable</type></link>, <link linkend="GtkCellRendererPixbuf"><type>GtkCellRendererPixbuf</type></link>, <link linkend="GtkCellRendererText"><type>GtkCellRendererText</type></link>, <link linkend="GtkCellRendererToggle"><type>GtkCellRendererToggle</type></link>
</para>
</refsect1>

</refentry>
