File: pygtk-gtktreeview.xml

package info (click to toggle)
pygtk 2.24.0-3
links: PTS, VCS
area: main
in suites: wheezy
size: 26,636 kB
sloc: xml: 182,079; sh: 10,297; python: 10,161; ansic: 2,861; makefile: 1,351
file content (4804 lines) | stat: -rw-r--r-- 194,567 bytes
parent folder | download | duplicates (5)
<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-gtktreeview">
  <refnamediv>
    <refname>gtk.TreeView</refname>
    <refpurpose>a widget for displaying both trees and lists.</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <classsynopsis language="python">
      <ooclass><classname>gtk.TreeView</classname></ooclass>
      <ooclass><classname><link
linkend="class-gtkcontainer">gtk.Container</link></classname></ooclass>
      <constructorsynopsis language="python">
	<methodname><link
linkend="constructor-gtktreeview">gtk.TreeView</link></methodname>
	<methodparam><parameter
		       role="keyword">model</parameter><initializer>None</initializer></methodparam>
      </constructorsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-model">get_model</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-model">set_model</link></methodname>
	<methodparam><parameter
		       role="keyword">model</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-selection">get_selection</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-hadjustment">get_hadjustment</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-hadjustment">set_hadjustment</link></methodname>
	<methodparam><parameter
		       role="keyword">adjustment</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-vadjustment">get_vadjustment</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-vadjustment">set_vadjustment</link></methodname>
	<methodparam><parameter
		       role="keyword">adjustment</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-headers-visible">get_headers_visible</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-headers-visible">set_headers_visible</link></methodname>
	<methodparam><parameter
		       role="keyword">headers_visible</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--columns-autosize">columns_autosize</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-headers-clickable">set_headers_clickable</link></methodname>
	<methodparam><parameter
		       role="keyword">active</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-rules-hint">set_rules_hint</link></methodname>
	<methodparam><parameter
		       role="keyword">setting</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-rules-hint">get_rules_hint</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--append-column">append_column</link></methodname>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--remove-column">remove_column</link></methodname>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--insert-column">insert_column</link></methodname>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">position</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--insert-column-with-attributes">insert_column_with_attributes</link></methodname>
	<methodparam><parameter>position</parameter></methodparam>
	<methodparam><parameter>title</parameter></methodparam>
	<methodparam><parameter>cell</parameter></methodparam>
	<methodparam><parameter>...</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--insert-column-with-data-func">insert_column_with_data_func</link></methodname>
	<methodparam><parameter>position</parameter></methodparam>
	<methodparam><parameter>title</parameter></methodparam>
	<methodparam><parameter>cell</parameter></methodparam>
	<methodparam><parameter>func</parameter></methodparam>
	<methodparam><parameter>data</parameter>
	  <initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-column">get_column</link></methodname>
	<methodparam><parameter role="keyword">n</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-columns">get_columns</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--move-column-after">move_column_after</link></methodname>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">base_column</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-expander-column">set_expander_column</link></methodname>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-expander-column">get_expander_column</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
<methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-column-drag-function">set_column_drag_function</link></methodname>
        <methodparam><parameter role="keyword">func</parameter></methodparam>
        <methodparam><parameter role="keyword">user_data</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--scroll-to-point">scroll_to_point</link></methodname>
	<methodparam><parameter
		       role="keyword">tree_x</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tree_y</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--scroll-to-cell">scroll_to_cell</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">use_align</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">row_align</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">col_align</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--row-activated">row_activated</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--expand-all">expand_all</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--collapse-all">collapse_all</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktreeview--expand-to-path">expand_to_path</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--expand-row">expand_row</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">open_all</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--collapse-row">collapse_row</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktreeview--map-expanded-rows">map_expanded_rows</link></methodname>
	<methodparam><parameter role="keyword">func</parameter></methodparam>
	<methodparam><parameter role="keyword">data</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--row-expanded">row_expanded</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-reorderable">set_reorderable</link></methodname>
	<methodparam><parameter
		       role="keyword">reorderable</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-reorderable">get_reorderable</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-cursor">set_cursor</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">focus_column</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">start_editing</parameter><initializer>False</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktreeview--set-cursor-on-cell">set_cursor_on_cell</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">focus_column</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">focus_cell</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">start_editing</parameter><initializer>False</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-cursor">get_cursor</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-bin-window">get_bin_window</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-path-at-pos">get_path_at_pos</link></methodname>
	<methodparam><parameter role="keyword">x</parameter></methodparam>
	<methodparam><parameter role="keyword">y</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-cell-area">get_cell_area</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-background-area">get_background_area</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-visible-rect">get_visible_rect</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--widget-to-tree-coords">widget_to_tree_coords</link></methodname>
	<methodparam><parameter>wx</parameter></methodparam>
	<methodparam><parameter>wy</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--tree-to-widget-coords">tree_to_widget_coords</link></methodname>
	<methodparam><parameter>tx</parameter></methodparam>
	<methodparam><parameter>ty</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--enable-model-drag-source">enable_model_drag_source</link></methodname>
	<methodparam><parameter
		       role="keyword">start_button_mask</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">targets</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">actions</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--enable-model-drag-dest">enable_model_drag_dest</link></methodname>
	<methodparam><parameter
		       role="keyword">targets</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">actions</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--unset-rows-drag-source">unset_rows_drag_source</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--unset-rows-drag-dest">unset_rows_drag_dest</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-drag-dest-row">set_drag_dest_row</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
	<methodparam><parameter role="keyword">pos</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-drag-dest-row">get_drag_dest_row</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-dest-row-at-pos">get_dest_row_at_pos</link></methodname>
	<methodparam><parameter role="keyword">x</parameter></methodparam>
	<methodparam><parameter role="keyword">y</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--create-row-drag-icon">create_row_drag_icon</link></methodname>
	<methodparam><parameter
		       role="keyword">path</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-enable-search">set_enable_search</link></methodname>
	<methodparam><parameter
		       role="keyword">enable_search</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-enable-search">get_enable_search</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-search-column">get_search_column</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-search-column">set_search_column</link></methodname>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
      </methodsynopsis>

<!-- NOT IMPLEMENTED
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview- -get-search-equal-func">get_search_equal_func</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
END NOT IMPLEMENTED -->

      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-search-equal-func">set_search_equal_func</link></methodname>
        <methodparam><parameter role="keyword">func</parameter><initializer>None</initializer></methodparam>
        <methodparam><parameter role="keyword">user_data</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>

<!-- NOT IMPLEMENTED
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview- -set-destroy-count-func">set_destroy_count_func</link></methodname>
        <methodparam><parameter role="keyword">func</parameter></methodparam>
        <methodparam><parameter role="keyword">data</parameter></methodparam>
        <methodparam><parameter role="keyword">destroy</parameter></methodparam>
      </methodsynopsis>
END NOT IMPLEMENTED -->

      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-fixed-height-mode">get_fixed_height_mode</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-fixed-height-mode">set_fixed_height_mode</link></methodname>
	<methodparam><parameter
		       role="keyword">enable</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-hover-selection">get_hover_selection</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-hover-selection">set_hover_selection</link></methodname>
	<methodparam><parameter
		       role="keyword">hover</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--get-hover-expand">get_hover_expand</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktreeview--set-hover-expand">set_hover_expand</link></methodname>
	<methodparam><parameter
		       role="keyword">expand</parameter></methodparam>
      </methodsynopsis>

<!-- NOT IMPLEMENTED
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview- -get-row-separator-func">get_row_separator_func</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
END NOT IMPLEMENTED -->

      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-row-separator-func">set_row_separator_func</link></methodname>
        <methodparam><parameter role="keyword">func</parameter><initializer>None</initializer></methodparam>
        <methodparam><parameter role="keyword">user_data</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--get-visible-range">get_visible_range</link></methodname>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--get-headers-clickable">get_headers_clickable</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--get-search-entry">get_search_entry</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-search-entry">set_search_entry</link></methodname>
        <methodparam><parameter role="keyword">entry</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-search-position-func">set_search_position_func</link></methodname>
        <methodparam><parameter role="keyword">func</parameter></methodparam>
        <methodparam><parameter role="keyword">data</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-rubber-banding">set_rubber_banding</link></methodname>
        <methodparam><parameter role="keyword">enable</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--get-rubber-banding">get_rubber_banding</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--get-grid-lines">get_grid_lines</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-grid-lines">set_grid_lines</link></methodname>
        <methodparam><parameter role="keyword">grid_lines</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--get-enable-tree-lines">get_enable_tree_lines</link></methodname>
        <methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-enable-tree-lines">set_enable_tree_lines</link></methodname>
        <methodparam><parameter role="keyword">enabled</parameter></methodparam>      </methodsynopsis>
      
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--convert-widget-to-bin-window-coords">convert_widget_to_bin_window_coords</link></methodname>
        <methodparam><parameter role="keyword">widget_x</parameter></methodparam>
        <methodparam><parameter role="keyword">widget_y</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--convert-widget-to-tree-coords">convert_widget_to_tree_coords</link></methodname>
        <methodparam><parameter role="keyword">widget_x</parameter></methodparam>
        <methodparam><parameter role="keyword">widget_y</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--convert-tree-to-widget-coords">convert_tree_to_widget_coords</link></methodname>
        <methodparam><parameter role="keyword">tree_x</parameter></methodparam>
        <methodparam><parameter role="keyword">tree_y</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--convert-tree-to-bin-window-coords">convert_tree_to_bin_window_coords</link></methodname>
        <methodparam><parameter role="keyword">tree_x</parameter></methodparam>
        <methodparam><parameter role="keyword">tree_y</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--convert-bin-window-to-widget-coords">convert_bin_window_to_widget_coords</link></methodname>
        <methodparam><parameter role="keyword">window_x</parameter></methodparam>
        <methodparam><parameter role="keyword">window_y</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--convert-bin-window-to-tree-coords">convert_bin_window_to_tree_coords</link></methodname>
        <methodparam><parameter role="keyword">window_x</parameter></methodparam>
        <methodparam><parameter role="keyword">window_y</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--get-level-indentation">get_level_indentation</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-level-indentation">set_level_indentation</link></methodname>
        <methodparam><parameter role="keyword">indentation</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--get-show-expanders">get_show_expanders</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-show-expanders">set_show_expanders</link></methodname>
        <methodparam><parameter role="keyword">enabled</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--get-tooltip-column">get_tooltip_column</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-tooltip-column">set_tooltip_column</link></methodname>
        <methodparam><parameter role="keyword">column</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--is-rubber-banding-active">is_rubber_banding_active</link></methodname>
        <methodparam></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-tooltip-cell">set_tooltip_cell</link></methodname>
        <methodparam><parameter role="keyword">tooltip</parameter></methodparam>
        <methodparam><parameter role="keyword">path</parameter></methodparam>
        <methodparam><parameter role="keyword">column</parameter></methodparam>
        <methodparam><parameter role="keyword">cell</parameter></methodparam>
    </methodsynopsis>
    <methodsynopsis language="python">
        <methodname><link linkend="method-gtktreeview--set-tooltip-row">set_tooltip_row</link></methodname>
        <methodparam><parameter role="keyword">tooltip</parameter></methodparam>
        <methodparam><parameter role="keyword">path</parameter></methodparam>
    </methodsynopsis>

    </classsynopsis>

  </refsect1>

  <refsect1>
    <title>Ancestry</title>

<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link>
  +-- <link linkend="class-gtkobject">gtk.Object</link>
    +-- <link linkend="class-gtkwidget">gtk.Widget</link>
      +-- <link linkend="class-gtkcontainer">gtk.Container</link>
        +-- <link linkend="class-gtktreeview">gtk.TreeView</link>
</synopsis>

  </refsect1>
  
  <refsect1>
		<title>Implemented Interfaces</title>
		<para>
			<link linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>
			implements 
			<link linkend="class-gtkbuildable"><classname>gtk.Buildable</classname></link>
		</para>
	</refsect1>

  <refsect1 id="properties-gtktreeview">
    <title>gtk.TreeView Properties</title>

    <para><link linkend="properties-gtkobject">gtk.Object Properties</link></para>
    <para><link linkend="properties-gtkwidget">gtk.Widget Properties</link></para>
    <para><link linkend="properties-gtkcontainer">gtk.Container Properties</link></para>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

            <row valign="top">
              <entry>"enable-grid-lines"</entry>
              <entry>Read-Write</entry>
              <entry>If <literal>True</literal> grid lines should be drawn
              in the tree view</entry>
            </row>

	    <row valign="top">
	      <entry>"enable-search"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, the user can search through
columns interactively. Default value: <literal>True</literal></entry>
	    </row>

            <row valign="top">
              <entry>"enable-tree-lines"</entry>
              <entry>Read-Write</entry>
              <entry>If <literal>True</literal> tree lines should be drawn
              in the tree view</entry>
            </row>

	    <row valign="top">
	      <entry>"expander-column"</entry>
	      <entry>Read-Write</entry>
	      <entry>The column for the expander</entry>
	    </row>

	    <row valign="top">
	      <entry>"fixed-height-mode"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, assume all rows have the
same height thereby speeding up display. Default value:
<literal>False</literal>. Available in GTK+ 2.4 and above.</entry>
	    </row>

	    <row valign="top">
	      <entry>"hadjustment"</entry>
	      <entry>Read-Write</entry>
	      <entry>The horizontal Adjustment for the widget</entry>
	    </row>

	    <row valign="top">
	      <entry>"headers-clickable"</entry>
	      <entry>Write</entry>
	      <entry>If <literal>True</literal>, the column headers respond
to click events. Default value: <literal>False</literal></entry>
	    </row>

	    <row valign="top">
	      <entry>"headers-visible"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, show the column header
buttons. Default value: <literal>True</literal></entry>
	    </row>

	    <row valign="top">
	      <entry>"hover-expand"</entry>
	      <entry>Read-Write</entry>

	      <entry>If <literal>True</literal>, rows expand or collapse if
the pointer moves over them. This mode is primarily intended for treeviews
in popups, e.g. in <link
linkend="class-gtkcombobox"><classname>gtk.ComboBox</classname></link> or
<link
linkend="class-gtkentrycompletion"><classname>gtk.EntryCompletion</classname></link>. Default
value: <literal>False</literal>. Available in GTK+ 2.6 and above.</entry>
	    </row>

	    <row valign="top">
	      <entry>"hover-selection"</entry>
	      <entry>Read-Write</entry>

	      <entry>If <literal>True</literal>, the selected row follows
the pointer. Currently, this works only for the selection modes
<literal>gtk.SELECTION_SINGLE</literal> and
<literal>gtk.SELECTION_BROWSE</literal>. This mode is primarily intended for
treeviews in popups, e.g. in <link
linkend="class-gtkcombobox"><classname>gtk.ComboBox</classname></link> or
<link
linkend="class-gtkentrycompletion"><classname>gtk.EntryCompletion</classname></link>. Default
value: <literal>False</literal>. Available in GTK+ 2.6 and above.</entry>
	    </row>

            <row valign="top">
              <entry>"level-indentation"</entry>
              <entry>Read-Write</entry>
              <entry>Extra indentation for each level</entry>
            </row>

	    <row valign="top">
	      <entry>"model"</entry>
	      <entry>Read-Write</entry>
	      <entry>The model for the tree view</entry>
	    </row>

	    <row valign="top">
	      <entry>"reorderable"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, the view is
reorderable. Default value: <literal>False</literal>.</entry>
	    </row>

            <row valign="top">
              <entry>"rubber-banding"</entry>
              <entry>Read-Write</entry>
              <entry>If <literal>True</literal> enable selection of multiple
              items by dragging the mouse pointer</entry>
            </row>

	    <row valign="top">
	      <entry>"rules-hint"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, hint to the theme engine to
draw rows in alternating colors. Default value:
<literal>False</literal>.</entry>
	    </row>

	    <row valign="top">
	      <entry>"search-column"</entry>
	      <entry>Read-Write</entry>
	      <entry>The model column to search when searching through
code. Allowed values: >= -1. Default value: -1</entry>
	    </row>

            <row valign="top">
              <entry>"show-expanders"</entry>
              <entry>Read-Write</entry>
              <entry>View has expanders</entry>
            </row>

	    <row valign="top">
	      <entry>"vadjustment"</entry>
	      <entry>Read-Write</entry>
	      <entry>The vertical Adjustment for the widget</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="style-properties-gtktreeview">
    <title>gtk.TreeView Style Properties</title>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"allow-rules"</entry>
	      <entry>Read</entry>
	      <entry>If <literal>True</literal>, allow drawing of
alternating color rows. Default value: <literal>True</literal></entry>
	    </row>

	    <row valign="top">
	      <entry>"even-row-color"</entry>
	      <entry>Read</entry>
	      <entry>The <link
linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>
to use for even rows. Available in GTK+ 2.2 and above.</entry>
	    </row>

	    <row valign="top">
	      <entry>"expander-size"</entry>
	      <entry>Read</entry>
	      <entry>The size of the expander arrow. Allowed values: >= 0.
Default value: 12</entry>
	    </row>

            <row valign="top">
              <entry>"grid-line-pattern"</entry>
              <entry>Read</entry>
              <entry>Dash pattern used to draw the tree view grid lines</entry>
            </row>

            <row valign="top">
              <entry>"grid-line-width"</entry>
              <entry>Read</entry>
              <entry>Width, in pixels, of the tree view grid lines</entry>
            </row>

	    <row valign="top">
	      <entry>"horizontal-separator"</entry>
	      <entry>Read</entry>
	      <entry>The horizontal space between cells. Must be an even
number. Allowed values: >= 0. Default value: 2</entry>
	    </row>

	    <row valign="top">
	      <entry>"indent-expanders"</entry>
	      <entry>Read</entry>
	      <entry>If <literal>True</literal>, the expanders are
indented.</entry>
	    </row>

	    <row valign="top">
	      <entry>"odd-row-color"</entry>
	      <entry>Read</entry>
	      <entry>The <link
linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>
to use for odd rows. Available in GTK+ 2.2 and above.</entry>
	    </row>

            <row valign="top">
              <entry>"row-ending-details"</entry>
              <entry>Read</entry>
              <entry>Enable extended row background theming</entry>
            </row>

            <row valign="top">
              <entry>"tree-line-pattern"</entry>
              <entry>Read</entry>
              <entry>Dash pattern used to draw the tree view lines</entry>
            </row>

            <row valign="top">
              <entry>"tree-line-width"</entry>
              <entry>Read</entry>
              <entry>Width, in pixels, of the tree view lines</entry>
            </row>

	    <row valign="top">
	      <entry>"vertical-separator"</entry>
	      <entry>Read</entry>
	      <entry>The vertical space between cells. Must be an even
number. Allowed values: >= 0. Default value: 2</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="signal-prototypes-gtktreeview">
    <title>gtk.TreeView Signal Prototypes</title>

    <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkobject">gtk.Object Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkwidget">gtk.Widget Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkcontainer">gtk.Container Signal Prototypes</link></para>

    <variablelist>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--columns-changed">columns-changed</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--cursor-changed">cursor-changed</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--expand-collapse-cursor-row">expand-collapse-cursor-row</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>logical</parameter></methodparam>
            <methodparam><parameter>expand</parameter></methodparam>
            <methodparam><parameter>open_all</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--move-cursor">move-cursor</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>step</parameter></methodparam>
            <methodparam><parameter>count</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--row-activated">row-activated</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>path</parameter></methodparam>
            <methodparam><parameter>view_column</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--row-collapsed">row-collapsed</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>iter</parameter></methodparam>
            <methodparam><parameter>path</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--row-expanded">row-expanded</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>iter</parameter></methodparam>
            <methodparam><parameter>path</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--select-all">select-all</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--select-cursor-parent">select-cursor-parent</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--select-cursor-row">select-cursor-row</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
             <methodparam><parameter>start_editing</parameter></methodparam>
           <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--set-scroll-adjustments">set-scroll-adjustments</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>hadjustment</parameter></methodparam>
            <methodparam><parameter>vadjustment</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--start-interactive-search">start-interactive-search</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--test-collapse-row">test-collapse-row</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>iter</parameter></methodparam>
            <methodparam><parameter>path</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--test-expand-row">test-expand-row</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>iter</parameter></methodparam>
            <methodparam><parameter>path</parameter></methodparam>
             <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--toggle-cursor-row">toggle-cursor-row</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
           <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link linkend="signal-gtktreeview--unselect-all">unselect-all</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>treeview</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
    </variablelist>

  </refsect1>

  <refsect1>
    <title>Description</title>

    <para>A <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>
widget is used to display the contents of any model implementing the <link
linkend="class-gtktreemodel"><classname>gtk.TreeModel</classname></link>
interface. The tree models provided standard with <literal>GTK+</literal>
and <literal>PyGTK</literal> are:</para>

    <itemizedlist>
      <listitem>
	<simpara><link
linkend="class-gtkliststore"><classname>gtk.ListStore</classname></link></simpara>
      </listitem>
      <listitem>
	<simpara><link
linkend="class-gtktreestore"><classname>gtk.TreeStore</classname></link></simpara>
      </listitem>
      <listitem>
	<simpara><link
linkend="class-gtktreemodelsort"><classname>gtk.TreeModelSort</classname></link></simpara>
      </listitem>
    </itemizedlist>

    <para>In addition, <literal>PyGTK</literal> provides <link
linkend="class-pygtkgenerictreemodel"><classname>gtk.GenericTreeModel</classname></link> 
that allows you to create your own tree model entirely in Python.</para>

    <para>The <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link> uses
columns and cell renderers to actually display the model information.
<literal>GTK+</literal> and <literal>PyGTK</literal> provides the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
to manage the display of a column and the following cell renderers:</para>

    <itemizedlist>
      <listitem>
	<simpara><link
linkend="class-gtkcellrendererpixbuf"><classname>gtk.CellRendererPixbuf</classname></link></simpara>
      </listitem>
      <listitem>
	<simpara><link
linkend="class-gtkcellrenderertext"><classname>gtk.CellRendererText</classname></link></simpara>
      </listitem>
      <listitem>
	<simpara><link
linkend="class-gtkcellrenderertoggle"><classname>gtk.CellRendererToggle</classname></link></simpara>
      </listitem>
    </itemizedlist>

    <para>In addition, <literal>PyGTK</literal> provides the <link
linkend="class-pygtkgenericcellrenderer"><classname>gtk.GenericCellRenderer</classname></link> 
that allows you to create your own cell renderers entirely in Python.</para>

  </refsect1>

  <refsect1 id="constructor-gtktreeview">
    <title>Constructor</title>

    <programlisting><constructorsynopsis language="python">
	<methodname>gtk.TreeView</methodname>
	<methodparam><parameter role="keyword">model</parameter>
	  <initializer>None</initializer></methodparam>
      </constructorsynopsis></programlisting>
    <variablelist>
      <varlistentry>
	<term><parameter role="keyword">model</parameter>&nbsp;:</term>
	<listitem><simpara>the tree model to display</simpara></listitem>
      </varlistentry>
      <varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	<listitem><simpara>A new <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>
widget.</simpara></listitem>
      </varlistentry>
    </variablelist>

    <para>Creates a new <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>
widget displaying the model specified by <parameter>model</parameter>.</para>

  </refsect1>

  <refsect1>
    <title>Methods</title>

    <refsect2 id="method-gtktreeview--get-model">
      <title>gtk.TreeView.get_model</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_model</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the current <link
linkend="class-gtktreemodel"><classname>gtk.TreeModel</classname></link>, or
<literal>None</literal> if none is currently being
used.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_model</methodname>() method returns the
value of the "model" property containing the model the <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link> is
displaying or <literal>None</literal> there is no the model.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-model">
      <title>gtk.TreeView.set_model</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_model</methodname>
	  <methodparam><parameter role="keyword">model</parameter>
	    <initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">model</parameter>&nbsp;:</term>
	  <listitem><simpara>the new tree model to use with the
treeview</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_model</methodname>() method sets the "model"
property for the treeview to the value of <parameter>model</parameter>. If
the treeview already has a model set, this method will remove it before
setting the new model. If <parameter>model</parameter> is
<literal>None</literal>, it will unset the old model.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-selection">
      <title>gtk.TreeView.get_selection</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_selection</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>A <link
linkend="class-gtktreeselection"><classname>gtk.TreeSelection</classname></link> 
object.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_selection</methodname>() method returns the
current <link
linkend="class-gtktreeselection"><classname>gtk.TreeSelection</classname></link> 
associated with the treeview.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-hadjustment">
      <title>gtk.TreeView.get_hadjustment</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_hadjustment</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
object, or <literal>None</literal> if none is currently being
used.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_hadjustment</methodname>() method returns
the value of the "hadjustment" property that contains the current horizontal
<link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
object or <literal>None</literal> (if no horizontal adjustment is being
used).</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-hadjustment">
      <title>gtk.TreeView.set_hadjustment</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_hadjustment</methodname>
	  <methodparam><parameter
			 role="keyword">adjustment</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">adjustment</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
to set</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_hadjustment</methodname>() method sets the
"hadjustment" property to the value of <parameter>adjustment</parameter>
that must be a <link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
object.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-vadjustment">
      <title>gtk.TreeView.get_vadjustment</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_vadjustment</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
object, or <literal>None</literal> if none is currently being
used.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_vadjustment</methodname>() method returns
the value of the "vadjustment" property that contains the horizontal <link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
or None if there is no vertical adjustment.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-vadjustment">
      <title>gtk.TreeView.set_vadjustment</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_vadjustment</methodname>
	  <methodparam><parameter
			 role="keyword">adjustment</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">adjustment</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
to set</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_vadjustment</methodname>() method sets the
"vadjustment" property to the value of <parameter>adjustment</parameter>.
The new <link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link>
replaces the current vertical adjustment.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-headers-visible">
      <title>gtk.TreeView.get_headers_visible</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_headers_visible</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the headers are
visible.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_headers_visible</methodname>() method
returns the value of the "headers-visible" property. If "headers-visible" is
<literal>True</literal> the headers on the treeview are visible.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-headers-visible">
      <title>gtk.TreeView.set_headers_visible</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_headers_visible</methodname>
	  <methodparam><parameter
			 role="keyword">headers_visible</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">headers_visible</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> the headers are
visible</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_headers_visible</methodname>() method sets
the "headers-visible" property to the value of
<parameter>headers_visible</parameter>. If
<parameter>headers_visible</parameter> is <literal>True</literal> the
headers will be displayed.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--columns-autosize">
      <title>gtk.TreeView.columns_autosize</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>columns_autosize</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <para>The <methodname>columns_autosize</methodname>() method resizes
all columns to their optimal width. Only works after the treeview has been
realized.</para>

    </refsect2>

  <refsect2 id="method-gtktreeview--set-headers-clickable">
      <title>gtk.TreeView.set_headers_clickable</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_headers_clickable</methodname>
	  <methodparam><parameter
			 role="keyword">active</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">active</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> the headers are
clickable</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_headers_clickable</methodname>() method sets
the "headers-clickable" property to the value of
<parameter>active</parameter>. If <parameter>active</parameter> is
<literal>True</literal> the column title buttons can be clicked.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-rules-hint">
      <title>gtk.TreeView.set_rules_hint</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_rules_hint</methodname>
	  <methodparam><parameter
			 role="keyword">setting</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">setting</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> the tree requires
reading across rows</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_rules_hint</methodname>() method sets the
"rules-hint" property to the value of <parameter>setting</parameter>. If
<parameter>setting</parameter> is <literal>True</literal> it indicates that
the user interface for your application requires users to read across tree
rows and associate cells with one another. By default, the tree will be
rendered with alternating row colors. Do <emphasis>not</emphasis> use it
just because you prefer the appearance of the ruled tree; that's a question
for the theme. Some themes will draw tree rows in alternating colors even
when rules are turned off, and users who prefer that appearance all the time
can choose those themes. You should call this method only as a
<emphasis>semantic</emphasis> hint to the theme engine that your tree makes
alternating colors useful from a functional standpoint (since it has lots of
columns, generally).</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-rules-hint">
      <title>gtk.TreeView.get_rules_hint</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_rules_hint</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if rules are useful for
the user of this tree</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_rules_hint</methodname>() returns the value
of the "rules-hint" property. See the <link
linkend="method-gtktreeview--set-rules-hint"><methodname>set_rules_hint</methodname>()</link> 
method for more information on the use of "rules-hint".</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--append-column">
      <title>gtk.TreeView.append_column</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>append_column</methodname>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
to add.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the number of columns in
<parameter>tree_view</parameter> after appending.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>append_column</methodname>() method appends the
specified <parameter>column</parameter> to the list of columns and returns
the new number of columns in the treeview.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--remove-column">
      <title>gtk.TreeView.remove_column</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>remove_column</methodname>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
to remove.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the number of columns in the treeview after the
column removal.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>remove_column</methodname>() method removes the
specified <parameter>column</parameter> from the treeview.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--insert-column">
      <title>gtk.TreeView.insert_column</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_column</methodname>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">position</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
to be inserted.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>the position to insert
<parameter>column</parameter>.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the number of columns in the treeview after the
insertion.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>insert_column</methodname>() method inserts the
specified <parameter>column</parameter> into the treeview at the location
specified by <parameter>position</parameter>. If
<parameter>position</parameter> is -1, then the column is inserted at the
end.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--insert-column-with-attributes">
      <title>gtk.TreeView.insert_column_with_attributes</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_column_with_attributes</methodname>
	  <methodparam><parameter>position</parameter></methodparam>
	  <methodparam><parameter>title</parameter></methodparam>
	  <methodparam><parameter>cell</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter>position</parameter>&nbsp;:</term>
	  <listitem><simpara>the position to insert the new column
in.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>title</parameter>&nbsp;:</term>
	  <listitem><simpara>the title to set the header
to.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>cell</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkcellrenderer"><classname>gtk.CellRenderer</classname></link>.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>optional keyword-value
arguments</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link>
that was inserted.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>insert_column_with_attributes</methodname>()
method creates a new <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
and inserts it into the treeview at the location specified by
<parameter>position</parameter> with the column title specified by
<parameter>title</parameter> and using the <link
linkend="class-gtkcellrenderer"><classname>gtk.CellRenderer</classname></link> 
specified by <parameter>cell</parameter>. If <parameter>position</parameter>
is -1, then the newly created column is inserted at the end. The column is
initialized with the optional attributes passed as keyword-value pairs (e.g.
text=0, foreground=2). See the <link
linkend="method-gtktreeviewcolumn--add-attribute"><methodname>gtk.TreeViewColumn.add_attribute</methodname>()</link> 
method for more information.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--insert-column-with-data-func">
      <title>gtk.TreeView.insert_column_with_data_func</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_column_with_data_func</methodname>
	  <methodparam><parameter>position</parameter></methodparam>
	  <methodparam><parameter>title</parameter></methodparam>
	  <methodparam><parameter>cell</parameter></methodparam>
	  <methodparam><parameter>func</parameter></methodparam>
	  <methodparam><parameter>data</parameter>
	    <initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter>position</parameter>&nbsp;:</term>
	  <listitem><simpara>the position to insert, -1 for
append</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>title</parameter>&nbsp;:</term>
	  <listitem><simpara>the column title</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>cell</parameter>&nbsp;:</term>
	  <listitem><simpara>a cell renderer for the
column</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>func</parameter>&nbsp;:</term>
	  <listitem><simpara>the function or method to set attributes of the
cell renderer</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>data</parameter>&nbsp;:</term>
	  <listitem><simpara>the data to pass with
<parameter>func</parameter></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the number of columns in the treeview after the
insertion</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>insert_column_with_data_func</methodname>()
method is a convenience function that inserts a new column into the treeview
at the location specified by <parameter>position</parameter> with the
specified <parameter>title</parameter> and the cell renderer specified by
<parameter>cell</parameter> and using the function or method specified by
<parameter>func</parameter> to set cell renderer attributes (normally using
data from the model). The signature of func is:</para>

      <programlisting>
<methodsynopsis language="python">
          <methodname>celldatafunction</methodname>
          <methodparam><parameter>column</parameter></methodparam>
          <methodparam><parameter>cell</parameter></methodparam>
          <methodparam><parameter>model</parameter></methodparam>
          <methodparam><parameter>iter</parameter></methodparam>
          <methodparam><parameter>user_data</parameter></methodparam>
        </methodsynopsis>
<methodsynopsis language="python">
          <methodname>celldatamethod</methodname>
          <methodparam><parameter>self</parameter></methodparam>
          <methodparam><parameter>column</parameter></methodparam>
          <methodparam><parameter>cell</parameter></methodparam>
          <methodparam><parameter>model</parameter></methodparam>
          <methodparam><parameter>iter</parameter></methodparam>
          <methodparam><parameter>user_data</parameter></methodparam>
        </methodsynopsis>
</programlisting>

      <para>where <parameter>column</parameter> is the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
in the treeview, <parameter>cell</parameter> is the <link
linkend="class-gtkcellrenderer"><classname>gtk.CellRenderer</classname></link> 
for <parameter>column</parameter>, <parameter>model</parameter> is the <link
linkend="class-gtktreemodel"><classname>gtk.TreeModel</classname></link> for
the treeview and <parameter>iter</parameter> is the <link
linkend="class-gtktreeiter"><classname>gtk.TreeIter</classname></link>
pointing at the row. See the <link
linkend="method-gtktreeviewcolumn--set-cell-data-func"><methodname>gtk.TreeViewColumn.set_cell_data_func</methodname>()</link> 
and <link
linkend="method-gtktreeviewcolumn--pack-start"><methodname>gtk.TreeViewColumn.pack_start</methodname>()</link> 
methods for more detail.</para>

    </refsect2>

  <refsect2 id="method-gtktreeview--get-column">
      <title>gtk.TreeView.get_column</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_column</methodname>
	  <methodparam><parameter role="keyword">n</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">n</parameter>&nbsp;:</term>
	  <listitem><simpara>the position of the column, counting from
0.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link>, 
or <literal>None</literal> if the position is outside the range of
columns.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_column</methodname>() method returns the
<link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
at the specified <parameter>position</parameter> in the treeview.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-columns">
      <title>gtk.TreeView.get_columns</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_columns</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a list of <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
s</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_columns</methodname>() method returns a list
of all the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
objects currently in the treeview.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--move-column-after">
      <title>gtk.TreeView.move_column_after</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>move_column_after</methodname>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">base_column</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
to be moved.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">base_column</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
<parameter>column</parameter> is to be after, or
<literal>None</literal>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>move_column_after</methodname>() method moves
the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
specified by <parameter>column</parameter> to be after the treeview column
specified by <parameter>base_column</parameter>. If
<parameter>base_column</parameter> is <literal>None</literal>, then
<parameter>column</parameter> is placed in the first position.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-expander-column">
      <title>gtk.TreeView.set_expander_column</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_expander_column</methodname>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>the column to draw the expander arrow at
or<literal>None</literal>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_expander_column</methodname>() method sets
the "expander-column" property to the value of <parameter>column</parameter>
which must be a <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
in the treeview. If <parameter>column</parameter> is
<literal>None</literal>, then the expander arrow is always at the first
visible column.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-expander-column">
      <title>gtk.TreeView.get_expander_column</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_expander_column</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the expander column.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_expander_column</methodname>() method
returns the value of the "expander-column" property that contains the
current expander column i.e. the column that has the expander arrow drawn
next to it.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-column-drag-function">
    <title>gtk.TreeView.set_column_drag_function</title>

<programlisting><methodsynopsis language="python">
    <methodname>set_column_drag_function</methodname>
    <methodparam><parameter role="keyword">func</parameter></methodparam>
    <methodparam><parameter role="keyword">user_data</parameter></methodparam>
  </methodsynopsis></programlisting>
  <variablelist>
    <varlistentry>
      <term><parameter role="keyword">func</parameter>&nbsp;:</term>
      <listitem><simpara>A function to determine which columns are reorderable, or <literal>None</literal>.</simpara></listitem>
    </varlistentry>
    <varlistentry>
      <term><parameter role="keyword">user_data</parameter>&nbsp;:</term>
      <listitem><simpara>User data to be passed to <parameter>func</parameter>, or <literal>None</literal></simpara></listitem>
    </varlistentry>
  </variablelist>

      <note>
        <para>This method is available in PyGTK 2.4 and above.</para>
      </note>

      <para>The <methodname>set_column_drag_function</methodname>() method
sets the user function specified by <parameter>func</parameter> for
determining where a column may be dropped when dragged. The user function is
called on every column pair in turn at the beginning of a column drag to
determine where a drop can take place. The signature of
<parameter>func</parameter> is:</para>

      <programlisting>
  def func(<parameter>tree_view</parameter>, <parameter>column</parameter>, <parameter>prev_column</parameter>, <parameter>next_column</parameter>, <parameter>data</parameter>)
</programlisting>

      <para>where <parameter>tree_view</parameter> is the <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>,
<parameter>column</parameter> is the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link>
being dragged, prev_column and next_column are the two <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link>
objects bracketing the drop spot, and <parameter>data</parameter> is
<parameter>user_data</parameter>. If <parameter>prev_column</parameter> or
<parameter>next_column</parameter> is <literal>None</literal>, then the drop
is at an edge. If <parameter>func</parameter> is <literal>None</literal>,
the user drag function is removed and the <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>
reverts to the default behavior of allowing any reorderable column to be
dropped anywhere.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--scroll-to-point">
      <title>gtk.TreeView.scroll_to_point</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>scroll_to_point</methodname>
	  <methodparam><parameter
			 role="keyword">tree_x</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tree_y</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">tree_x</parameter>&nbsp;:</term>
	  <listitem><simpara>the X coordinate of new top-left pixel of
visible area, or -1</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">tree_y</parameter>&nbsp;:</term>
	  <listitem><simpara>the Y coordinate of new top-left pixel of
visible area, or -1</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>scroll_to_point</methodname>() method scrolls
the treeview so that the top-left corner of the visible area is at the
location specified by <parameter>tree_x</parameter> and
<parameter>tree_y</parameter>, where <parameter>tree_x</parameter> and
<parameter>tree_y</parameter> are specified in tree window coordinates. The
treeview must be realized before this method is called. If it isn't, you
should use the <link
linkend="method-gtktreeview--scroll-to-cell"><methodname>scroll_to_cell</methodname>()</link> 
method instead. If either <parameter>tree_x</parameter> or
<parameter>tree_y</parameter> are -1, there is no scrolling in that
direction.</para>

    </refsect2>

  <refsect2 id="method-gtktreeview--scroll-to-cell">
      <title>gtk.TreeView.scroll_to_cell</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>scroll_to_cell</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	  <methodparam><parameter role="keyword">column</parameter>
	    <initializer>None</initializer></methodparam>
	  <methodparam><parameter role="keyword">use_align</parameter>
	    <initializer>False</initializer></methodparam>
	  <methodparam><parameter role="keyword">row_align</parameter>
	    <initializer>0.0</initializer></methodparam>
	  <methodparam><parameter role="keyword">col_align</parameter>
	    <initializer>0.0</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>the path of the row to move
to</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
to move horizontally to, or <literal>None</literal>.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">use_align</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> use the alignment
arguments</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">row_align</parameter>&nbsp;:</term>
	  <listitem><simpara>the vertical alignment of the row specified by
<parameter>path</parameter>.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">col_align</parameter>&nbsp;:</term>
	  <listitem><simpara>the horizontal alignment of the column
specified by <parameter>column</parameter>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>scroll_to_cell</methodname>() method scrolls the
treeview display to the position specified by <parameter>column</parameter>
and <parameter>path</parameter>. If <parameter>column</parameter> is
<literal>None</literal>, no horizontal scrolling occurs. The alignment
parameters specified by <parameter>row_align</parameter> and
<parameter>col_align</parameter> determines where
<parameter>column</parameter> is placed within the treeview. The values of
<parameter>col_align</parameter> and <parameter>row_align</parameter> range
from 0.0 to 1.0. The alignment values specify the fraction of display space
that is to the left of or above the cell. If
<parameter>use_align</parameter> is <literal>False</literal>, the alignment
arguments are ignored, and the tree does the minimum amount of work to
scroll the cell onto the screen. This means that the cell will be scrolled
to the edge closest to it's current position.  If the cell is currently
visible on the screen, nothing is done. This method only works if the model
is set, and <parameter>path</parameter> is a valid row in the model.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--row-activated">
      <title>gtk.TreeView.row_activated</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>row_activated</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>the tree path of the row of the cell to be
activated.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
of the cell to be activated.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>row_activated</methodname>() method activates
the cell determined by <parameter>path</parameter> and
<parameter>column</parameter>.</para>

    </refsect2>

  <refsect2 id="method-gtktreeview--expand-all">
      <title>gtk.TreeView.expand_all</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>expand_all</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>

      <para>The <methodname>expand_all</methodname>() method recursively
expands all nodes in the treeview.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--collapse-all">
      <title>gtk.TreeView.collapse_all</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>collapse_all</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>

      <para>The <methodname>collapse_all</methodname>() method recursively
collapses all visible, expanded nodes in the treeview.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--expand-to-path">
      <title>gtk.TreeView.expand_to_path</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>expand_to_path</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter>path</parameter>&nbsp;:</term>
	  <listitem><simpara>a path to a row.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.2 and above.</para>
      </note>

      <para>The <methodname>expand_to_row</methodname>() method expands the
row with the tree path specified by <parameter>path</parameter>. This will
also expand all parent rows of <parameter>path</parameter> as
necessary.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--expand-row">
      <title>gtk.TreeView.expand_row</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>expand_row</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">open_all</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>the path to a row</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">open_all</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> recursively expand,
otherwise just expand immediate children</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>expand_row</methodname>() method opens the row
specified by <parameter>path</parameter> so its children are visible. If
<parameter>open_all</parameter> is <literal>True</literal> all rows are
expanded, otherwise only the immediate children of
<parameter>path</parameter> are expanded.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--collapse-row">
      <title>gtk.TreeView.collapse_row</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>collapse_row</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>the path to a row</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>collapse_row</methodname>() method collapses the
row specified by <parameter>path</parameter> (hides its child rows, if they
exist).</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--map-expanded-rows">
      <title>gtk.TreeView.map_expanded_rows</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>map_expanded_rows</methodname>
	  <methodparam><parameter role="keyword">func</parameter></methodparam>
	  <methodparam><parameter role="keyword">data</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">func</parameter>&nbsp;:</term>
	  <listitem><simpara>A function to be called</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">data</parameter>&nbsp;:</term>
	  <listitem><simpara>User data to be passed to the function.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.2 and above.</para>
      </note>

      <para>The <methodname>map_expanded_rows</methodname>() method calls
the function specified by <parameter>func</parameter> on all expanded rows
passing <parameter>data</parameter> as an argument.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--row-expanded">
      <title>gtk.TreeView.row_expanded</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>row_expanded</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>the path to a row to test the expansion
state.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if
<literal>path</literal> is expanded.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>row_expanded</methodname>() method returns
<literal>True</literal> if the node pointed to by
<parameter>path</parameter> is expanded.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-reorderable">
      <title>gtk.TreeView.set_reorderable</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_reorderable</methodname>
	  <methodparam><parameter
			 role="keyword">reorderable</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">reorderable</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal>, the tree can be
reordered.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_reorderable</methodname>() method sets the
"reorderable" property to the value of <parameter>reorderable</parameter>.
This method is a convenience method to allow you to reorder models that
support the <link
linkend="class-gtktreedragsource"><classname>gtk.TreeDragSource</classname></link> 
and the <link
linkend="class-gtktreedragdest"><classname>gtk.TreeDragDest</classname></link> 
interfaces. Both <link
linkend="class-gtktreestore"><classname>gtk.TreeStore</classname></link> and
<link
linkend="class-gtkliststore"><classname>gtk.ListStore</classname></link>
support these. If <parameter>reorderable</parameter> is
<literal>True</literal>, then the user can reorder the model by dragging and
dropping rows. The application can listen to these changes by connecting to
the model's signals.</para>

      <note>
	<para>This function does not give you any degree of control over the
order -- any reordering is allowed.  If more control is needed, you should
probably handle drag and drop manually.</para>
      </note>

    </refsect2>

  <refsect2 id="method-gtktreeview--get-reorderable">
      <title>gtk.TreeView.get_reorderable</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_reorderable</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the tree can be
reordered.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_reorderable</methodname>() method returns
the value of the "reorderable" property that determines if the user can
reorder the tree via drag-and-drop. See the <link
linkend="method-gtktreeview--set-reorderable"><methodname>set_reorderable</methodname>()</link> 
method for more information.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-cursor">
      <title>gtk.TreeView.set_cursor</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_cursor</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">focus_column</parameter><initializer>None</initializer></methodparam>
	  <methodparam><parameter
			 role="keyword">start_editing</parameter><initializer>False</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>a tree path</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">focus_column</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link>, 
or <literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">start_editing</parameter>&nbsp;:</term>
	  <listitem><simpara><literal>if True</literal> the specified cell
should start being edited.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_cursor</methodname>() method sets the
current keyboard focus to be at the row specified by
<parameter>path</parameter>, and selects it. This is useful when you want to
focus the user's attention on a particular row. If
<parameter>column</parameter> is not <literal>None</literal>, then focus is
given to the specified column. Additionally, if
<parameter>column</parameter> is specified, and
<parameter>start_editing</parameter> is <literal>True</literal>, then
editing should be started in the specified cell. This method is often
followed by the <link
linkend="method-gtkwidget--grab-focus"><methodname>gtk.Widget.grab_focus</methodname>()</link>
method to give keyboard focus to the treeview. Please note that editing can
only happen when the widget is realized.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-cursor-on-cell">
      <title>gtk.TreeView.set_cursor_on_cell</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_cursor_on_cell</methodname>
	  <methodparam><parameter role="keyword">path</parameter></methodparam>
	  <methodparam><parameter role="keyword">focus_column</parameter><initializer>None</initializer></methodparam>
	  <methodparam><parameter role="keyword">focus_cell</parameter><initializer>None</initializer></methodparam>
	  <methodparam><parameter role="keyword">start_editing</parameter><initializer>False</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter>path</parameter>&nbsp;:</term>
	  <listitem><simpara>a tree path</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>focus_column</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
	  linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link>,
	  or <literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>focus_cell</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
	  linkend="class-gtkcellrenderer"><classname>gtk.CellRenderer</classname></link>,
	  or <literal>None</literal></simpara></listitem> </varlistentry>
	<varlistentry>
	  <term><parameter>start_editing</parameter>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the specified cell
	  should start being edited.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.2 and above.</para>
      </note>

      <para>The <methodname>set_cursor_on_cell</methodname>() method sets
the current keyboard focus to be at the node specified by
<parameter>path</parameter>, and selects it.  This is useful when you want
to focus the user's attention on a particular row. If
<parameter>focus_column</parameter> is specified, focus is given to that
column. If <parameter>focus_column</parameter> and
<parameter>focus_cell</parameter> are specified, and
<parameter>focus_column</parameter> contains 2 or more editable or
activatable cells, then focus is given to the cell specified by
<parameter>focus_cell</parameter>. Additionally, if
<parameter>focus_column</parameter> is specified, and
<parameter>start_editing</parameter> is <literal>True</literal>, editing
should be started in the specified cell. This method is often followed by
the <link
linkend="method-gtkwidget--grab-focus"><methodname>gtk.Widget.grab_focus</methodname>()</link>
method in order to give keyboard focus to the widget.  Please note that
editing can only happen when the widget is realized.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-cursor">
      <title>gtk.TreeView.get_cursor</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_cursor</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a tuple containing the current cursor path and
focus column.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_cursor</methodname>() method returns a tuple
containing the current path and focus column. If the cursor isn't currently
set, the current path will be <literal>None</literal>. If no column
currently has focus, the current focus column will be
<literal>None</literal>.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-bin-window">
      <title>gtk.TreeView.get_bin_window</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_bin_window</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link>, or
<literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_bin_window</methodname>() method returns the
window that the treeview renders to or <literal>None</literal> if the
treeview is not realized yet. This is used primarily to compare to the
<literal>event.window</literal> attribute to confirm that the event on the
treeview is on the right window.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-path-at-pos">
      <title>gtk.TreeView.get_path_at_pos</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_path_at_pos</methodname>
	  <methodparam><parameter role="keyword">x</parameter></methodparam>
	  <methodparam><parameter role="keyword">y</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">x</parameter>&nbsp;:</term>
	  <listitem><simpara>The x position to be
identified.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">y</parameter>&nbsp;:</term>
	  <listitem><simpara>The y position to be
identified.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a tuple containing: a tree path; a <link
	  linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link>
	  object; the X coordinate relative to the cell; and, the Y
	  coordinate relative to the cell. If there is no path at the
	  position <literal>None</literal> is returned.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_path_at_pos</methodname>() method returns a
tuple containing:</para>

      <itemizedlist>
	<listitem>
	  <simpara>the path at the specified point
(<parameter>x</parameter>, <parameter>y</parameter>), relative to widget
coordinates</simpara>
	</listitem>
	<listitem>
	  <simpara>the <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
at that point</simpara>
	</listitem>
	<listitem>
	  <simpara>the X coordinate relative to the cell
background</simpara>
	</listitem>
	<listitem>
	  <simpara>the Y coordinate relative to the cell
background</simpara>
	</listitem>
      </itemizedlist>

      <para><parameter>x</parameter> and <parameter>y</parameter> are
relative to the coordinates of an event on the treeview only when
<literal>event.window==treeview.get_bin_window()</literal>. It is primarily
used for popup menus. This method is only meaningful if the treeview is
realized. This method returns <literal>None</literal> if there is no path at
the position.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-cell-area">
      <title>gtk.TreeView.get_cell_area</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_cell_area</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>a tree path for the row</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
for the column</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>rectangle</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_cell_area</methodname>() method returns the
bounding <link
linkend="class-gdkrectangle"><classname>gtk.gdk.Rectangle</classname></link>
in tree window coordinates for the cell at the row specified by
<parameter>path</parameter> and the column specified by
<parameter>column</parameter>. If <parameter>path</parameter> points to a
path not currently displayed, the <parameter>y</parameter> and
<parameter>height</parameter> attributes of the rectangle will be 0. The sum
of all cell rects does not cover the entire tree; there are extra pixels in
between rows, for example. The returned rectangle is equivalent to the
<parameter>cell_area</parameter> passed to the <link
linkend="method-gtkcellrenderer--render"><methodname>gtk.CellRenderer.render</methodname>()</link> 
method. This method is only valid if the treeview is realized.</para>

    </refsect2>

  <refsect2 id="method-gtktreeview--get-background-area">
      <title>gtk.TreeView.get_background_area</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_background_area</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>a tree path for the row,</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtktreeviewcolumn"><classname>gtk.TreeViewColumn</classname></link> 
for the column</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a rectangle</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_background_area</methodname>() method
returns the bounding <link
linkend="class-gdkrectangle"><classname>gtk.gdk.Rectangle</classname></link>
in tree window coordinates for the cell at the row specified by
<parameter>path</parameter> and the column specified by
<parameter>column</parameter>. If <parameter>path</parameter> points to a
node not found in the tree, the <parameter>y</parameter> and
<parameter>height</parameter> attributes of the rectangle will be 0. The
returned rectangle is equivalent to the
<parameter>background_area</parameter> passed to the <link
linkend="method-gtkcellrenderer--render"><methodname>gtk.CellRenderer.render</methodname>()</link>. 
These background areas tile to cover the entire tree window (except for the
area used for header buttons). Contrast with the
<parameter>cell_area</parameter>, returned by the <link
linkend="method-gtktreeview--get-cell-area"><methodname>get_cell_area</methodname>()</link> 
method, that returns only the cell itself, excluding the surrounding borders
and the tree expander area.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-visible-rect">
      <title>gtk.TreeView.get_visible_rect</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_visible_rect</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a rectangle</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_visible_rect</methodname>() method returns
the bounding <link
linkend="class-gdkrectangle"><classname>gtk.gdk.Rectangle</classname></link> 
for the currently visible region of the treeview widget, in tree
coordinates. Convert to widget coordinates with the <link
linkend="method-gtktreeview--tree-to-widget-coords"><methodname>tree_to_widget_coords</methodname>()</link>. 
Tree coordinates start at 0,0 for row 0 of the tree, and cover the entire
scrollable area of the tree.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--widget-to-tree-coords">
      <title>gtk.TreeView.widget_to_tree_coords</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>widget_to_tree_coords</methodname>
	  <methodparam><parameter>wx</parameter></methodparam>
	  <methodparam><parameter>wy</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter>wx</parameter>&nbsp;:</term>
	  <listitem><simpara>the widget X coordinate</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>wy</parameter>&nbsp;:</term>
	  <listitem><simpara>the widget Y coordinate</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a tuple containing the tree X and Y
coordinates</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>widget_to_tree_coords</methodname>() method
returns a tuple containing the tree X and Y coordinates for the widget
coordinates specified by <parameter>wx</parameter> and
<parameter>wy</parameter>. The tree coordinates cover the full scrollable
area of the tree.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--tree-to-widget-coords">
      <title>gtk.TreeView.tree_to_widget_coords</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>tree_to_widget_coords</methodname>
	  <methodparam><parameter>tx</parameter></methodparam>
	  <methodparam><parameter>ty</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter>tx</parameter>&nbsp;:</term>
	  <listitem><simpara>tree X coordinate</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>ty</parameter>&nbsp;:</term>
	  <listitem><simpara>tree Y coordinate</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a tuple containing the widget X and Y
coordinates</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>tree_to_widget_coords</methodname>() method
returns a tuple containing the widget coordinates for the tree coordinates
specified by <parameter>tx</parameter> and <parameter>ty</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--enable-model-drag-source">
      <title>gtk.TreeView.enable_model_drag_source</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>enable_model_drag_source</methodname>
	  <methodparam><parameter
			 role="keyword">start_button_mask</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">targets</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">actions</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">start_button_mask</parameter>&nbsp;:</term>
	  <listitem><simpara>the bitmask of buttons that can start the
drag</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">targets</parameter>&nbsp;:</term>
	  <listitem><simpara>a sequence of tuples containing target
data</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">actions</parameter>&nbsp;:</term>
	  <listitem><simpara>the possible actions for a
drag</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>enable_model_drag_source</methodname>() method
      sets the treeview to start a drag operation when the user click and
      drags on a row. The value of <parameter>start_button_mask</parameter>
      is a combination of the<xref linkend="gdk-modifier-constants"
      endterm="gdk-modifier-constants-title"></xref>.</para>

      <para><parameter>targets</parameter> is a sequence (list or tuple) of
      tuples that contain information about the targets. The target data
      contains a string representing the drag type, target flags (a
      combination of the <xref linkend="gtk-target-flags-constants"
      endterm="gtk-target-flags-constants-title"></xref>) and an application
      assigned integer ID used for identification purposes.</para>

      <para>The value of <parameter>actions</parameter> is one of the <xref
      linkend="gdk-drag-action-constants"
      endterm="gdk-drag-action-constants-title"></xref>.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--enable-model-drag-dest">
      <title>gtk.TreeView.enable_model_drag_dest</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>enable_model_drag_dest</methodname>
	  <methodparam><parameter
			 role="keyword">targets</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">actions</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">targets</parameter>&nbsp;:</term>
	  <listitem><simpara>a sequence of tuples containing target
data</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">actions</parameter>&nbsp;:</term>
	  <listitem><simpara>the possible actions for a
drag</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>enable_model_drag_dest</methodname>() method
      sets the treeview to receive a drag drop.</para>

      <para><parameter>targets</parameter> is a sequence (list or tuple) of
      tuples that contain information about the targets. The target data
      contains a string representing the drag type, target flags (a
      combination of <literal>gtk.TARGET_SAME_APP</literal> and
      <literal>gtk.TARGET_SAME_WIDGET</literal> or neither) and an
      application assigned integer ID used for identification
      purposes.</para>

      <para>The value of <parameter>actions</parameter> is one of the <xref
      linkend="gdk-drag-action-constants"
      endterm="gdk-drag-action-constants-title"></xref>.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--unset-rows-drag-source">
      <title>gtk.TreeView.unset_rows_drag_source</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>unset_rows_drag_source</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <para>The <methodname>unset_rows_drag_source</methodname>() method
unsets the drag source information.</para>

  </refsect2>

    <refsect2 id="method-gtktreeview--unset-rows-drag-dest">
      <title>gtk.TreeView.unset_rows_drag_dest</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>unset_rows_drag_dest</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <para>The <methodname>unset_rows_drag_dest</methodname>() method
unsets the drag destination information.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-drag-dest-row">
      <title>gtk.TreeView.set_drag_dest_row</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_drag_dest_row</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">pos</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>a tree path of the row to highlight, or
          <literal>None</literal>.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">pos</parameter>&nbsp;:</term>
	  <listitem><simpara>a drop position</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_drag_dest_row</methodname>() method sets the
treeview drag destination row to the value specified by
<parameter>path</parameter> with the drop position specified by
<parameter>pos</parameter>. The value of <parameter>pos</parameter> must be
one of: <literal>gtk.TREE_VIEW_DROP_BEFORE</literal>,
<literal>gtk.TREE_VIEW_DROP_AFTER</literal>,
<literal>gtk.TREE_VIEW_DROP_INTO_OR_BEFORE</literal> or
<literal>gtk.TREE_VIEW_DROP_INTO_OR_AFTER</literal>.</para>

<para>In PyGTK 2.10 and above, <parameter>path</parameter> may be
<literal>None</literal>.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-drag-dest-row">
      <title>gtk.TreeView.get_drag_dest_row</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_drag_dest_row</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a 2-tuple containing the tree path and the drop
	  position relative to the tree path or <literal>
	  None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_drag_dest_row</methodname>() method returns
a 2-tuple containing the path of the drag destination row and a drop
position relative to the destination row. The drop position is one of:
<literal>gtk.TREE_VIEW_DROP_BEFORE</literal>,
<literal>gtk.TREE_VIEW_DROP_AFTER</literal>,
<literal>gtk.TREE_VIEW_DROP_INTO_OR_BEFORE</literal> or
<literal>gtk.TREE_VIEW_DROP_INTO_OR_AFTER</literal>. This method returns
<literal>None</literal> if no drag destination row is set.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-dest-row-at-pos">
      <title>gtk.TreeView.get_dest_row_at_pos</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_dest_row_at_pos</methodname>
	  <methodparam><parameter
			 role="keyword">x</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">y</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">x</parameter>&nbsp;:</term>
	  <listitem><simpara>the x coordinate of the
position</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">y</parameter>&nbsp;:</term>
	  <listitem><simpara>the y coordinate of the
position</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a 2-tuple containing the path of the row and
the drop position at the position specified by <parameter>x</parameter> and
<parameter>y</parameter> or <literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_dest_row_at_pos</methodname>() method
returns a 2-tuple containing the path of the row and the drop position
relative to the row of the position specified by <parameter>x</parameter>
and <parameter>y</parameter>. The drop position is one of:
<literal>gtk.TREE_VIEW_DROP_BEFORE</literal>,
<literal>gtk.TREE_VIEW_DROP_AFTER</literal>,
<literal>gtk.TREE_VIEW_DROP_INTO_OR_BEFORE</literal> or
<literal>gtk.TREE_VIEW_DROP_INTO_OR_AFTER</literal>.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--create-row-drag-icon">
      <title>gtk.TreeView.create_row_drag_icon</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>create_row_drag_icon</methodname>
	  <methodparam><parameter
			 role="keyword">path</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">path</parameter>&nbsp;:</term>
	  <listitem><simpara>a tree path</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a new pixmap of the drag
icon.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>create_row_drag_icon</methodname>() method
creates a <link
linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link>
representation of the row specified by <parameter>path</parameter>. This
image is used for a drag icon.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-enable-search">
      <title>gtk.TreeView.set_enable_search</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_enable_search</methodname>
	  <methodparam><parameter
			 role="keyword">enable_search</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">enable_search</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal>, the user can search
interactively</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_enable_search</methodname>() method sets the
"enable-search" property to the value of
<parameter>enable_search</parameter>. If
<parameter>enable_search</parameter> is <literal>True</literal> the user can
type in text to search through the tree interactively.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-enable-search">
      <title>gtk.TreeView.get_enable_search</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_enable_search</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the user can search
interactively</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_enable_search</methodname>() method returns
the value of the "enable-search" property. If "enable-search" is
<literal>True</literal> the tree allows interactive searching.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-search-column">
      <title>gtk.TreeView.get_search_column</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_search_column</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the column the interactive search code
searches.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_search_column</methodname>() method returns
the value of the "search-column" property that is  the column searched by
the interactive search code.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-search-column">
      <title>gtk.TreeView.set_search_column</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_search_column</methodname>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>the column to search</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_search_column</methodname>() method sets the
"search-column" property to the value of <parameter>column</parameter>. The
value of <parameter>column</parameter> is the column where the interactive
search code should search.  Additionally, this method turns on interactive
searching (see the <link
linkend="method-gtktreeview--set-enable-search"><methodname>set_enable_search</methodname>()</link> 
method).</para>

    </refsect2>

<!-- NOT IMPLEMENTED
    <refsect2 id="method-gtktreeview- -get-search-equal-func">
      <title>gtk.TreeView.get_search_equal_func</title>

      <programlisting><methodsynopsis language="python">
          <methodname>get_search_equal_func</methodname>
          <methodparam></methodparam>
        </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the currently used compare function for the
          search code.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.4 and above.</para>
      </note>

      <para>The <methodname>get_search_equal_func</methodname>() method
returns the compare function currently in use. This method returns None if
the default <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>
search equal function is being used. See the <link
linkend="method-gtktreeview- -set-search-equal-func"><methodname>set_search_equal_func</methodname>()</link>
method for more information.</para>

    </refsect2>
END NOT IMPLEMENTED -->

    <refsect2 id="method-gtktreeview--set-search-equal-func">
      <title>gtk.TreeView.set_search_equal_func</title>

      <programlisting><methodsynopsis language="python">
          <methodname>set_search_equal_func</methodname>
          <methodparam><parameter role="keyword">func</parameter><initializer>None</initializer></methodparam>
          <methodparam><parameter role="keyword">user_data</parameter><initializer>None</initializer></methodparam>
        </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">func</parameter>&nbsp;:</term>
          <listitem><simpara>the compare function to use during the search or <literal>None</literal></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">user_data</parameter>&nbsp;:</term>
          <listitem><simpara>user data to pass to <parameter>func</parameter>, or <literal>None</literal></simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.4 and above.</para>
      </note>

      <para>The <methodname>set_search_equal_func</methodname>() method sets
the compare function for the interactive search capabilities to the function
specified by <parameter>func</parameter>. If
<parameter>user_data</parameter> is specified and not
<literal>None</literal>, it is passed to <parameter>func</parameter>. If
<parameter>func</parameter> is <literal>None</literal>, the default <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>
search equal function will be used. The signature of
<parameter>func</parameter> is:</para>

      <programlisting>
  def func(<parameter>model</parameter>, <parameter>column</parameter>, <parameter>key</parameter>, <parameter>iter</parameter>, <parameter>data</parameter>)
</programlisting>

      <para>where <parameter>model</parameter> is the <link
linkend="class-gtktreemodel"><classname>gtk.TreeModel</classname></link> of
the <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>,
<parameter>column</parameter> is the number of the column being searched
(see the <link
linkend="method-gtktreeview--set-search-column"><methodname>set_search_column</methodname>()</link>
method for more information), <parameter>key</parameter> is the string being
searched for, <parameter>iter</parameter> is a <link
linkend="class-gtktreeiter"><classname>gtk.TreeIter</classname></link>
pointing to the current candidate row and <parameter>data</parameter> is the
context data <parameter>user_data</parameter>. <parameter>func</parameter>
should return <literal>False</literal> to indicate that the row matches the
search criteria.</para>

    </refsect2>


<!-- NOT IMPLEMENTED
  <refsect2 id="method-gtktreeview- -set-destroy-count-func">
    <title>gtk.TreeView.set_destroy_count_func</title>

<programlisting><methodsynopsis language="python">
    <methodname>set_destroy_count_func</methodname>
    <methodparam><parameter role="keyword">func</parameter></methodparam>
    <methodparam><parameter role="keyword">data</parameter></methodparam>
    <methodparam><parameter role="keyword">destroy</parameter></methodparam>
  </methodsynopsis></programlisting>
  <variablelist>
    <varlistentry>
      <term><parameter role="keyword">func</parameter>&nbsp;:</term>
      <listitem><simpara>Function to be called when a view row is destroyed, or <literal>None</literal></simpara></listitem>
    </varlistentry>
    <varlistentry>
      <term><parameter role="keyword">data</parameter>&nbsp;:</term>
      <listitem><simpara>User data to be passed to <parameter>func</parameter>, or <literal>None</literal></simpara></listitem>
    </varlistentry>
    <varlistentry>
      <term><parameter role="keyword">destroy</parameter>&nbsp;:</term>
      <listitem><simpara>Destroy notifier for <parameter>data</parameter>, or <literal>None</literal></simpara></listitem>
    </varlistentry>
  </variablelist>
<para>
This function should almost never be used.  It is meant for private use by
ATK for determining the number of visible children that are removed when the
user collapses a row, or a row is deleted.
</para>  </refsect2>
END NOT IMPLEMENTED -->

    <refsect2 id="method-gtktreeview--get-fixed-height-mode">
      <title>gtk.TreeView.get_fixed_height_mode</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_fixed_height_mode</methodname>
	  <methodparam></methodparam>
        </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if fixed height mode
is enabled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_fixed_height_mode</methodname>() method
returns the value of the "fixed-height-mode" property. If the
"fixed-height-mode" property is <literal>True</literal>, all rows are
assumed to be the same height.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-fixed-height-mode">
      <title>gtk.TreeView.set_fixed_height_mode</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_fixed_height_mode</methodname>
	  <methodparam><parameter
			 role="keyword">enable</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">enable</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> enable fixed height
mode.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_fixed_height_mode</methodname>() method sets
the "fixed-height-mode" property to the value of
<parameter>enable</parameter>. If <parameter>enable</parameter> is
<literal>True</literal> all rows are assumed to have the same height which
speeds up <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>
displays. Only enable this option if all rows are the same height and all
columns are of type <literal>gtk.TREE_VIEW_COLUMN_FIXED</literal> (see the
<xref linkend="gtk-treeviewcolumn-sizing-constants"
endterm="gtk-treeviewcolumn-sizing-constants-title"></xref>).</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-hover-selection">
      <title>gtk.TreeView.get_hover_selection</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_hover_selection</methodname>
	  <methodparam></methodparam>
        </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if hover selection
mode is enabled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_hover_selection</methodname>() method
returns the value of the "hover-selection" property. If the
"hover-selection" property is <literal>True</literal> the selected row
follows the pointer. See the <link
linkend="method-gtktreeview--set-hover-selection"><methodname>set_hover_selection</methodname>()</link>
method for more detail.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-hover-selection">
      <title>gtk.TreeView.set_hover_selection</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_hover_selection</methodname>
	  <methodparam><parameter
			 role="keyword">hover</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">hover</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> enable hover
selection mode.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname></methodname>() method sets the
"hover-selection" property to the value of <parameter>hover</parameter>. If
<parameter>hover</parameter> is <literal>True</literal> the hover selection
mode is enables and the selected row follows the pointer. Currently, this
works only for the selection modes <literal>gtk.SELECTION_SINGLE</literal>
and <literal>gtk.SELECTION_BROWSE</literal> (see the <xref
linkend="gtk-selection-mode-constants"
endterm="gtk-selection-mode-constants-title"></xref>).</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-hover-expand">
      <title>gtk.TreeView.get_hover_expand</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_hover_expand</methodname>
	  <methodparam></methodparam>
        </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if hover expand mode is
enabled</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_hover_expand</methodname>() method returns
the value of the "hover-expand" property. If the "hover-expand" property is
<literal>True</literal> rows expand or collapse if the pointer moves over
them.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-hover-expand">
      <title>gtk.TreeView.set_hover_expand</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_hover_expand</methodname>
	  <methodparam><parameter
			 role="keyword">expand</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">expand</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> enable hover expand
mode.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_hover_expand</methodname>() method sets the
"hover-expand" property to the value of <parameter>expand</parameter>. If
<parameter>expand</parameter> is <literal>True</literal>, rows expand or
collapse if the pointer moves over them. </para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-row-separator-func">
      <title>gtk.TreeView.set_row_separator_func</title>

      <programlisting><methodsynopsis language="python">
          <methodname>set_row_separator_func</methodname>
          <methodparam><parameter role="keyword">func</parameter><initializer>None</initializer></methodparam>
          <methodparam><parameter role="keyword">user_data</parameter><initializer>None</initializer></methodparam>
        </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">func</parameter>&nbsp;:</term>
          <listitem><simpara>the row separator function or
<literal>None</literal></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">user_data</parameter>&nbsp;:</term>
          <listitem><simpara>user data to pass to <parameter>func</parameter>, or <literal>None</literal></simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_row_separator_func</methodname>() method
sets the row separator function to the function specified by
<parameter>func</parameter>. The row separator function is used to determine
if a row should be displayed as a separator. If
<parameter>user_data</parameter> is specified and not
<literal>None</literal>, it is passed to <parameter>func</parameter>. If
<parameter>func</parameter> is <literal>None</literal>, no separators will
be drawn. The signature of <parameter>func</parameter> is:</para>

      <programlisting>
  def func(<parameter>model</parameter>, <parameter>iter</parameter>, <parameter>data</parameter>)
</programlisting>

      <para>where <parameter>model</parameter> is the <link
linkend="class-gtktreemodel"><classname>gtk.TreeModel</classname></link> of
the <link
linkend="class-gtktreeview"><classname>gtk.TreeView</classname></link>,
<parameter>iter</parameter> is a <link
linkend="class-gtktreeiter"><classname>gtk.TreeIter</classname></link>
pointing to the current candidate row and <parameter>data</parameter> is the
context data <parameter>user_data</parameter>. <parameter>func</parameter>
should return <literal>True</literal> to indicate that the row is a
separator.</para>

      <para>A common way to implement this is to have a boolean column in
 <parameter>model</parameter>, whose values <parameter>func</parameter>
 returns.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-visible-range">
      <title>gtk.TreeView.get_visible_range</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_visible_range</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a 2-tuple containing the start and end paths of
the visible region or <literal>None</literal>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <methodname>get_visible_range</methodname>() method returns
a 2-tuple containing the start and end paths for the visible region in the
treeview. If no valid paths are available this method returns
<literal>None</literal>.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-headers-clickable">
      <title>gtk.TreeView.get_headers_clickable</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_headers_clickable</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if all header columns
          are clickable</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Returns <literal>True</literal> if all header columns are
      clickable.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-search-entry">
      <title>gtk.TreeView.get_search_entry</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_search_entry</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the entry currently in use as the search
          entry.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Returns the <link
      linkend="class-gtkentry"><classname>gtk.Entry</classname></link> which
      is currently in use as the interactive search entry for the treeview.
      In case the built-in entry is being used, <literal>None</literal> will
      be returned.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-search-entry">
      <title>gtk.TreeView.set_search_entry</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_search_entry</methodname>
        <methodparam><parameter role="keyword">entry</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">entry</parameter>&nbsp;:</term>
          <listitem><simpara>the entry the interactive search code of the
          treeview should use or
          <literal>None</literal></simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Sets the entry which the interactive search code will use for
      this treeview.  This is useful when you want to provide a search entry
      in our interface at all time at a fixed position.  Passing
      <literal>None</literal> for <parameter>entry</parameter> will make the
      interactive search code use the built-in popup entry again.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-search-position-func">
      <title>gtk.TreeView.set_search_position_func</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_search_position_func</methodname>
        <methodparam><parameter role="keyword">func</parameter></methodparam>
        <methodparam><parameter role="keyword">data</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">func</parameter>&nbsp;:</term>
          <listitem><simpara>the function to use to position the search
          dialog, or <literal>None</literal> to use the default search
          position function</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">data</parameter>&nbsp;:</term>
          <listitem><simpara>user data to pass to
          <parameter>func</parameter>, or
          <literal>None</literal></simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Sets the function to use when positioning the search dialog. The
      signature of <parameter>func</parameter> is:</para>

      <programlisting>
  def func(treeview, search_dialog, user_data):
      </programlisting>

      <para>where <parameter>search_dialog</parameter> is the dialog to be
      positioned and <parameter>user_data</parameter> is
      <parameter>data</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-rubber-banding">
      <title>gtk.TreeView.set_rubber_banding</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_rubber_banding</methodname>
        <methodparam><parameter role="keyword">enable</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">enable</parameter>&nbsp;:</term>
          <listitem><simpara>if <literal>True</literal> enable rubber
          banding</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Enables or disables rubber banding.  If the selection mode is
      <literal>gtk.SELECTION_MULTIPLE</literal>, rubber banding will allow
      the user to select multiple rows by dragging the mouse.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-rubber-banding">
      <title>gtk.TreeView.get_rubber_banding</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_rubber_banding</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if rubber banding is
          enabled.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Returns whether rubber banding is enabled.  If the selection
      mode is <literal>gtk.SELECTION_MULTIPLE</literal>, rubber banding will
      allow the user to select multiple rows by dragging the mouse.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-grid-lines">
      <title>gtk.TreeView.get_grid_lines</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_grid_lines</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>one of the <xref
          linkend="gtk-treeview-grid-lines-constants"
          endterm="gtk-treeview-grid-lines-constants-title"></xref>
          indicating which grid lines are enabled.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Returns which grid lines are enabled.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-grid-lines">
      <title>gtk.TreeView.set_grid_lines</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_grid_lines</methodname>
        <methodparam><parameter role="keyword">grid_lines</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">grid_lines</parameter>&nbsp;:</term>
          <listitem><simpara>one of the <xref
          linkend="gtk-treeview-grid-lines-constants"
          endterm="gtk-treeview-grid-lines-constants-title"></xref>
          indicating which grid lines to enable.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Sets which grid lines to draw.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--get-enable-tree-lines">
      <title>gtk.TreeView.get_enable_tree_lines</title>

      <programlisting><methodsynopsis language="python">
        <methodname>get_enable_tree_lines</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if tree lines are
          drawn.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Returns <literal>True</literal> if tree lines are drawn.</para>

    </refsect2>

    <refsect2 id="method-gtktreeview--set-enable-tree-lines">
      <title>gtk.TreeView.set_enable_tree_lines</title>

      <programlisting><methodsynopsis language="python">
        <methodname>set_enable_tree_lines</methodname>
        <methodparam><parameter role="keyword">enabled</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">enabled</parameter>&nbsp;:</term>
          <listitem><simpara>if <literal>True</literal> enable tree line
          drawing.</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.10 and above.</para>
      </note>

      <para>Sets whether to draw lines interconnecting the expanders.  This
      does not have any visible effects for lists.</para>

    </refsect2>
    
    <refsect2 id="method-gtktreeview--convert-widget-to-bin-window-coords">
        <title>gtk.TreeView.convert_widget_to_bin_window_coords</title>

        <programlisting><methodsynopsis language="python">
            <methodname>convert_widget_to_bin_window_coords</methodname>
            <methodparam><parameter role="keyword">widget_x</parameter></methodparam>
            <methodparam><parameter role="keyword">widget_y</parameter></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">widget_x</parameter>&nbsp;:</term>
                <listitem><simpara>X coordinate relative to the widget.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">widget_y</parameter>&nbsp;:</term>
                <listitem><simpara>Y coordinate relative to the widget.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara>A tuple containing the bin_window X and Y coordinates.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Converts widget coordinates to coordinates for the bin_window (see <methodname><link
            linkend="method-gtktreeview--get-bin-window">get_bin_window</link></methodname>).
        </para>
    </refsect2>

    <refsect2 id="method-gtktreeview--convert-widget-to-tree-coords">
        <title>gtk.TreeView.convert_widget_to_tree_coords</title>

        <programlisting><methodsynopsis language="python">
            <methodname>convert_widget_to_tree_coords</methodname>
            <methodparam><parameter role="keyword">widget_x</parameter></methodparam>
            <methodparam><parameter role="keyword">widget_y</parameter></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">widget_x</parameter>&nbsp;:</term>
                <listitem><simpara>X coordinate relative to the widget.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">widget_y</parameter>&nbsp;:</term>
                <listitem><simpara>Y coordinate relative to the widget.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara>A tuple containing the tree X and Y coordinates.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Converts widget coordinates to coordinates for the tree (the full scrollable area of the tree).
        </para>
    </refsect2>

    <refsect2 id="method-gtktreeview--convert-tree-to-widget-coords">
        <title>gtk.TreeView.convert_tree_to_widget_coords</title>

        <programlisting><methodsynopsis language="python">
            <methodname>convert_tree_to_widget_coords</methodname>
            <methodparam><parameter role="keyword">tree_x</parameter></methodparam>
            <methodparam><parameter role="keyword">tree_y</parameter></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">tree_x</parameter>&nbsp;:</term>
                <listitem><simpara>X coordinate relative to the tree.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">tree_y</parameter>&nbsp;:</term>
                <listitem><simpara>Y coordinate relative to the tree.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara>A tuple containing the widget X and Y coordinates.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Converts tree coordinates (coordinates in full scrollable area of the tree) to widget coordinates.
        </para>
    </refsect2>

    <refsect2 id="method-gtktreeview--convert-tree-to-bin-window-coords">
        <title>gtk.TreeView.convert_tree_to_bin_window_coords</title>

        <programlisting><methodsynopsis language="python">
            <methodname>convert_tree_to_bin_window_coords</methodname>
            <methodparam><parameter role="keyword">tree_x</parameter></methodparam>
            <methodparam><parameter role="keyword">tree_y</parameter></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">tree_x</parameter>&nbsp;:</term>
                <listitem><simpara>X coordinate relative to the tree.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">tree_y</parameter>&nbsp;:</term>
                <listitem><simpara>Y coordinate relative to the tree.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara>A tuple containing the bin window X and Y coordinates.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Converts tree coordinates (coordinates in full scrollable area of the tree) to bin_window coordinates.
        </para>
    </refsect2>

    <refsect2 id="method-gtktreeview--convert-bin-window-to-widget-coords">
        <title>gtk.TreeView.convert_bin_window_to_widget_coords</title>

        <programlisting><methodsynopsis language="python">
            <methodname>convert_bin_window_to_widget_coords</methodname>
            <methodparam><parameter role="keyword">window_x</parameter></methodparam>
            <methodparam><parameter role="keyword">window_y</parameter></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">window_x</parameter>&nbsp;:</term>
                <listitem><simpara>X coordinate relative to the bin window.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">window_y</parameter>&nbsp;:</term>
                <listitem><simpara>Y coordinate relative to the bin window.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara>A tuple containing the widget X and Y coordinates.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Converts bin window coordinates (see <methodname><link
            linkend="method-gtktreeview--get-bin-window">get_bin_window</link></methodname>)
            to widget relative coordinates.
        </para>
    </refsect2>

    <refsect2 id="method-gtktreeview--convert-bin-window-to-tree-coords">
        <title>gtk.TreeView.convert_bin_window_to_tree_coords</title>

        <programlisting><methodsynopsis language="python">
            <methodname>convert_bin_window_to_tree_coords</methodname>
            <methodparam><parameter role="keyword">window_x</parameter></methodparam>
            <methodparam><parameter role="keyword">window_y</parameter></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">window_x</parameter>&nbsp;:</term>
                <listitem><simpara>X coordinate relative to the bin window.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">window_y</parameter>&nbsp;:</term>
                <listitem><simpara>Y coordinate relative to the bin window.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara>A tuple containing the tree X and Y coordinates.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Converts bin window coordinates (see <methodname><link
            linkend="method-gtktreeview--get-bin-window">get_bin_window</link></methodname>)
            to the tree (the full scrollable area of the tree).
        </para>
    </refsect2>
    
    <refsect2 id="method-gtktreeview--get-level-indentation">
        <title>gtk.TreeView.get_level_indentation</title>

        <programlisting><methodsynopsis language="python">
            <methodname>get_level_indentation</methodname>
            <methodparam></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara>the amount of extra indentation for child levels in tree_view.
                A return value of 0 means that this feature is disabled.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Returns the amount, in pixels, of extra indentation for child levels in tree_view.
        </para>
    </refsect2>
    
    <refsect2 id="method-gtktreeview--set-level-indentation">
        <title>gtk.TreeView.set_level_indentation</title>

        <programlisting><methodsynopsis language="python">
            <methodname>set_level_indentation</methodname>
            <methodparam><parameter role="keyword">indentation</parameter></methodparam>
            <methodparam></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">indentation</parameter>&nbsp;:</term>
                <listitem><simpara>the amount, in pixels, of extra indentation in tree_view.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Sets the amount of extra indentation for child levels to use in tree_view
            in addition to the default indentation. The value should be specified in pixels,
            a value of 0 disables this feature and in this case only the default indentation
            will be used. This does not have any visible effects for lists.
        </para>
    </refsect2>
    
    <refsect2 id="method-gtktreeview--get-show-expanders">
        <title>gtk.TreeView.get_show_expanders</title>

        <programlisting><methodsynopsis language="python">
            <methodname>get_show_expanders</methodname>
            <methodparam></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara><literal>True</literal> if expanders are drawn
                in tree_view, <literal>False</literal> otherwise.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Returns whether or not expanders are drawn in tree_view.
        </para>
    </refsect2>
    
    <refsect2 id="method-gtktreeview--set-show-expanders">
        <title>gtk.TreeView.set_show_expanders</title>

        <programlisting><methodsynopsis language="python">
            <methodname>set_show_expanders</methodname>
            <methodparam><parameter role="keyword">enabled</parameter></methodparam>
            <methodparam></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">indentation</parameter>&nbsp;:</term>
                <listitem><simpara><literal>True</literal> to enable expander drawing, <literal>False</literal> otherwise.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Sets whether to draw and enable expanders and indent child rows in tree_view.
            When disabled there will be no expanders visible in trees and there will be
            no way to expand and collapse rows by default. Also note that hiding the expanders
            will disable the default indentation. You can set a custom indentation in this case using
            gtk_tree_view_set_level_indentation().
            This does not have any visible effects for lists.
        </para>
    </refsect2>
    
    <refsect2 id="method-gtktreeview--get-tooltip-column">
        <title>gtk.TreeView.get_tooltip_column</title>

        <programlisting><methodsynopsis language="python">
            <methodname>get_tooltip_column</methodname>
            <methodparam></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara>the index of the tooltip column that is currently
                being used, or -1 if this is disabled.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Returns the column of tree_view's model which is being used for
            displaying tooltips on tree_view's rows.
        </para>
    </refsect2>
    
    <refsect2 id="method-gtktreeview--set-tooltip-column">
        <title>gtk.TreeView.set_tooltip_column</title>

        <programlisting><methodsynopsis language="python">
            <methodname>set_tooltip_column</methodname>
            <methodparam><parameter role="keyword">column</parameter></methodparam>
            <methodparam></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">column</parameter>&nbsp;:</term>
                <listitem><simpara>an integer, which is a valid column number
                for tree_view's model</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            If you only plan to have simple (text-only) tooltips on full rows, you can
            use this function to have GtkTreeView handle these automatically for you.
            column should be set to the column in tree_view's model containing the
            tooltip texts, or -1 to disable this feature.
        </para>
        <para>
            When enabled, GtkWidget::has-tooltip will be set to <literal>True</literal>
            and tree_view will connect a GtkWidget::query-tooltip signal handler.
        </para>
    </refsect2>
    
    <refsect2 id="method-gtktreeview--is-rubber-banding-active">
        <title>gtk.TreeView.is_rubber_banding_active</title>

        <programlisting><methodsynopsis language="python">
            <methodname>is_rubber_banding_active</methodname>
            <methodparam></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><emphasis>Returns</emphasis>&nbsp;:</term>
                <listitem><simpara><literal>True</literal> if a rubber banding
                operation is currently being done in tree_view.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Returns whether a rubber banding operation is currently being done in tree_view.
        </para>
    </refsect2>
    
    <refsect2 id="method-gtktreeview--set-tooltip-cell">
        <title>gtk.TreeView.set_tooltip_cell</title>

        <programlisting><methodsynopsis language="python">
            <methodname>set_tooltip_cell</methodname>
            <methodparam><parameter role="keyword">tooltip</parameter></methodparam>
            <methodparam><parameter role="keyword">path</parameter></methodparam>
            <methodparam><parameter role="keyword">column</parameter></methodparam>
            <methodparam><parameter role="keyword">cell</parameter></methodparam>
            <methodparam></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">tooltip</parameter>&nbsp;:</term>
                <listitem><simpara>a <classname><link linkend="class-gtktooltip">gtk.Tooltip</link></classname>.
                </simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">path</parameter>&nbsp;:</term>
                <listitem><simpara>a tree path or <literal>None</literal>.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">column</parameter>&nbsp;:</term>
                <listitem><simpara>a <classname><link linkend="class-gtktreeviewcolumn">gtk.TreeViewColumn</link></classname>
                or <literal>None</literal>.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">cell</parameter>&nbsp;:</term>
                <listitem><simpara>a <classname><link linkend="class-gtkcellrenderer">gtk.CellRenderer</link></classname>
                or <literal>None</literal>.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Sets the tip area of tooltip to the area path, column and cell have in common.
            For example if path is <literal>None</literal> and column is set, the tip
            area will be set to the full area covered by column.
            
            <!-- FIXME the following method is missing
            See also gtk_tooltip_set_tip_area().
            -->
        </para>
    </refsect2>
    
    <refsect2 id="method-gtktreeview--set-tooltip-row">
        <title>gtk.TreeView.set_tooltip_row</title>

        <programlisting><methodsynopsis language="python">
            <methodname>set_tooltip_row</methodname>
            <methodparam><parameter role="keyword">tooltip</parameter></methodparam>
            <methodparam><parameter role="keyword">path</parameter></methodparam>
            <methodparam></methodparam>
        </methodsynopsis></programlisting>

        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">tooltip</parameter>&nbsp;:</term>
                <listitem><simpara>a <classname><link linkend="class-gtktooltip">gtk.Tooltip</link></classname>.
                </simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">path</parameter>&nbsp;:</term>
                <listitem><simpara>a tree path.</simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This method is available in PyGTK 2.12 and above.</para>
        </note>

        <para>
            Sets the tip area of tooltip to be the area covered by the row at path.
            
            <!-- FIXME the following method is missing
            See also gtk_tooltip_set_tip_area().
            -->
        </para>
    </refsect2>

  </refsect1>

  <refsect1>
    <title>Signals</title>

    <refsect2 id="signal-gtktreeview--columns-changed">
      <title>The "columns-changed" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "columns-changed" signal is emitted when a column has been
added to, removed from or moved in <parameter>treeview</parameter>.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--cursor-changed">
      <title>The "cursor-changed" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "cursor-changed" signal is emitted when the cursor moves or
is set.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--expand-collapse-cursor-row">
      <title>The "expand-collapse-cursor-row" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>logical</parameter></methodparam>
	  <methodparam><parameter>expand</parameter></methodparam>
	  <methodparam><parameter>open_all</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>logical</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal>
</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>expand</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> the row should be
expanded</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>open_all</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> recursively expand
all children</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "expand-collapse-cursor-row" signal is emitted when the row
at the cursor needs to be expanded or collapsed.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--move-cursor">
      <title>The "move-cursor" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>step</parameter></methodparam>
	  <methodparam><parameter>count</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>step</parameter>&nbsp;:</term>
	  <listitem><simpara>the movement step size</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>count</parameter>&nbsp;:</term>
	  <listitem><simpara>the number of steps to
take</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "move-cursor" signal is emitted when the user moves the
cursor using the <keycap>Right</keycap>, <keycap>Left</keycap>,
<keycap>Up</keycap> or <keycap>Down</keycap> arrow keys or the
<keycap>Page Up</keycap>, <keycap>Page Down</keycap>, <keycap>Home</keycap>
and <keycap>End</keycap> keys.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--row-activated">
      <title>The "row-activated" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>path</parameter></methodparam>
	  <methodparam><parameter>view_column</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>path</parameter>&nbsp;:</term>
	  <listitem><simpara>the path of the activated
row</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>view_column</parameter>&nbsp;:</term>
	  <listitem><simpara>the column in the activated
row</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "row-activated" signal is emitted when the <link
linkend="method-gtktreeview--row-activated"><methodname>row_activated</methodname>()</link>
method is called or the user double clicks a <parameter>treeview</parameter>
row. "row-activated" is also emitted when a non-editable row is selected and
one of the keys: <keycap>Space</keycap>, <keycombo
action="simul"><keycap>Shift</keycap><keycap>Space</keycap> </keycombo>,
<keycap>Return</keycap> or <keycap>Enter</keycap> is pressed.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--row-collapsed">
      <title>The "row-collapsed" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>iter</parameter></methodparam>
	  <methodparam><parameter>path</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>iter</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
	  linkend="class-gtktreeiter"><classname>gtk.TreeIter</classname></link>
	  pointing to the row that collapsed</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>path</parameter>&nbsp;:</term>
	  <listitem><simpara>the path of the row that
collapsed</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "row-collapsed" signal is emitted when a row is collapsed by
user of programmatic action.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--row-expanded">
      <title>The "row-expanded" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>iter</parameter></methodparam>
	  <methodparam><parameter>path</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>iter</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
	  linkend="class-gtktreeiter"><classname>gtk.TreeIter</classname></link>
	  pointing to the row that expanded</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>path</parameter>&nbsp;:</term>
	  <listitem><simpara>the path of the row that
expanded</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "row-expanded" signal is emitted when a row is expanded via
user or programmatic action.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--select-all">
      <title>The "select-all" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "select-all" signal is emitted when the user presses
<keycombo action="simul"><keycap>Control</keycap><keycap>a</keycap>
	</keycombo> or <keycombo action="simul"><keycap>Control</keycap><keycap>/</keycap>
	</keycombo>.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--select-cursor-parent">
      <title>The "select-cursor-parent" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "select-cursor-parent" signal is emitted when the user
presses <keycombo action="simul"><keycap>Backspace</keycap></keycombo> while
a row has the cursor.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--select-cursor-row">
      <title>The "select-cursor-row" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>start_editing</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>start_editing</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> the cell editing is
started</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "select-cursor-row" signal is emitted when a non-editable
row is selected and one of the keys: <keycap>Space</keycap>, <keycombo
action="simul"><keycap>Shift</keycap><keycap>Space</keycap></keycombo>,
<keycap>Return</keycap> or <keycap>Enter</keycap> is pressed.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--set-scroll-adjustments">
      <title>The "set-scroll-adjustments" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>hadjustment</parameter></methodparam>
	  <methodparam><parameter>vadjustment</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>hadjustment</parameter>&nbsp;:</term>
	  <listitem><simpara>a horizontal <link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>vadjustment</parameter>&nbsp;:</term>
	  <listitem><simpara>a vertical <link
linkend="class-gtkadjustment"><classname>gtk.Adjustment</classname></link></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "set-scroll-adjustments" signal is emitted when new
horizontal or vertical adjustments are set on the
<parameter>treeview</parameter>.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--start-interactive-search">
      <title>The "start-interactive-search" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "start-interactive-search" signal is emitted when the user
presses <keycombo action="simul"><keycap>Control</keycap><keycap>f</keycap>
</keycombo>.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--test-collapse-row">
      <title>The "test-collapse-row" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>iter</parameter></methodparam>
	  <methodparam><parameter>path</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>iter</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeiter"><classname>gtk.TreeIter</classname></link>
pointing at the row to test.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>path</parameter>&nbsp;:</term>
	  <listitem><simpara>the path of the row to be
tested</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the row should be
	  collapsed.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "test-collapse-row" signal is emitted when the row pointed
to by <parameter>iter</parameter> and <parameter>path</parameter> is to be
collapsed.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--test-expand-row">
      <title>The "test-expand-row" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>iter</parameter></methodparam>
	  <methodparam><parameter>path</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>iter</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtktreeiter"><classname>gtk.TreeIter</classname></link>
pointing at the row to test.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>path</parameter>&nbsp;:</term>
	  <listitem><simpara>the path of the row to
test</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the row should be
	  expanded.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "test-expand-row" signal is emitted when the row pointed to
by <parameter>iter</parameter> and <parameter>path</parameter> is to be
expanded.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--toggle-cursor-row">
      <title>The "toggle-cursor-row" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "toggle-cursor-row" signal is emitted when the user presses
<keycombo action="simul"><keycap>Control</keycap><keycap>Space</keycap>
</keycombo>.</para>

    </refsect2>

    <refsect2 id="signal-gtktreeview--unselect-all">
      <title>The "unselect-all" gtk.TreeView Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>treeview</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>treeview</parameter>&nbsp;:</term>
	  <listitem><simpara>the treeview that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "unselect-all" signal is emitted when the user presses
<keycombo
action="simul"><keycap>Shift</keycap><keycap>Control</keycap><keycap>a</keycap>
</keycombo> or <keycombo
action="simul"><keycap>Shift</keycap><keycap>Control</keycap><keycap>/</keycap>
</keycombo>.</para>

    </refsect2>

  </refsect1>

</refentry>