/usr/share/gtk-doc/html/pygtk/class-gtktreeviewcolumn.html

<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.TreeViewColumn</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtktreeview.html" title="gtk.TreeView"><link rel="next" href="class-gtkuimanager.html" title="gtk.UIManager"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.TreeViewColumn</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtktreeview.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkuimanager.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.TreeViewColumn"><a name="class-gtktreeviewcolumn"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.TreeViewColumn</h2><p>gtk.TreeViewColumn — a visible column in a <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
widget</p></div><div class="refsect1" title="Synopsis"><a name="id4058860"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.TreeViewColumn</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a></span></span>):
<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#constructor-gtktreeviewcolumn" title="Constructor">gtk.TreeViewColumn</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>title</code></em></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell_renderer</code></em></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--pack-start" title="gtk.TreeViewColumn.pack_start">pack_start</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>expand</code></strong></span><span class="initializer">=True</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--pack-end" title="gtk.TreeViewColumn.pack_end">pack_end</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>expand</code></strong></span><span class="initializer">=True</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--clear" title="gtk.TreeViewColumn.clear">clear</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-cell-renderers" title="gtk.TreeViewColumn.get_cell_renderers">get_cell_renderers</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--add-attribute" title="gtk.TreeViewColumn.add_attribute">add_attribute</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell_renderer</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>attribute</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-attributes" title="gtk.TreeViewColumn.set_attributes">set_attributes</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>cell_renderer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-cell-data-func" title="gtk.TreeViewColumn.set_cell_data_func">set_cell_data_func</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>cell_renderer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>func</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>func_data</code></em></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--clear-attributes" title="gtk.TreeViewColumn.clear_attributes">clear_attributes</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell_renderer</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-spacing" title="gtk.TreeViewColumn.set_spacing">set_spacing</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>spacing</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-spacing" title="gtk.TreeViewColumn.get_spacing">get_spacing</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-visible" title="gtk.TreeViewColumn.set_visible">set_visible</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>visible</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-visible" title="gtk.TreeViewColumn.get_visible">get_visible</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-resizable" title="gtk.TreeViewColumn.set_resizable">set_resizable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>resizable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-resizable" title="gtk.TreeViewColumn.get_resizable">get_resizable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sizing" title="gtk.TreeViewColumn.set_sizing">set_sizing</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>type</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-sizing" title="gtk.TreeViewColumn.get_sizing">get_sizing</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-width" title="gtk.TreeViewColumn.get_width">get_width</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-fixed-width" title="gtk.TreeViewColumn.get_fixed_width">get_fixed_width</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-fixed-width" title="gtk.TreeViewColumn.set_fixed_width">set_fixed_width</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>fixed_width</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-min-width" title="gtk.TreeViewColumn.set_min_width">set_min_width</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_width</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-min-width" title="gtk.TreeViewColumn.get_min_width">get_min_width</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-max-width" title="gtk.TreeViewColumn.set_max_width">set_max_width</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_width</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-max-width" title="gtk.TreeViewColumn.get_max_width">get_max_width</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--clicked" title="gtk.TreeViewColumn.clicked">clicked</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-title" title="gtk.TreeViewColumn.set_title">set_title</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-title" title="gtk.TreeViewColumn.get_title">get_title</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-expand" title="gtk.TreeViewColumn.set_expand">set_expand</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>expand</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-expand" title="gtk.TreeViewColumn.get_expand">get_expand</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-clickable" title="gtk.TreeViewColumn.set_clickable">set_clickable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>active</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-clickable" title="gtk.TreeViewColumn.get_clickable">get_clickable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-widget" title="gtk.TreeViewColumn.set_widget">set_widget</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-widget" title="gtk.TreeViewColumn.get_widget">get_widget</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-alignment" title="gtk.TreeViewColumn.set_alignment">set_alignment</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>xalign</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-alignment" title="gtk.TreeViewColumn.get_alignment">get_alignment</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-reorderable" title="gtk.TreeViewColumn.set_reorderable">set_reorderable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>reorderable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-reorderable" title="gtk.TreeViewColumn.get_reorderable">get_reorderable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-column-id" title="gtk.TreeViewColumn.set_sort_column_id">set_sort_column_id</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sort_column_id</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-sort-column-id" title="gtk.TreeViewColumn.get_sort_column_id">get_sort_column_id</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-indicator" title="gtk.TreeViewColumn.set_sort_indicator">set_sort_indicator</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-sort-indicator" title="gtk.TreeViewColumn.get_sort_indicator">get_sort_indicator</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-order" title="gtk.TreeViewColumn.set_sort_order">set_sort_order</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>order</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-sort-order" title="gtk.TreeViewColumn.get_sort_order">get_sort_order</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--cell-set-cell-data" title="gtk.TreeViewColumn.cell_set_cell_data">cell_set_cell_data</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_model</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>is_expander</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>is_expanded</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--cell-get-size" title="gtk.TreeViewColumn.cell_get_size">cell_get_size</a></span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>cell_area</code></em></span><span class="initializer">=(0,0,0,0)</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--cell-is-visible" title="gtk.TreeViewColumn.cell_is_visible">cell_is_visible</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--focus-cell" title="gtk.TreeViewColumn.focus_cell">focus_cell</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--cell-get-position" title="gtk.TreeViewColumn.cell_get_position">cell_get_position</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell_renderer</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--queue-resize" title="gtk.TreeViewColumn.queue_resize">queue_resize</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--get-tree-view" title="gtk.TreeViewColumn.get_tree_view">get_tree_view</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id4060273"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
  +-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
    +-- <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn">gtk.TreeViewColumn</a>
</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id4060305"></a><h2>Implemented Interfaces</h2><p>
			<a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
			implements 
			<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
		</p></div><div class="refsect1" title="gtk.TreeViewColumn Properties"><a name="properties-gtktreeviewcolumn"></a><h2>gtk.TreeViewColumn Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"alignment"</td><td valign="top">Read-Write</td><td valign="top">The alignment of the column header text or
widget</td></tr><tr valign="top"><td valign="top">"clickable"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the header can be
clicked</td></tr><tr valign="top"><td valign="top">"expand"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the column can expand to
take extra available space. Available in GTK+ 2.4 and above</td></tr><tr valign="top"><td valign="top">"fixed-width"</td><td valign="top">Read-Write</td><td valign="top">The current fixed width of the column</td></tr><tr valign="top"><td valign="top">"max-width"</td><td valign="top">Read-Write</td><td valign="top">The maximum allowed width of the column</td></tr><tr valign="top"><td valign="top">"min-width"</td><td valign="top">Read-Write</td><td valign="top">The minimum allowed width of the column</td></tr><tr valign="top"><td valign="top">"reorderable"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the column can be reordered
around the headers</td></tr><tr valign="top"><td valign="top">"resizable"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the user can resize the
column</td></tr><tr valign="top"><td valign="top">"sizing"</td><td valign="top">Read-Write</td><td valign="top">The resize mode of the column:
<code class="literal">gtk.TREE_VIEW_COLUMN_GROW_ONLY</code>,
<code class="literal">gtk.TREE_VIEW_COLUMN_AUTOSIZE</code> or
<code class="literal">gtk.TREE_VIEW_COLUMN_FIXED</code></td></tr><tr valign="top"><td valign="top">"sort-indicator"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, how a sort
indicator</td></tr><tr valign="top"><td valign="top">"sort-order"</td><td valign="top">Read-Write</td><td valign="top">The sort direction the sort indicator should indicate:
<code class="literal">gtk.SORT_ASCENDING</code> or
<code class="literal">gtk.SORT_DESCENDING</code></td></tr><tr valign="top"><td valign="top">"spacing"</td><td valign="top">Read-Write</td><td valign="top">Space which is inserted between cells</td></tr><tr valign="top"><td valign="top">"title"</td><td valign="top">Read-Write</td><td valign="top">The title to appear in the column header</td></tr><tr valign="top"><td valign="top">"visible"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, display the column</td></tr><tr valign="top"><td valign="top">"widget"</td><td valign="top">Read-Write</td><td valign="top">The widget to put in the column header button instead
of the column title</td></tr><tr valign="top"><td valign="top">"width"</td><td valign="top">Read</td><td valign="top">The current width of the column</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.TreeViewColumn Signal Prototypes"><a name="signal-prototypes-gtktreeviewcolumn"></a><h2>gtk.TreeViewColumn Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtktreeviewcolumn.html#signal-gtktreeviewcolumn--clicked" title='The "clicked" gtk.TreeViewColumn Signal'>clicked</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeviewcolumn</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id4060839"></a><h2>Description</h2><p>The <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
object is a visible column in a <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
widget. A <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
manages the display of the header and the cells using a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>.</p><p>In PyGTK 2.4 <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>
implementes the <a class="link" href="class-gtkcelllayout.html" title="gtk.CellLayout"><code class="classname">gtk.CellLayout</code></a>
interface.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtktreeviewcolumn"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">gtk.TreeViewColumn</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>title</code></em></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell_renderer</code></em></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td><td>the header title string</td></tr><tr><td><p><span class="term"><em class="parameter"><code>cell_renderer</code></em> :</span></p></td><td>a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>zero or more <code class="literal">attribute=column</code>
pairs</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A newly created <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>.</td></tr></tbody></table><p>Creates a new <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a> 
with the header string specified by <em class="parameter"><code>title</code></em> and using
the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a> 
specified by <em class="parameter"><code>cell_renderer</code></em>. Zero or more
<code class="literal">attribute=column</code> pairs may be added to specify from which
tree model column to retrieve the attribute value. For example:</p><pre class="programlisting">
  column = gtk.TreeViewColumn('Column Title', cell_renderer, text=0, foreground=1)
</pre><p>will retrieve the 'text' attribute values for the cell renderer
from column 0 in the treemodel and the 'foreground' attribute values from
column 1. See the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--add-attribute" title="gtk.TreeViewColumn.add_attribute"><code class="methodname">add_attribute</code>()</a> 
method for more detail.</p></div><div class="refsect1" title="Methods"><a name="id4061121"></a><h2>Methods</h2><div class="refsect2" title="gtk.TreeViewColumn.pack_start"><a name="method-gtktreeviewcolumn--pack-start"></a><h3>gtk.TreeViewColumn.pack_start</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">pack_start</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>expand</code></strong></span><span class="initializer">=True</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cell</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>expand</code></strong> :</span></p></td><td>if <code class="literal">True</code>
<em class="parameter"><code>cell</code></em> is to be given the extra space allocated to the
cell box.</td></tr></tbody></table><p>The <code class="methodname">pack_start</code>() method packs the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>
specified by <em class="parameter"><code>cell</code></em> into the beginning column. If
<em class="parameter"><code>expand</code></em> is <code class="literal">True</code>, then the
<em class="parameter"><code>cell</code></em> is allocated a share of all available space that
the column is allocated. Note <em class="parameter"><code>expand</code></em> defaults to
<code class="literal">True</code> in PyGTK 2.4.</p></div><div class="refsect2" title="gtk.TreeViewColumn.pack_end"><a name="method-gtktreeviewcolumn--pack-end"></a><h3>gtk.TreeViewColumn.pack_end</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">pack_end</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>expand</code></strong></span><span class="initializer">=True</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cell</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>expand</code></strong> :</span></p></td><td>if <code class="literal">True</code>
<em class="parameter"><code>cell</code></em> is to be given the extra space allocated to the
cell box.</td></tr></tbody></table><p>The <code class="methodname">pack_end</code>() method packs the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a> 
specified by <em class="parameter"><code>cell</code></em> into the column. If
<em class="parameter"><code>expand</code></em> is <code class="literal">True</code>, then the
<em class="parameter"><code>cell</code></em> is allocated a share of all available space that
the column is allocated. Note <em class="parameter"><code>expand</code></em> defaults to
<code class="literal">True</code> in PyGTK 2.4.</p></div><div class="refsect2" title="gtk.TreeViewColumn.clear"><a name="method-gtktreeviewcolumn--clear"></a><h3>gtk.TreeViewColumn.clear</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">clear</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">clear</code>() method unsets all the
mappings on all renderers on the column.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_cell_renderers"><a name="method-gtktreeviewcolumn--get-cell-renderers"></a><h3>gtk.TreeViewColumn.get_cell_renderers</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_cell_renderers</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a> 
objects</td></tr></tbody></table><p>The <code class="methodname">get_cell_renderers</code>() method returns
a list containing all the cell renderers in the column, in no particular
order.</p></div><div class="refsect2" title="gtk.TreeViewColumn.add_attribute"><a name="method-gtktreeviewcolumn--add-attribute"></a><h3>gtk.TreeViewColumn.add_attribute</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_attribute</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell_renderer</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>attribute</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cell_renderer</code></strong> :</span></p></td><td>the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a> 
to set attributes on</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>attribute</code></strong> :</span></p></td><td>an attribute on the
renderer</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>the column position on the model to get the
attribute from.</td></tr></tbody></table><p>The <code class="methodname">add_attribute</code>() method adds an
attribute mapping to the list in the tree column.  The
<em class="parameter"><code>column</code></em> is the column of the tree model to get a value
from, and the <em class="parameter"><code>attribute</code></em> is the parameter on
<em class="parameter"><code>cell_renderer</code></em> 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 <a class="link" href="class-gtkcellrenderertext.html" title="gtk.CellRendererText"><code class="classname">gtk.CellRendererText</code></a> 
get its values from column 2.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_attributes"><a name="method-gtktreeviewcolumn--set-attributes"></a><h3>gtk.TreeViewColumn.set_attributes</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_attributes</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>cell_renderer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>cell_renderer</code></em> :</span></p></td><td>the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a> 
we're setting the attributes of</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>zero or more
<code class="literal">attribute=column</code> pairs</td></tr></tbody></table><p>The <code class="methodname">set_attributes</code>() method sets the
attribute locations of the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a> 
specified by <em class="parameter"><code>cell_renderer</code></em> using the
<code class="literal">attribute=column</code> pairs (e.g. text=0, foreground=1). See
the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--add-attribute" title="gtk.TreeViewColumn.add_attribute"><code class="methodname">add_attribute</code>()</a> 
method for more detail. All existing cell attributes are removed, and
replaced with the new attributes.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_cell_data_func"><a name="method-gtktreeviewcolumn--set-cell-data-func"></a><h3>gtk.TreeViewColumn.set_cell_data_func</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_cell_data_func</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>cell_renderer</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>func</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>func_data</code></em></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>cell_renderer</code></em> :</span></p></td><td>a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td><td>the function or method to
use.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>func_data</code></em> :</span></p></td><td>the user data to pass when calling
<em class="parameter"><code>func</code></em>.</td></tr></tbody></table><p>The <code class="methodname">set_cell_data_func</code>() method sets
the data function (or method) to use for the column <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a> 
specified by <em class="parameter"><code>cell_renderer</code></em>. This function (or method)
is used instead of the standard attribute mappings for setting the column
values, and should set the attributes of the cell renderer as appropriate.
<em class="parameter"><code>func</code></em> may be <code class="literal">None</code> to remove the
current data function. The signature of <em class="parameter"><code>func</code></em>
is:</p><pre class="programlisting">
<code class="methodsynopsis">    def <span class="methodname">celldatafunction</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>column</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>model</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_data</code></em></span></span>)</code><br>
<code class="methodsynopsis">    def <span class="methodname">celldatamethod</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>self</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>column</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>cell</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>model</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>iter</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_data</code></em></span></span>)</code>
</pre><p>where <em class="parameter"><code>column</code></em> is the <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a> 
in the treeview, <em class="parameter"><code>cell</code></em> is the <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a> 
for <em class="parameter"><code>column</code></em>, <em class="parameter"><code>model</code></em> is the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> for
the treeview and <em class="parameter"><code>iter</code></em> is the <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing at the row.</p></div><div class="refsect2" title="gtk.TreeViewColumn.clear_attributes"><a name="method-gtktreeviewcolumn--clear-attributes"></a><h3>gtk.TreeViewColumn.clear_attributes</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">clear_attributes</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell_renderer</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cell_renderer</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a> 
to clear the attribute mapping on.</td></tr></tbody></table><p>The <code class="methodname">clear_attributes</code>() method clears
all existing attributes previously set with the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-attributes" title="gtk.TreeViewColumn.set_attributes"><code class="methodname">set_attributes</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_spacing"><a name="method-gtktreeviewcolumn--set-spacing"></a><h3>gtk.TreeViewColumn.set_spacing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_spacing</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>spacing</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>spacing</code></strong> :</span></p></td><td>the distance between cell renderers in
pixels.</td></tr></tbody></table><p>The <code class="methodname">set_spacing</code>() method sets the
spacing field of the treeview column, which is the number of pixels to place
between cell renderers packed into it.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_spacing"><a name="method-gtktreeviewcolumn--get-spacing"></a><h3>gtk.TreeViewColumn.get_spacing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_spacing</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the spacing of the treeview
column.</td></tr></tbody></table><p>The <code class="methodname">get_spacing</code>() method returns the
spacing of the treeview column.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_visible"><a name="method-gtktreeviewcolumn--set-visible"></a><h3>gtk.TreeViewColumn.set_visible</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_visible</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>visible</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>visible</code></strong> :</span></p></td><td>if <code class="literal">True</code> the treeview column
is visible.</td></tr></tbody></table><p>The <code class="methodname">set_visible</code>() method sets the
"visible" property to the value of <em class="parameter"><code>visible</code></em>. If
<em class="parameter"><code>visible</code></em> is <code class="literal">True</code> the treeview
column is visible</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_visible"><a name="method-gtktreeviewcolumn--get-visible"></a><h3>gtk.TreeViewColumn.get_visible</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_visible</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the column is
visible</td></tr></tbody></table><p>The <code class="methodname">get_visible</code>() method returns the
value of the "visible" property. If "visible" is <code class="literal">True</code> the
treeview column is visible.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_resizable"><a name="method-gtktreeviewcolumn--set-resizable"></a><h3>gtk.TreeViewColumn.set_resizable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_resizable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>resizable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>resizable</code></strong> :</span></p></td><td>if <code class="literal">True</code>, the column can be
resized</td></tr></tbody></table><p>The <code class="methodname">set_resizable</code>() method sets the
"resizable" property to the value of <em class="parameter"><code>resizable</code></em>. If
<em class="parameter"><code>resizable</code></em> is <code class="literal">True</code> the user can
explicitly resize the column by grabbing the outer edge of the column
button. If <em class="parameter"><code>resizable</code></em> is <code class="literal">True</code> and
the sizing mode of the column is
<code class="literal">gtk.TREE_VIEW_COLUMN_AUTOSIZE</code>, the sizing mode is changed
to <code class="literal">gtk.TREE_VIEW_COLUMN_GROW_ONLY</code>.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_resizable"><a name="method-gtktreeviewcolumn--get-resizable"></a><h3>gtk.TreeViewColumn.get_resizable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_resizable</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code>, if the treeview column
can be resized.</td></tr></tbody></table><p>The <code class="methodname">get_resizable</code>() method returns the
value of the "resizable" property. If "resizable" is
<code class="literal">True</code>, the treeview column can be resized by the
user.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_sizing"><a name="method-gtktreeviewcolumn--set-sizing"></a><h3>gtk.TreeViewColumn.set_sizing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_sizing</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>type</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>type</code></strong> :</span></p></td><td>The treeview column sizing:
<code class="literal">gtk.TREE_VIEW_COLUMN_GROW_ONLY</code>,
<code class="literal">gtk.TREE_VIEW_COLUMN_AUTOSIZE</code> or
<code class="literal">gtk.TREE_VIEW_COLUMN_FIXED</code>.</td></tr></tbody></table><p>The <code class="methodname">set_sizing</code>() method sets the
"sizing" property to the value of <em class="parameter"><code>type</code></em>. The value of
type must be one of the <a class="xref" href="gtk-constants.html#gtk-treeviewcolumn-sizing-constants" title="GTK TreeViewColumn Sizing Constants">GTK TreeViewColumn Sizing Constants</a>.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_sizing"><a name="method-gtktreeviewcolumn--get-sizing"></a><h3>gtk.TreeViewColumn.get_sizing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_sizing</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the treeview column sizing
type.</td></tr></tbody></table><p>The <code class="methodname">get_sizing</code>() method returns the
value of the "sizing" property that contains the current type of the
treeview column sizing mode. See the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sizing" title="gtk.TreeViewColumn.set_sizing"><code class="methodname">set_sizing</code>()</a> 
method for more detail.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_width"><a name="method-gtktreeviewcolumn--get-width"></a><h3>gtk.TreeViewColumn.get_width</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_width</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the current width of the treeview
column.</td></tr></tbody></table><p>The <code class="methodname">get_width</code>() method returns the
value of the "width" property that contains the current size of the treeview
column in pixels.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_fixed_width"><a name="method-gtktreeviewcolumn--get-fixed-width"></a><h3>gtk.TreeViewColumn.get_fixed_width</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_fixed_width</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the fixed width of the treeview
column</td></tr></tbody></table><p>The <code class="methodname">get_fixed_width</code>() method returns
the value of the "fixed-width" property that contains the fixed width of the
treeview column i.e. the width of the treeview column only if the sizing
type is <code class="literal">gtk.TREE_VIEW_COLUMN_FIXED</code>.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_fixed_width"><a name="method-gtktreeviewcolumn--set-fixed-width"></a><h3>gtk.TreeViewColumn.set_fixed_width</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_fixed_width</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>fixed_width</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>fixed_width</code></strong> :</span></p></td><td>the size to set the treeview column to. Must be
greater than 0.</td></tr></tbody></table><p>The <code class="methodname">set_fixed_width</code>() method sets the
"fixed-width" property to the value of <em class="parameter"><code>fixed_width</code></em>.
The value of <em class="parameter"><code>fixed_width</code></em> is the size of the column in
pixels. This is meaningful only if the sizing type is
<code class="literal">gtk.TREE_VIEW_COLUMN_FIXED</code>. The size of the column is
clamped to the min and max width for the column. Please note that the min
and max width of the column doesn't actually affect the "fixed_width"
property of the widget, just the actual size when displayed.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_min_width"><a name="method-gtktreeviewcolumn--set-min-width"></a><h3>gtk.TreeViewColumn.set_min_width</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_min_width</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>min_width</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>min_width</code></strong> :</span></p></td><td>the minimum width of the treeview column in
pixels, or -1.</td></tr></tbody></table><p>The <code class="methodname">set_min_width</code>() method sets the
"min-width" property to the value of <em class="parameter"><code>min_width</code></em>. The
value of <em class="parameter"><code>min_width</code></em> is the minimum width of the
treeview column.  If <em class="parameter"><code>min_width</code></em> is -1, then the
minimum width is unset.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_min_width"><a name="method-gtktreeviewcolumn--get-min-width"></a><h3>gtk.TreeViewColumn.get_min_width</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_min_width</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the minimum width of the treeview
column.</td></tr></tbody></table><p>The <code class="methodname">get_min_width</code>() method returns the
value of the "min-width" property that contains the minimum width in pixels
of the treeview column, or -1 if no minimum width is set.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_max_width"><a name="method-gtktreeviewcolumn--set-max-width"></a><h3>gtk.TreeViewColumn.set_max_width</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_max_width</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>max_width</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>max_width</code></strong> :</span></p></td><td>the maximum width of the column in pixels, or
-1.</td></tr></tbody></table><p>The <code class="methodname">set_max_width</code>() method sets the
"max-width" property to the value of <em class="parameter"><code>max_width</code></em>. The
value of <em class="parameter"><code>max_width</code></em> becomes the maximum width of the
treeview column.  If <em class="parameter"><code>max_width</code></em> 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.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_max_width"><a name="method-gtktreeviewcolumn--get-max-width"></a><h3>gtk.TreeViewColumn.get_max_width</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_max_width</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the maximum width of the treeview
column.</td></tr></tbody></table><p>The <code class="methodname">get_max_width</code>() method returns the
value of the "max-width" property that contains the maximum width in pixels
of the treeview column, or -1 if no maximum width is set.</p></div><div class="refsect2" title="gtk.TreeViewColumn.clicked"><a name="method-gtktreeviewcolumn--clicked"></a><h3>gtk.TreeViewColumn.clicked</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">clicked</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">clicked</code>() method emits the
"clicked" signal on the treeview column. The treeview column must be
clickable.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_title"><a name="method-gtktreeviewcolumn--set-title"></a><h3>gtk.TreeViewColumn.set_title</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_title</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>title</code></strong> :</span></p></td><td>the title string of the treeview
column.</td></tr></tbody></table><p>The <code class="methodname">set_title</code>() method sets the "title"
property to the value of <em class="parameter"><code>title</code></em>. The "title" property
contains the string that is used to set the treeview column title.  If a
custom widget has been set (see the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-widget" title="gtk.TreeViewColumn.set_widget"><code class="methodname">set_widget</code>()</a> 
method), this value is ignored.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_title"><a name="method-gtktreeviewcolumn--get-title"></a><h3>gtk.TreeViewColumn.get_title</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_title</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the title of the column.</td></tr></tbody></table><p>The <code class="methodname">get_title</code>() method returns the
value of the "title" property that contains the treeview column
title.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_expand"><a name="method-gtktreeviewcolumn--set-expand"></a><h3>gtk.TreeViewColumn.set_expand</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_expand</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>expand</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>expand</code></strong> :</span></p></td><td>if <code class="literal">True</code> the column expands
	  to take extra space if available.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_expand</code>() method sets the
"expand" property to the value of <em class="parameter"><code>expand</code></em>. If expand
is <code class="literal">True</code> the column expands to take available extra
space. This space is shared equally among all columns that have their
"expand" property set to <code class="literal">True</code>. If no column has this
option set, then the last column gets all extra space. By default, every
column is created with this <code class="literal">False</code>.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_expand"><a name="method-gtktreeviewcolumn--get-expand"></a><h3>gtk.TreeViewColumn.get_expand</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_expand</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code>, if the column
	  expands</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">get_expand</code>() method returns the
value of the "expand" property. If "expand is <code class="literal">True</code> if the
column expands to take any available space.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_clickable"><a name="method-gtktreeviewcolumn--set-clickable"></a><h3>gtk.TreeViewColumn.set_clickable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_clickable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>active</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>active</code></strong> :</span></p></td><td>if <code class="literal">True</code> the treeview column
header can be clicked</td></tr></tbody></table><p>The <code class="methodname">set_clickable</code>() method sets the
"clickable" property to the value of <em class="parameter"><code>active</code></em>. If
<em class="parameter"><code>active</code></em> is <code class="literal">True</code> the header can take
keyboard focus, and be clicked.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_clickable"><a name="method-gtktreeviewcolumn--get-clickable"></a><h3>gtk.TreeViewColumn.get_clickable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_clickable</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the user can click
the column header.</td></tr></tbody></table><p>The <code class="methodname">get_clickable</code>() method returns the
value of the "clickable" property. If "clickable" is <code class="literal">True</code>
the user can click on the header for the treeview column.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_widget"><a name="method-gtktreeviewcolumn--set-widget"></a><h3>gtk.TreeViewColumn.set_widget</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_widget</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>widget</code></strong> :</span></p></td><td>a child <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a>.</td></tr></tbody></table><p>The <code class="methodname">set_widget</code>() method sets the widget
in the header to be <em class="parameter"><code>widget</code></em>.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_widget"><a name="method-gtktreeviewcolumn--get-widget"></a><h3>gtk.TreeViewColumn.get_widget</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_widget</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the <a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> in the
column header, or <code class="literal">None</code></td></tr></tbody></table><p>The <code class="methodname">get_widget</code>() method returns the
<a class="link" href="class-gtkwidget.html" title="gtk.Widget"><code class="classname">gtk.Widget</code></a> in
the button on the column header. If a custom widget has not been set using
the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-widget" title="gtk.TreeViewColumn.set_widget"><code class="methodname">set_widget</code>()</a> 
method <code class="literal">None</code> is returned.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_alignment"><a name="method-gtktreeviewcolumn--set-alignment"></a><h3>gtk.TreeViewColumn.set_alignment</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_alignment</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>xalign</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>xalign</code></strong> :</span></p></td><td>the horizontal alignment, in the range 0.0 to
1.0 inclusive.</td></tr></tbody></table><p>The <code class="methodname">set_alignment</code>() method sets the
"alignment" property to the value of <em class="parameter"><code>xalign</code></em>.
<em class="parameter"><code>xalign</code></em> specifies the alignment of the title or custom
widget inside the column header. The alignment value specifies the fraction
of free space to the left of the widget.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_alignment"><a name="method-gtktreeviewcolumn--get-alignment"></a><h3>gtk.TreeViewColumn.get_alignment</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_alignment</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the current alignment of the treeview
column.</td></tr></tbody></table><p>The <code class="methodname">get_alignment</code>() method returns the
value of the "alignment" property that contains the current horizontal
alignment of the treeview column. See the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-alignment" title="gtk.TreeViewColumn.set_alignment"><code class="methodname">set_alignment</code>()</a> 
method for more detail.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_reorderable"><a name="method-gtktreeviewcolumn--set-reorderable"></a><h3>gtk.TreeViewColumn.set_reorderable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_reorderable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>reorderable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>reorderable</code></strong> :</span></p></td><td>if <code class="literal">True</code>, the column can be
reordered.</td></tr></tbody></table><p>The <code class="methodname">set_reorderable</code>() method sets the
"reorderable" property to the value of <em class="parameter"><code>reorderable</code></em>.
If <em class="parameter"><code>reorderable</code></em> is <code class="literal">True</code>, the column
can be reordered by the end user dragging the header.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_reorderable"><a name="method-gtktreeviewcolumn--get-reorderable"></a><h3>gtk.TreeViewColumn.get_reorderable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_reorderable</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the treeview column
can be reordered by the user.</td></tr></tbody></table><p>The <code class="methodname">get_reorderable</code>() method returns
the value of the "reorderable" property. If "reorderable" is
<code class="literal">True</code> the treeview column can be reordered by the
user.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_sort_column_id"><a name="method-gtktreeviewcolumn--set-sort-column-id"></a><h3>gtk.TreeViewColumn.set_sort_column_id</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_sort_column_id</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sort_column_id</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>sort_column_id</code></strong> :</span></p></td><td>the logical column ID of the model to sort
on or -1.</td></tr></tbody></table><p>The <code class="methodname">set_sort_column_id</code>() method is a
convenience method that sets the column's sort column ID to the value
specified by <em class="parameter"><code>sort_column_id</code></em> (an integer value). The
treeview model sorts on the <em class="parameter"><code>sort_column_id</code></em> when this
treeview column is selected for sorting. This method also makes the treeview
column header clickable. If <em class="parameter"><code>sort_column_id</code></em> is -1
sorting using the treeview column is disabled.</p><p>This method sets up a number of callbacks that manage the
sorting of the tree model when the column header is clicked. These callbacks
provide toggling of the sort order, enabling the sort indicator and so
on.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_sort_column_id"><a name="method-gtktreeviewcolumn--get-sort-column-id"></a><h3>gtk.TreeViewColumn.get_sort_column_id</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_sort_column_id</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the current column ID for this column, or -1 if
this column can't be used for sorting.</td></tr></tbody></table><p>The <code class="methodname">get_sort_column_id</code>() method returns
the logical column ID that the model sorts on when this column is selected
for sorting. See the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-column-id" title="gtk.TreeViewColumn.set_sort_column_id"><code class="methodname">set_sort_column_id</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_sort_indicator"><a name="method-gtktreeviewcolumn--set-sort-indicator"></a><h3>gtk.TreeViewColumn.set_sort_indicator</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_sort_indicator</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>setting</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>setting</code></strong> :</span></p></td><td>if <code class="literal">True</code> display an indicator
that the column is sorted</td></tr></tbody></table><p>The <code class="methodname">set_sort_indicator</code>() method sets
the "sort-indicator" property to the value of
<em class="parameter"><code>setting</code></em>. If <em class="parameter"><code>setting</code></em> is
<code class="literal">True</code> an arrow is displayed in the header button when the
column is sorted. Call the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-order" title="gtk.TreeViewColumn.set_sort_order"><code class="methodname">set_sort_order</code>()</a>
to change the direction of the arrow.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>If the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-column-id" title="gtk.TreeViewColumn.set_sort_column_id"><code class="methodname">set_sort_column_id</code>()</a>
convenience method has been called the visibility of the sort indicator will
be managed automatically. See the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-order" title="gtk.TreeViewColumn.set_sort_order"><code class="methodname">set_sort_order</code>()</a>
method for more information.</p></div></div><div class="refsect2" title="gtk.TreeViewColumn.get_sort_indicator"><a name="method-gtktreeviewcolumn--get-sort-indicator"></a><h3>gtk.TreeViewColumn.get_sort_indicator</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_sort_indicator</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the sort indicator
arrow is displayed</td></tr></tbody></table><p>The <code class="methodname">get_sort_indicator</code>() method returns
the value of the "sort-indicator" property. If "sort-indicator" is
<code class="literal">True</code> an arrow is displayed in the header button when the
column is sorted.</p></div><div class="refsect2" title="gtk.TreeViewColumn.set_sort_order"><a name="method-gtktreeviewcolumn--set-sort-order"></a><h3>gtk.TreeViewColumn.set_sort_order</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_sort_order</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>order</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>order</code></strong> :</span></p></td><td>the sort order that the sort indicator should
indicate</td></tr></tbody></table><p>The <code class="methodname">set_sort_order</code>() method set the "sort-order" property to the
value of order. The value of order must be either:
<code class="literal">gtk.SORT_ASCENDING</code> or
<code class="literal">gtk.SORT_DESCENDING</code>. This method changes the appearance
of the sort indicator.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method <span class="emphasis"><em>does not</em></span> actually sort the
model. Use the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-column-id" title="gtk.TreeViewColumn.set_sort_column_id"><code class="methodname">set_sort_column_id</code>()</a> 
method if you want automatic sorting support.  This method is primarily for
custom sorting behavior, and should be used in conjunction with the <a class="link" href="class-gtktreesortable.html#method-gtktreesortable--set-sort-column-id" title="gtk.TreeSortable.set_sort_column_id"><code class="methodname">set_sort_column_id</code>()</a> 
method to do that. For custom models, the mechanism will vary.</p></div><p>The sort indicator changes direction to indicate normal sort or
reverse sort. Of course, you must have the sort indicator enabled to see
anything when calling this method; see the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-indicator" title="gtk.TreeViewColumn.set_sort_indicator"><code class="methodname">set_sort_indicator</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_sort_order"><a name="method-gtktreeviewcolumn--get-sort-order"></a><h3>gtk.TreeViewColumn.get_sort_order</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_sort_order</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the sort order the sort indicator is
indicating</td></tr></tbody></table><p>The <code class="methodname">get_sort_order</code>() method returns the
value of the "sort-order" property that indicates in which direction the
treeview column is sorted. See the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--set-sort-order" title="gtk.TreeViewColumn.set_sort_order"><code class="methodname">set_sort_order</code>()</a> 
method for more detail.</p></div><div class="refsect2" title="gtk.TreeViewColumn.cell_set_cell_data"><a name="method-gtktreeviewcolumn--cell-set-cell-data"></a><h3>gtk.TreeViewColumn.cell_set_cell_data</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">cell_set_cell_data</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tree_model</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>is_expander</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>is_expanded</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>tree_model</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> to
get the cell renderer's attributes from.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>the <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a> to
get the cell renderer's attributes from.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>is_expander</code></strong> :</span></p></td><td>if <code class="literal">True</code>, the row has
children</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>is_expanded</code></strong> :</span></p></td><td>if <code class="literal">True</code>, the row has visible
children</td></tr></tbody></table><p>The <code class="methodname">cell_set_cell_data</code>() method sets
the cell renderer attributes based on the specified
<em class="parameter"><code>tree_model</code></em> and <em class="parameter"><code>iter</code></em>. That is,
for every attribute mapping in the treeview column, it will get a value from
the set column in the <em class="parameter"><code>iter</code></em>, and use that value to set
the attribute on the cell renderer. If <em class="parameter"><code>is_expander</code></em> is
<code class="literal">True</code> the tree model row has children that may or may not
be displayed. If <em class="parameter"><code>is_expanded</code></em> is
<code class="literal">True</code> the tree model row has children that are
displayed.</p></div><div class="refsect2" title="gtk.TreeViewColumn.cell_get_size"><a name="method-gtktreeviewcolumn--cell-get-size"></a><h3>gtk.TreeViewColumn.cell_get_size</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">cell_get_size</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>cell_area</code></em></span><span class="initializer">=(0,0,0,0)</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>cell_area</code></em> :</span></p></td><td>an optional 4-tuple or 4-list or <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
          specifying the area allocated for a cell in the
          column</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a tuple containing five values: a <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
holding the area a cell in the column will be allocated; the x offset of the
cell; the y offset of the cell; the cell width; and, the cell
height</td></tr></tbody></table><p>The <code class="methodname">cell_get_size</code>() method returns a
tuple containing:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">a <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
holding the area a cell in the treeview column will be allocated.</li><li class="listitem">the x offset of the cell relative to
<em class="parameter"><code>cell_area</code></em>.</li><li class="listitem">the y offset of the cell relative to
<em class="parameter"><code>cell_area</code></em>.</li><li class="listitem">the width of the cell.</li><li class="listitem">the height of the cell.</li></ul></div><p>This method is used primarily by the <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>.</p></div><div class="refsect2" title="gtk.TreeViewColumn.cell_is_visible"><a name="method-gtktreeviewcolumn--cell-is-visible"></a><h3>gtk.TreeViewColumn.cell_is_visible</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">cell_is_visible</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code>, if any of the cells
packed into the treeview column are currently visible</td></tr></tbody></table><p>The <code class="methodname">cell_is_visible</code>() method returns
<code class="literal">True</code> if any of the cells packed into the treeview column
are visible. For this to be meaningful, you must first initialize the cells
with the <a class="link" href="class-gtktreeviewcolumn.html#method-gtktreeviewcolumn--cell-set-cell-data" title="gtk.TreeViewColumn.cell_set_cell_data"><code class="methodname">cell_set_cell_data</code>()</a> 
method.</p></div><div class="refsect2" title="gtk.TreeViewColumn.focus_cell"><a name="method-gtktreeviewcolumn--focus-cell"></a><h3>gtk.TreeViewColumn.focus_cell</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">focus_cell</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cell</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <code class="methodname">focus_cell</code>() method sets the
current keyboard focus to be at <em class="parameter"><code>cell</code></em>, if the column
contains 2 or more editable and activatable cells.</p></div><div class="refsect2" title="gtk.TreeViewColumn.cell_get_position"><a name="method-gtktreeviewcolumn--cell-get-position"></a><h3>gtk.TreeViewColumn.cell_get_position</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">cell_get_position</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell_renderer</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>cell_renderer</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the horizontal position
	  and size of a cell or <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">cell_get_position</code>() method returns
the horizontal position and size of the cell specified by
<em class="parameter"><code>cell_renderer</code></em>. If the cell is not found in the
column, <code class="literal">None</code> is returned.</p></div><div class="refsect2" title="gtk.TreeViewColumn.queue_resize"><a name="method-gtktreeviewcolumn--queue-resize"></a><h3>gtk.TreeViewColumn.queue_resize</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">queue_resize</span>()</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">queue_resize</code>() method flags the
 column, and the cell renderers added to this column, to have their sizes
 renegotiated.</p></div><div class="refsect2" title="gtk.TreeViewColumn.get_tree_view"><a name="method-gtktreeviewcolumn--get-tree-view"></a><h3>gtk.TreeViewColumn.get_tree_view</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_tree_view</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The tree view wherein column has been inserted if any,
      <code class="literal">None</code>otherwise.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>The <code class="methodname">get_tree_view</code>() method returns
      the <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
      wherein tree_column has been inserted. If column is currently not
      inserted in any tree view, <code class="literal">None</code> is returned.</p></div></div><div class="refsect1" title="Signals"><a name="id4066065"></a><h2>Signals</h2><div class="refsect2" title='The "clicked" gtk.TreeViewColumn Signal'><a name="signal-gtktreeviewcolumn--clicked"></a><h3>The "clicked" gtk.TreeViewColumn Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>treeviewcolumn</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>treeviewcolumn</code></em> :</span></p></td><td>the treeviewcolumn that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "clicked" signal is emitted when the user clicks on the
<em class="parameter"><code>treeviewcolumn</code></em> header button.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtktreeview.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gtkuimanager.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.TreeView </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.UIManager</td></tr></table></div></body></html>
python-gtk2-doc 2.24.0-4ubuntu1 / usr / share / gtk-doc / html / pygtk / class-gtktreeviewcolumn.html
