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

<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.IconView</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtkicontheme.html" title="gtk.IconTheme"><link rel="next" href="class-gtkimage.html" title="gtk.Image"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.IconView</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkicontheme.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkimage.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.IconView"><a name="class-gtkiconview"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.IconView</h2><p>gtk.IconView — a widget which displays a list of icons in a grid (new in
PyGTK 2.6)</p></div><div class="refsect1" title="Synopsis"><a name="id3741620"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.IconView</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a></span></span>, <span class="ooclass"><span class="classname"><a class="link" href="class-gtkcelllayout.html" title="gtk.CellLayout">gtk.CellLayout</a></span></span>):
<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-gtkiconview.html#constructor-gtkiconview" title="Constructor">gtk.IconView</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-model" title="gtk.IconView.set_model">set_model</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-model" title="gtk.IconView.get_model">get_model</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-text-column" title="gtk.IconView.set_text_column">set_text_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-text-column" title="gtk.IconView.get_text_column">get_text_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-markup-column" title="gtk.IconView.set_markup_column">set_markup_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-markup-column" title="gtk.IconView.get_markup_column">get_markup_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-pixbuf-column" title="gtk.IconView.set_pixbuf_column">set_pixbuf_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-pixbuf-column" title="gtk.IconView.get_pixbuf_column">get_pixbuf_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-path-at-pos" title="gtk.IconView.get_path_at_pos">get_path_at_pos</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-item-at-pos" title="gtk.IconView.get_item_at_pos">get_item_at_pos</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-cursor" title="gtk.IconView.set_cursor">set_cursor</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_editing</code></strong></span><span class="initializer">=False</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-cursor" title="gtk.IconView.get_cursor">get_cursor</a></span>()</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--selected-foreach" title="gtk.IconView.selected_foreach">selected_foreach</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-selection-mode" title="gtk.IconView.set_selection_mode">set_selection_mode</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mode</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-selection-mode" title="gtk.IconView.get_selection_mode">get_selection_mode</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-orientation" title="gtk.IconView.set_orientation">set_orientation</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>orientation</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-orientation" title="gtk.IconView.get_orientation">get_orientation</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-columns" title="gtk.IconView.set_columns">set_columns</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>columns</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-columns" title="gtk.IconView.get_columns">get_columns</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-columns" title="gtk.IconView.set_columns">set_item_width</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item_width</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-columns" title="gtk.IconView.get_columns">get_item_width</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-columns" title="gtk.IconView.set_columns">set_spacing</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>spacing</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-columns" title="gtk.IconView.get_columns">get_spacing</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-columns" title="gtk.IconView.set_columns">set_row_spacing</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>row_spacing</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-columns" title="gtk.IconView.get_columns">get_row_spacing</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-columns" title="gtk.IconView.set_columns">set_column_spacing</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column_spacing</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-columns" title="gtk.IconView.get_columns">get_column_spacing</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-columns" title="gtk.IconView.set_columns">set_margin</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>margin</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-columns" title="gtk.IconView.get_columns">get_margin</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--select-path" title="gtk.IconView.select_path">select_path</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--unselect-path" title="gtk.IconView.unselect_path">unselect_path</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--path-is-selected" title="gtk.IconView.path_is_selected">path_is_selected</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-selected-items" title="gtk.IconView.get_selected_items">get_selected_items</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--select-all" title="gtk.IconView.select_all">select_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--unselect-all" title="gtk.IconView.unselect_all">unselect_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--item-activated" title="gtk.IconView.item_activated">item_activated</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--scroll-to-path" title="gtk.IconView.scroll_to_path">scroll_to_path</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>use_align</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>row_align</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>col_align</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-visible-range" title="gtk.IconView.get_visible_range">get_visible_range</a></span>()</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--enable-model-drag-source" title="gtk.IconView.enable_model_drag_source">enable_model_drag_source</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_button_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actons</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--enable-model-drag-dest" title="gtk.IconView.enable_model_drag_dest">enable_model_drag_dest</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--unset-model-drag-source" title="gtk.IconView.unset_model_drag_source">unset_model_drag_source</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--unset-model-drag-dest" title="gtk.IconView.unset_model_drag_dest">unset_model_drag_dest</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-reorderable" title="gtk.IconView.set_reorderable">set_reorderable</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>reorderable</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-reorderable" title="gtk.IconView.get_reorderable">get_reorderable</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-drag-dest-item" title="gtk.IconView.set_drag_dest_item">set_drag_dest_item</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pos</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-drag-dest-item" title="gtk.IconView.get_drag_dest_item">get_drag_dest_item</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-dest-item-at-pos" title="gtk.IconView.get_dest_item_at_pos">get_dest_item_at_pos</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>drag_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>drag_y</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--create-drag-icon" title="gtk.IconView.create_drag_icon">create_drag_icon</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--convert-widget-to-bin-window-coords" title="gtk.IconView.convert_widget_to_bin_window_coords">convert_widget_to_bin_window_coords</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_y</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-tooltip-cell" title="gtk.IconView.set_tooltip_cell">set_tooltip_cell</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tooltip</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-tooltip-column" title="gtk.IconView.set_tooltip_column">set_tooltip_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-tooltip-column" title="gtk.IconView.get_tooltip_column">get_tooltip_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-tooltip-item" title="gtk.IconView.set_tooltip_item">set_tooltip_item</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tooltip</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-item-row" title="gtk.IconView.get_item_row">get_item_row</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-item-column" title="gtk.IconView.get_item_column">get_item_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-item-orientation" title="gtk.IconView.set_item_orientation">set_item_orientation</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>orientation</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-item-orientation" title="gtk.IconView.get_item_orientation">get_item_orientation</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--set-item-padding" title="gtk.IconView.set_item_padding">set_item_padding</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item_padding</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-item-padding" title="gtk.IconView.get_item_padding">get_item_padding</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3743380"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
  +-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
    +-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
      +-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
        +-- <a class="link" href="class-gtkiconview.html" title="gtk.IconView">gtk.IconView</a> (implements <a class="link" href="class-gtkcelllayout.html" title="gtk.CellLayout">gtk.CellLayout</a>)</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id3743431"></a><h2>Implemented Interfaces</h2><p>
			<a class="link" href="class-gtkiconview.html" title="gtk.IconView"><code class="classname">gtk.IconView</code></a>
			implements 
			<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
		</p></div><div class="refsect1" title="gtk.IconView Properties"><a name="properties-gtkiconview"></a><h2>gtk.IconView Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"column-spacing"</td><td valign="top">Read-Write</td><td valign="top">The space (in pixels) inserted between grid
columns. Allowed values: &gt;= 0. Default value: 6.
Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"columns"</td><td valign="top">Read-Write</td><td valign="top">The number of columns in a row. If it is -1, the number
of columns will be chosen automatically to fill the available width.
Allowed values: &gt;= -1. Default value: -1.
Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"item-orientation"</td><td valign="top">Read-Write</td><td valign="top">Specifies how the cells (i.e. the icon and the text) of the
item are positioned relative to each other.
Default value: <code class="literal">gtk.ORIENTATION_VERTICAL</code>.
Available in GTK+ 2.22 and above.</td></tr><tr valign="top"><td valign="top">"item-padding"</td><td valign="top">Read-Write</td><td valign="top">Specifies the padding around each of the icon view's item. .
Available in GTK+ 2.22 and above.</td></tr><tr valign="top"><td valign="top">"item-width"</td><td valign="top">Read-Write</td><td valign="top">The width used for each item. If it is -1 the width the
largest item is used. Allowed values: &gt;= -1. Default value: -1.
Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"margin"</td><td valign="top">Read-Write</td><td valign="top">The space (in pixels) inserted at the edges of the
icon view. Allowed values: &gt;= 0. Default value: 6.
Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"markup-column"</td><td valign="top">Read-Write</td><td valign="top">The number of the model column containing markup
information to be displayed. If this property and the "text-column" property
are both set to column numbers, this overrides the text column. If both are
set to -1, no text is displayed. Allowed values: &gt;= -1. Default value: -1.
Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"model"</td><td valign="top">Read-Write</td><td valign="top">The <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
for the icon view. Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"orientation"</td><td valign="top">Read-Write</td><td valign="top">How the text and icon of each item are positioned
relative to each other. Default value:
<code class="literal">gtk.ORIENTATION_VERTICAL</code>. Available in GTK+ 2.6 and
above.</td></tr><tr valign="top"><td valign="top">"pixbuf-column"</td><td valign="top">Read-Write</td><td valign="top">The number of the model column containing the pixbufs
that are displayed. Setting this property to -1 turns off the display of
pixbufs. Allowed values: &gt;= -1. Default value: -1. Available in GTK+ 2.6 and
above.</td></tr><tr valign="top"><td valign="top">"reorderable"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> the icon view is reorderable.
Default value: <code class="literal">False</code>.
Available in GTK+ 2.8 and above.</td></tr><tr valign="top"><td valign="top">"row-spacing"</td><td valign="top">Read-Write</td><td valign="top">The space (in pixels) inserted between grid rows.
Allowed values: &gt;= 0. Default value: 6.
Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"selection-mode"</td><td valign="top">Read-Write</td><td valign="top">The selection mode of the icon view. If the mode is
<code class="literal">gtk.SELECTION_MULTIPLE</code>, rubberband selection is enabled,
for the other modes, only keyboard selection is possible. Default value:
<code class="literal">gtk.SELECTION_SINGLE</code>. Available in GTK+ 2.6 and
above.</td></tr><tr valign="top"><td valign="top">"spacing"</td><td valign="top">Read-Write</td><td valign="top">The space (in pixels) inserted between cells of an item.
Allowed values: &gt;= 0. Default value: 0.
Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"text-column"</td><td valign="top">Read-Write</td><td valign="top">The number of the model column containing the text that
is displayed. If this property and the "markup-column" property are both set
to -1, no text is displayed. Allowed values: &gt;= -1. Default value:
-1. Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"tooltip-column"</td><td valign="top">Read-Write</td><td valign="top">The number of the model column containing the tooltip text for the items.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.IconView Style Properties"><a name="style-properties-gtkiconview"></a><h2>gtk.IconView Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"selection-box-alpha"</td><td valign="top">Read</td><td valign="top">The opacity of the selection box. Default value:
64. Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"selection-box-color"</td><td valign="top">Read</td><td valign="top">The color of the selection box. Available in GTK+ 2.6
and above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.IconView Signal Prototypes"><a name="signal-prototypes-gtkiconview"></a><h2>gtk.IconView Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtkiconview.html#signal-gtkiconview--activate-cursor-item" title='The "activate-cursor-item" gtk.IconView Signal'>activate-cursor-item</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkiconview.html#signal-gtkiconview--item-activated" title='The "item-activated" gtk.IconView Signal'>item-activated</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkiconview.html#signal-gtkiconview--move-cursor" title='The "move-cursor" gtk.IconView Signal'>move-cursor</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>step</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>number</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkiconview.html#signal-gtkiconview--select-all" title='The "select-all" gtk.IconView Signal'>select-all</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkiconview.html#signal-gtkiconview--select-cursor-item" title='The "select-cursor-item" gtk.IconView Signal'>select-cursor-item</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkiconview.html#signal-gtkiconview--selection-changed" title='The "selection-changed" gtk.IconView Signal'>selection-changed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkiconview.html#signal-gtkiconview--set-scroll-adjustments" title='The "set-scroll-adjustments" gtk.IconView Signal'>set-scroll-adjustments</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>hadj</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>vadj</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkiconview.html#signal-gtkiconview--toggle-cursor-item" title='The "toggle-cursor-item" gtk.IconView Signal'>toggle-cursor-item</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkiconview.html#signal-gtkiconview--unselect-all" title='The "unselect-all" gtk.IconView Signal'>unselect-all</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id3744655"></a><h2>Description</h2><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This widget is available in PyGTK 2.6 and above.</p></div><p>The <a class="link" href="class-gtkiconview.html" title="gtk.IconView"><code class="classname">gtk.IconView</code></a>
widget provides an alternative view of a <a class="link" href="class-gtkliststore.html" title="gtk.ListStore"><code class="classname">gtk.ListStore</code></a>
model. It displays the model as a grid of icons with labels. Like <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>, you
can select one or multiple items (depending on the selection mode, see the
<a class="link" href="class-gtkiconview.html#method-gtkiconview--set-selection-mode" title="gtk.IconView.set_selection_mode"><code class="methodname">set_selection_mode</code>()</a>
method for more information). In addition to selection with the arrow keys,
<a class="link" href="class-gtkiconview.html" title="gtk.IconView"><code class="classname">gtk.IconView</code></a>
supports rubberband selection, which is controlled by dragging the
pointer.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtkiconview"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">gtk.IconView</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>model</code></strong> :</span></p></td><td>A <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>, or
<code class="literal">None</code></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-gtkiconview.html" title="gtk.IconView"><code class="classname">gtk.IconView</code></a>
widget.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This constructor is available in PyGTK 2.6 and above.</p></div><p>Creates a new <a class="link" href="class-gtkiconview.html" title="gtk.IconView"><code class="classname">gtk.IconView</code></a>
widget. If <em class="parameter"><code>model</code></em> is specified and not
<code class="literal">None</code> it should specify a <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> to
be used as the model.</p></div><div class="refsect1" title="Methods"><a name="id3744855"></a><h2>Methods</h2><div class="refsect2" title="gtk.IconView.set_model"><a name="method-gtkiconview--set-model"></a><h3>gtk.IconView.set_model</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_model</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>model</code></strong> :</span></p></td><td>a <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
or <code class="literal">None</code></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_model</code>() method sets the "model"
property to the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
specified by <em class="parameter"><code>model</code></em>. If <em class="parameter"><code>model</code></em>
is <code class="literal">None</code> the old model will be unset.</p></div><div class="refsect2" title="gtk.IconView.get_model"><a name="method-gtkiconview--get-model"></a><h3>gtk.IconView.get_model</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_model</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
used by the cell view or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_model</code>() method returns the
value of the "model" property which contains the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
used by the cell view. If no model is being used this method returns
<code class="literal">None</code>.</p></div><div class="refsect2" title="gtk.IconView.set_text_column"><a name="method-gtkiconview--set-text-column"></a><h3>gtk.IconView.set_text_column</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_text_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>The index of a column in the 
model or -1 to unset the column</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_text_column</code>() method sets the
"text-column" property to the value of <em class="parameter"><code>column</code></em> which
should be the index of a column in the model containing strings to be used
for text. If <em class="parameter"><code>column</code></em> is -1 the text column is
unset.</p></div><div class="refsect2" title="gtk.IconView.get_text_column"><a name="method-gtkiconview--get-text-column"></a><h3>gtk.IconView.get_text_column</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_text_column</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The index of a model's column or -1 if 
unset.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_text_column</code>() method returns
the value of the "text-column" property which contains the index of the
column in the model that provides strings to be used for text. If the
"text-column" property contains -1 then no column is used for text.</p></div><div class="refsect2" title="gtk.IconView.set_markup_column"><a name="method-gtkiconview--set-markup-column"></a><h3>gtk.IconView.set_markup_column</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_markup_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>The index of a column in the model or -1.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_markup_column</code>() method sets the
"markup-column" property to the value specified by
<em class="parameter"><code>column</code></em>.  The "markup-column" property indicates the
index of a column in the model to be used for markup information. If
<em class="parameter"><code>column</code></em> is -1 the markup column will be unset. If the
markup column is set, it overrides the text column set by the <a class="link" href="class-gtkiconview.html#method-gtkiconview--set-text-column" title="gtk.IconView.set_text_column"><code class="methodname">set_text_column</code>()</a>
method.</p></div><div class="refsect2" title="gtk.IconView.get_markup_column"><a name="method-gtkiconview--get-markup-column"></a><h3>gtk.IconView.get_markup_column</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_markup_column</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the index of the model column containing markup
or -1.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_markup_column</code> method returns
the value of the "markup-column" property which contains the index of the
column in the model that contains the Pango markup for text. if the
"markup-column" property is -1, the markup column is unset.</p></div><div class="refsect2" title="gtk.IconView.set_pixbuf_column"><a name="method-gtkiconview--set-pixbuf-column"></a><h3>gtk.IconView.set_pixbuf_column</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_pixbuf_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>the index of a model column or
-1</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_pixbuf_column</code>() method sets the
"pixbuf-column" property to the value of <em class="parameter"><code>column</code></em>. If
column &gt;= 0 the icon view <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
objects will be retrieved from the specified column. If
<em class="parameter"><code>column</code></em> is -1 then no pixbufs will be used,</p></div><div class="refsect2" title="gtk.IconView.get_pixbuf_column"><a name="method-gtkiconview--get-pixbuf-column"></a><h3>gtk.IconView.get_pixbuf_column</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_pixbuf_column</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The index of a column in the model or
-1</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_pixbuf_column</code>() returns the
value of the "pixbuf-column" property which contains the index of the model
column use to to retrieve <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>
objects to display. If the "pixbuf-column" property is -1 no pixbufs will be
retrieved.</p></div><div class="refsect2" title="gtk.IconView.get_path_at_pos"><a name="method-gtkiconview--get-path-at-pos"></a><h3>gtk.IconView.get_path_at_pos</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_path_at_pos</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong> :</span></p></td><td>the x coordinate</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>the y coordinate</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the path at the specified point or
<code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_path_at_pos</code>() method returns
the model path of the icon located at the coordinates specified by
(<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>). This method returns
<code class="literal">None</code> if there is no icon at the specified
location.</p></div><div class="refsect2" title="gtk.IconView.get_item_at_pos"><a name="method-gtkiconview--get-item-at-pos"></a><h3>gtk.IconView.get_item_at_pos</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_item_at_pos</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong> :</span></p></td><td>the x coordinate</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>the y coordinate</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple comtaining the path and the cell
renderer at the specified point or <code class="literal">None</code> if the is no item
at the position.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">get_item_at_pos</code>() method returns a
2-tuple containing the model path and cell renderer of the icon located at
the coordinates specified by (<em class="parameter"><code>x</code></em>,
<em class="parameter"><code>y</code></em>). This method returns <code class="literal">None</code> if
there is no item at the specified location.</p></div><div class="refsect2" title="gtk.IconView.set_cursor"><a name="method-gtkiconview--set-cursor"></a><h3>gtk.IconView.set_cursor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_cursor</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_editing</code></strong></span><span class="initializer">=False</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>a tree path</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cell</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>
or <code class="literal">None</code></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>start_editing</code></strong> :</span></p></td><td>if <code class="literal">True</code> the specified cell
should start being edited</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">set_cursor</code>() method sets the
current keyboard focus to be at the location specified by
<em class="parameter"><code>path</code></em>, and selects it. This is useful when you want to
focus the user's attention on a particular item. If
<em class="parameter"><code>cell</code></em> is not <code class="literal">None</code>, then focus is
given to the specified cell. Additionally, if
<em class="parameter"><code>start_editing</code></em> is <code class="literal">True</code>, then
editing should be started in the specified cell.</p><p>This method is often followed by <a class="link" href="class-gtkwidget.html#method-gtkwidget--grab-focus" title="gtk.Widget.grab_focus"><code class="methodname">gtk.Widget.grab_focus</code>()</a>
 in order to give keyboard focus to the icon view. Please note that editing
 can only happen when the icon view is realized.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>In PyGTK 2.8 <em class="parameter"><code>cell</code></em> and
   <em class="parameter"><code>start_editing</code></em> must be specified.  Also
   <em class="parameter"><code>cell</code></em> cannot be <code class="literal">None</code>.</p></div></div><div class="refsect2" title="gtk.IconView.get_cursor"><a name="method-gtkiconview--get-cursor"></a><h3>gtk.IconView.get_cursor</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_cursor</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the current cursor path
and cell renderer or <code class="literal">None</code> if the cursor isn't
set.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">get_cursor</code>() method returns a
2-tuple containing the model path and <a class="link" href="class-gtkcellrenderer.html" title="gtk.CellRenderer"><code class="classname">gtk.CellRenderer</code></a>
at the current cursor location. This method returns <code class="literal">None</code>
if the cursor is not set. If no cell renderer has focus then
<code class="literal">None</code> will be returned for the cell renderer value.</p></div><div class="refsect2" title="gtk.IconView.selected_foreach"><a name="method-gtkiconview--selected-foreach"></a><h3>gtk.IconView.selected_foreach</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">selected_foreach</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>func</code></strong> :</span></p></td><td>a callback function or
method.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>data</code></strong> :</span></p></td><td>User data to pass to
<em class="parameter"><code>func</code></em>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">selected_foreach</code>() method calls the
callback function or method specified by <em class="parameter"><code>func</code></em> for
each selected icon. The signature of <em class="parameter"><code>func</code></em> is:</p><pre class="programlisting">
  def func(<em class="parameter"><code>iconview</code></em>, <em class="parameter"><code>path</code></em>, <em class="parameter"><code>user_data</code></em>):
</pre><p>where <em class="parameter"><code>iconview</code></em> is the <a class="link" href="class-gtkiconview.html" title="gtk.IconView"><code class="classname">gtk.IconView</code></a>,
<em class="parameter"><code>path</code></em> is the tree path of the icon row and
<em class="parameter"><code>user_data</code></em> is data.</p></div><div class="refsect2" title="gtk.IconView.set_selection_mode"><a name="method-gtkiconview--set-selection-mode"></a><h3>gtk.IconView.set_selection_mode</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_selection_mode</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mode</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>mode</code></strong> :</span></p></td><td>The selection mode.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_selection_mode</code>() method sets
the "selection-mode" property to the value of
<em class="parameter"><code>mode</code></em>. <em class="parameter"><code>mode</code></em> should be one of
the <a class="xref" href="gtk-constants.html#gtk-selection-mode-constants" title="GTK Selection Mode Constants">GTK Selection Mode Constants</a>.</p></div><div class="refsect2" title="gtk.IconView.get_selection_mode"><a name="method-gtkiconview--get-selection-mode"></a><h3>gtk.IconView.get_selection_mode</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_selection_mode</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the selection mode.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_selection_mode</code>() method returns
the value of the "selection-mode" property which contains one of the <a class="xref" href="gtk-constants.html#gtk-selection-mode-constants" title="GTK Selection Mode Constants">GTK Selection Mode Constants</a>.</p></div><div class="refsect2" title="gtk.IconView.set_orientation"><a name="method-gtkiconview--set-orientation"></a><h3>gtk.IconView.set_orientation</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_orientation</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>orientation</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>orientation</code></strong> :</span></p></td><td>the relative position of the icon and
text.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_orientation</code>() method sets the
"orientation" property to the value of
<em class="parameter"><code>orientation</code></em>. <em class="parameter"><code>orientation</code></em>
should contain one of the <a class="xref" href="gtk-constants.html#gtk-orientation-constants" title="GTK Orientation Constants">GTK Orientation Constants</a>. The "orientation"
property indicates the relative positioning of the icon and text.</p></div><div class="refsect2" title="gtk.IconView.get_orientation"><a name="method-gtkiconview--get-orientation"></a><h3>gtk.IconView.get_orientation</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_orientation</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the relative position of the icon and
text.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_orientation</code>() method returns
the value of the "orientation" property that indicates the relative position
between the icon and text. See the <a class="link" href="class-gtkiconview.html#method-gtkiconview--set-orientation" title="gtk.IconView.set_orientation"><code class="methodname">set_orientation</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.IconView.set_columns"><a name="method-gtkiconview--set-columns"></a><h3>gtk.IconView.set_columns</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_columns</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>columns</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>columns</code></strong> :</span></p></td><td>the number of columns in a row.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_columns</code>() method sets the
"columns" property to the value of
<em class="parameter"><code>columns</code></em>. <em class="parameter"><code>columns</code></em> should
contain the number of columns to be displayed in each row or -1 to fit as
many columns as possible per row.</p></div><div class="refsect2" title="gtk.IconView.get_columns"><a name="method-gtkiconview--get-columns"></a><h3>gtk.IconView.get_columns</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_columns</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of columns per row or
-1.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_columns</code>() method returns the
value of the "columns" property that indicates the number of columns per
row. See the <a class="link" href="class-gtkiconview.html#method-gtkiconview--set-columns" title="gtk.IconView.set_columns"><code class="methodname">set_columns</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.IconView.set_item_width"><a name="method-gtkiconview--set-item-width"></a><h3>gtk.IconView.set_item_width</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_item_width</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item_width</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>item_width</code></strong> :</span></p></td><td>The space used to display an item or -1 to use
the width of the largest item.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_item_width</code>() method sets the
"item-width" property to the value of
<em class="parameter"><code>item_width</code></em>. <em class="parameter"><code>item_width</code></em> should
contain the maximum space (in pixels) to use to display an item in the icon
view or -1 to use the width of the largest item.</p></div><div class="refsect2" title="gtk.IconView.get_item_width"><a name="method-gtkiconview--get-item-width"></a><h3>gtk.IconView.get_item_width</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_item_width</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the space available for displaying an
item or -1.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_item_width</code>() method returns the
value of the "item-width" property that contains the space available for
displaying an item. See the <a class="link" href="class-gtkiconview.html#method-gtkiconview--set-item-width" title="gtk.IconView.set_item_width"><code class="methodname">set_item_width</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.IconView.set_spacing"><a name="method-gtkiconview--set-spacing"></a><h3>gtk.IconView.set_spacing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_spacing</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>spacing</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>spacing</code></strong> :</span></p></td><td>The space between the cells of an item in the
icon view</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_spacing</code>() method sets the
"spacing" property to the value of
<em class="parameter"><code>spacing</code></em>. <em class="parameter"><code>spacing</code></em> should
contain the space in pixels that is inserted between the cells of an item in
the icon view.</p></div><div class="refsect2" title="gtk.IconView.get_spacing"><a name="method-gtkiconview--get-spacing"></a><h3>gtk.IconView.get_spacing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_spacing</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the space in pixels that is inserted between
cells in the icon view.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_spacing</code>() method returns the
value of the "spacing" property that contains the space in pixels that is
inserted between the cells of an item in the icon view. See the <a class="link" href="class-gtkiconview.html#method-gtkiconview--set-spacing" title="gtk.IconView.set_spacing"><code class="methodname">set_spacing</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.IconView.set_row_spacing"><a name="method-gtkiconview--set-row-spacing"></a><h3>gtk.IconView.set_row_spacing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_row_spacing</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>row_spacing</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>row_spacing</code></strong> :</span></p></td><td>the space between rows in the icon
view.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_row_spacing</code>() method sets the
"row-spacing" property to the value of
<em class="parameter"><code>row_spacing</code></em>. <em class="parameter"><code>row_spacing</code></em>
should contain the space in pixels to be inserted between rows in the icon
view..</p></div><div class="refsect2" title="gtk.IconView.get_row_spacing"><a name="method-gtkiconview--get-row-spacing"></a><h3>gtk.IconView.get_row_spacing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_row_spacing</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the space between rows in the icon
view.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_row_spacing</code>() method returns
the value of the "row-spacing" property that contains the space in pixels
inserted between the rows in the icon view. See the <a class="link" href="class-gtkiconview.html#method-gtkiconview--set-row-spacing" title="gtk.IconView.set_row_spacing"><code class="methodname">set_row_spacing</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.IconView.set_column_spacing"><a name="method-gtkiconview--set-column-spacing"></a><h3>gtk.IconView.set_column_spacing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_column_spacing</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column_spacing</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>column_spacing</code></strong> :</span></p></td><td>The space inserted between columns in the icon
view</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_column_spacing</code>() method sets
the "column-spacing" property to the value of
<em class="parameter"><code>column_spacing</code></em>. <em class="parameter"><code>column_spacing</code></em>
should contain the space in pixels to be inserted between columns in the
icon view.</p></div><div class="refsect2" title="gtk.IconView.get_column_spacing"><a name="method-gtkiconview--get-column-spacing"></a><h3>gtk.IconView.get_column_spacing</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_column_spacing</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the space between columns in the icon
view.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_column_spacing</code>() method returns
the value of the "column-spacing" property that contains the space in pixels
between the columns in the icon view. See the <a class="link" href="class-gtkiconview.html#method-gtkiconview--set-column-spacing" title="gtk.IconView.set_column_spacing"><code class="methodname">set_column_spacing</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.IconView.set_margin"><a name="method-gtkiconview--set-margin"></a><h3>gtk.IconView.set_margin</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_margin</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>margin</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>margin</code></strong> :</span></p></td><td>the space inserted at the edges of the icon
view.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_margin</code>() method sets the
"margin" property to the value of
<em class="parameter"><code>margin</code></em>. <em class="parameter"><code>margin</code></em> should contain
the space in pixels to be inserted at the edges of the icon view.</p></div><div class="refsect2" title="gtk.IconView.get_margin"><a name="method-gtkiconview--get-margin"></a><h3>gtk.IconView.get_margin</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_margin</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the space inserted at the edges of the icon
view.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_margin</code>() method returns the
value of the "margin" property that continas the space in pixels inserted at
the edges of the icon view. See the <a class="link" href="class-gtkiconview.html#method-gtkiconview--set-margin" title="gtk.IconView.set_margin"><code class="methodname">set_margin</code>()</a>
method for more information.</p></div><div class="refsect2" title="gtk.IconView.select_path"><a name="method-gtkiconview--select-path"></a><h3>gtk.IconView.select_path</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">select_path</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>a path indicating the icon to be
selected</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">select_path</code> method selects the icon
with the tree path specified by <em class="parameter"><code>path</code></em>.</p></div><div class="refsect2" title="gtk.IconView.unselect_path"><a name="method-gtkiconview--unselect-path"></a><h3>gtk.IconView.unselect_path</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unselect_path</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>a path indicating the icon to be
unselected</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p> The <code class="methodname">unselect_path</code> method unselects the
icon with the tree path specified by <em class="parameter"><code>path</code></em>.</p></div><div class="refsect2" title="gtk.IconView.path_is_selected"><a name="method-gtkiconview--path-is-selected"></a><h3>gtk.IconView.path_is_selected</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">path_is_selected</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>a path of an icon.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if
<em class="parameter"><code>path</code></em> is selected.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">path_is_selected</code>() method returns
<code class="literal">True</code> if the icon with the tree path specified by
<em class="parameter"><code>path</code></em> is selected.</p></div><div class="refsect2" title="gtk.IconView.get_selected_items"><a name="method-gtkiconview--get-selected-items"></a><h3>gtk.IconView.get_selected_items</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_selected_items</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of the paths of the selected
icons.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_selected_items</code>() method returns
a list of the paths of the selected icons.</p></div><div class="refsect2" title="gtk.IconView.select_all"><a name="method-gtkiconview--select-all"></a><h3>gtk.IconView.select_all</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">select_all</span>()</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">select_all</code>() method selects all the
icons if the selection mode is set to
<code class="literal">gtk.SELECTION_MULTIPLE</code>.</p></div><div class="refsect2" title="gtk.IconView.unselect_all"><a name="method-gtkiconview--unselect-all"></a><h3>gtk.IconView.unselect_all</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unselect_all</span>()</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">unselect_all</code>() method unselects all
the icons.</p></div><div class="refsect2" title="gtk.IconView.item_activated"><a name="method-gtkiconview--item-activated"></a><h3>gtk.IconView.item_activated</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">item_activated</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>a tree path pointing to an icon
row.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">item_activated</code>() method activates
the icon pointed to by the path specified by
<em class="parameter"><code>path</code></em>.</p></div><div class="refsect2" title="gtk.IconView.scroll_to_path"><a name="method-gtkiconview--scroll-to-path"></a><h3>gtk.IconView.scroll_to_path</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">scroll_to_path</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>use_align</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>row_align</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>col_align</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>the path of the item to move
to.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>use_align</code></strong> :</span></p></td><td>if <code class="literal">True</code> use the alignment
arguments</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>row_align</code></strong> :</span></p></td><td>the vertical alignment of the item specified by
<em class="parameter"><code>path</code></em>.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>col_align</code></strong> :</span></p></td><td>The horizontal alignment of the item specified
by <em class="parameter"><code>path</code></em>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">scroll_to_path</code>() method moves the
 alignments of the icon view to the position specified by
 <em class="parameter"><code>path</code></em>. <em class="parameter"><code>row_align</code></em> determines
 where the row is placed, and <em class="parameter"><code>col_align</code></em> determines
 where column is placed. Both are expected to be between 0.0 and 1.0. 0.0
 means left/top alignment, 1.0 means right/bottom alignment, 0.5 means
 center.</p><p>If <em class="parameter"><code>use_align</code></em> is <code class="literal">False</code>,
 then the alignment arguments are ignored, and the icon view does the
 minimum amount of work to scroll the item onto the screen. This means that
 the item will be scrolled to the edge closest to its current position. If
 the item is currently visible on the screen, nothing is done.</p><p>This method only works if the model is set, and
 <em class="parameter"><code>path</code></em> is a valid row on the model. If the model
 changes before the icon view is realized, the centered path will be
 modified to reflect this change.</p></div><div class="refsect2" title="gtk.IconView.get_visible_range"><a name="method-gtkiconview--get-visible-range"></a><h3>gtk.IconView.get_visible_range</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_visible_range</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the start and end paths of
the visible region or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">get_visible_range</code>() method returns
a 2-tuple containing the start and end paths for the visible region in the
iconview. If no valid paths are available this method returns
<code class="literal">None</code>.</p></div><div class="refsect2" title="gtk.IconView.enable_model_drag_source"><a name="method-gtkiconview--enable-model-drag-source"></a><h3>gtk.IconView.enable_model_drag_source</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">enable_model_drag_source</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>start_button_mask</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>start_button_mask</code></strong> :</span></p></td><td>the mask of buttons allowed to start drag</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>targets</code></strong> :</span></p></td><td>a sequence of 3-tuples containing target
information that the drag will support</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>actions</code></strong> :</span></p></td><td>the combination of possible <a class="xref" href="gdk-constants.html#gdk-drag-action-constants" title="GDK Drag Action Constants">GDK Drag Action Constants</a> for a drag
 from the iconview</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">enable_model_drag_source</code>() method
 enables the iconview to be used as a drag source for automatic
 DND. <em class="parameter"><code>start_button_mask</code></em> specifies a combination of
 the <a class="xref" href="gdk-constants.html#gdk-modifier-constants" title="GDK Modifier Constants">GDK Modifier Constants</a> that can start the
 drag. <em class="parameter"><code>targets</code></em> is a sequence (tuple or list) of
 3-tuples each containing target information: a string representing the drag
 type, target flags (a combination of <code class="literal">gtk.TARGET_SAME_APP</code>
 and <code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an
 application assigned integer ID used for identification
 purposes. <em class="parameter"><code>actions</code></em> is a combination of the <a class="xref" href="gdk-constants.html#gdk-drag-action-constants" title="GDK Drag Action Constants">GDK Drag Action Constants</a> supported by the
 iconview.</p></div><div class="refsect2" title="gtk.IconView.enable_model_drag_dest"><a name="method-gtkiconview--enable-model-drag-dest"></a><h3>gtk.IconView.enable_model_drag_dest</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">enable_model_drag_dest</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>targets</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>actions</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>targets</code></strong> :</span></p></td><td>a sequence of 3-tuples containing target
information that the iconview will support for a drag drop</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>actions</code></strong> :</span></p></td><td>the combination of possible <a class="xref" href="gdk-constants.html#gdk-drag-action-constants" title="GDK Drag Action Constants">GDK Drag Action Constants</a> for a drag
 drop onto to the iconview</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">enable_model_drag_dest</code>() method
enables the iconview to be a destination for a drag
drop. <em class="parameter"><code>targets</code></em> is a sequence (tuple or list) of
3-tuples each containing target information: a string representing the drag
type, target flags (a combination of <code class="literal">gtk.TARGET_SAME_APP</code>
and <code class="literal">gtk.TARGET_SAME_WIDGET</code> or neither) and an application
assigned integer ID used for identification
purposes. <em class="parameter"><code>actions</code></em> is a combination of the <a class="xref" href="gdk-constants.html#gdk-drag-action-constants" title="GDK Drag Action Constants">GDK Drag Action Constants</a> supported by the
iconview.</p></div><div class="refsect2" title="gtk.IconView.unset_model_drag_source"><a name="method-gtkiconview--unset-model-drag-source"></a><h3>gtk.IconView.unset_model_drag_source</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unset_model_drag_source</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">unset_model_drag_source</code>() method
 undoes the effect of the <a class="link" href="class-gtkiconview.html#method-gtkiconview--enable-model-drag-source" title="gtk.IconView.enable_model_drag_source"><code class="methodname">enable_model_drag_source</code>()</a>
 method.</p></div><div class="refsect2" title="gtk.IconView.unset_model_drag_dest"><a name="method-gtkiconview--unset-model-drag-dest"></a><h3>gtk.IconView.unset_model_drag_dest</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">unset_model_drag_dest</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">unset_model_drag_dest</code>() method
 undoes the effect of the <a class="link" href="class-gtkiconview.html#method-gtkiconview--enable-model-drag-dest" title="gtk.IconView.enable_model_drag_dest"><code class="methodname">enable_model_drag_dest</code>()</a>
 method.</p></div><div class="refsect2" title="gtk.IconView.set_reorderable"><a name="method-gtkiconview--set-reorderable"></a><h3>gtk.IconView.set_reorderable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_reorderable</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>reorderable</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>reorderable</code></strong> :</span></p></td><td>if <code class="literal">True</code> the items are
reorderable.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">set_reorderable</code>() method sets the
"reorderable" property to the value of
<em class="parameter"><code>reorderable</code></em>. If <em class="parameter"><code>reorderable</code></em> is
<code class="literal">True</code> the user can reorder the model by dragging and
dropping rows. The developer can listen to these changes by connecting to
the model's "row_inserted" and "row_deleted" signals.</p><p>This method 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.</p></div><div class="refsect2" title="gtk.IconView.get_reorderable"><a name="method-gtkiconview--get-reorderable"></a><h3>gtk.IconView.get_reorderable</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_reorderable</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the iconview list
can be reordered.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">get_reorderable</code>() method returns
the value of the "reorderable" property. If "reorderable" is
<code class="literal">True</code> the user can reorder iconview using
drag-and-drop.</p></div><div class="refsect2" title="gtk.IconView.set_drag_dest_item"><a name="method-gtkiconview--set-drag-dest-item"></a><h3>gtk.IconView.set_drag_dest_item</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_drag_dest_item</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>pos</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>the path of the item to highlight, or
<code class="literal">None</code> .</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>pos</code></strong> :</span></p></td><td>specifies where to drop, relative to the
item</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">set_drag_dest_item</code>() method
highlights for feedback the item specified by
<em class="parameter"><code>path</code></em>. <code class="literal">pos</code> is one of the <a class="xref" href="gtk-constants.html#gtk-iconview-drop-position-constants" title="GTK IconView Drop Position Constants">GTK IconView Drop Position Constants</a> that specifies
where the drop is to take place relative to the receiving item.</p><p>In PyGTK 2.10 and above, <em class="parameter"><code>path</code></em> may be
<code class="literal">None</code>.</p></div><div class="refsect2" title="gtk.IconView.get_drag_dest_item"><a name="method-gtkiconview--get-drag-dest-item"></a><h3>gtk.IconView.get_drag_dest_item</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_drag_dest_item</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the path of the highlighted
item and one of the <a class="xref" href="gtk-constants.html#gtk-iconview-drop-position-constants" title="GTK IconView Drop Position Constants">GTK IconView Drop Position Constants</a> specifying the
relative drop location or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">get_drag_dest_item</code>() method returns
a 2-tuple containing the path of the highlighted item and one of the <a class="xref" href="gtk-constants.html#gtk-iconview-drop-position-constants" title="GTK IconView Drop Position Constants">GTK IconView Drop Position Constants</a> specifying the
drop location relative to the receiving item. If there is no highlighted
item, this method returns <code class="literal">None</code>.</p></div><div class="refsect2" title="gtk.IconView.get_dest_item_at_pos"><a name="method-gtkiconview--get-dest-item-at-pos"></a><h3>gtk.IconView.get_dest_item_at_pos</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_dest_item_at_pos</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>drag_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>drag_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>drag_x</code></strong> :</span></p></td><td>the X position</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>drag_y</code></strong> :</span></p></td><td>the Y position</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a 2-tuple containing the path of the highlighted
item and a relative drop location.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">get_dest_item_at_pos</code>() method
returns a 2-tuple containing the path of the highlighted item at the
location specified by <em class="parameter"><code>drag_x</code></em> and
<em class="parameter"><code>drag_y</code></em> and the drop location relative to the
receiving item. If there is no highlighted item, this method returns
<code class="literal">None</code>.</p></div><div class="refsect2" title="gtk.IconView.create_drag_icon"><a name="method-gtkiconview--create-drag-icon"></a><h3>gtk.IconView.create_drag_icon</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">create_drag_icon</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>a path</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gdkpixmap.html" title="gtk.gdk.Pixmap"><code class="classname">gtk.gdk.Pixmap</code></a> of the
drag icon.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.8 and above.</p></div><p>The <code class="methodname">create_drag_icon</code>() method returns a
<a class="link" href="class-gdkpixmap.html" title="gtk.gdk.Pixmap"><code class="classname">gtk.gdk.Pixmap</code></a>
representation of the item at the location specified by
<em class="parameter"><code>path</code></em>. The return image can be used for a drag
icon.</p></div><div class="refsect2" title="gtk.IconView.convert_widget_to_bin_window_coords"><a name="method-gtkiconview--convert-widget-to-bin-window-coords"></a><h3>gtk.IconView.convert_widget_to_bin_window_coords</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">convert_widget_to_bin_window_coords</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget_y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>widget_x</code></strong> :</span></p></td><td>X coordinate relative to the widget.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>widget_y</code></strong> :</span></p></td><td>Y coordinate relative to the widget.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A tuple containing the bin_window X and Y coordinates.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            Converts widget coordinates to coordinates for the bin_window, as expected by e.g.
            <code class="methodname"><a class="link" href="class-gtkiconview.html#method-gtkiconview--get-path-at-pos" title="gtk.IconView.get_path_at_pos">get_path_at_pos</a></code>.
        </p></div><div class="refsect2" title="gtk.IconView.set_tooltip_cell"><a name="method-gtkiconview--set-tooltip-cell"></a><h3>gtk.IconView.set_tooltip_cell</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_tooltip_cell</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tooltip</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>cell</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>tooltip</code></strong> :</span></p></td><td>A tooltip.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>A path.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>cell</code></strong> :</span></p></td><td>A cell renderer or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">set_tooltip_cell</code>() method sets the tip area of
            <em class="parameter"><code>tooltip</code></em> to the area which <em class="parameter"><code>cell</code></em>
            occupies in the item pointed to by <em class="parameter"><code>path</code></em>.
            See also <code class="methodname"><PYGTKDOCLINK HREF="method-gtktooltip--set-tip-area">gtk.Tooltip.set_tip_area</PYGTKDOCLINK></code>().
        </p></div><div class="refsect2" title="gtk.IconView.set_tooltip_column"><a name="method-gtkiconview--set-tooltip-column"></a><h3>gtk.IconView.set_tooltip_column</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_tooltip_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>column</code></strong> :</span></p></td><td>An integer, which is a valid column number
                for icon_view's model</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            If you only plan to have simple (text-only) tooltips on full items,
            you can use this function to have GtkIconView handle these automatically
            for you. column should be set to the column in icon_view's model containing
            the tooltip texts, or -1 to disable this feature.
        </p><p>
            When enabled, GtkWidget::has-tooltip will be set to <code class="literal">True</code>
            and icon_view will connect a GtkWidget::query-tooltip signal handler.
        </p></div><div class="refsect2" title="gtk.IconView.get_tooltip_column"><a name="method-gtkiconview--get-tooltip-column"></a><h3>gtk.IconView.get_tooltip_column</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_tooltip_column</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The index of the tooltip column that is currently being used,
                or -1 if this is disabled.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">get_tooltip_column</code>() method returns the column of
            icon_view's model which is being used for displaying tooltips on icon_view's rows.
        </p></div><div class="refsect2" title="gtk.IconView.set_tooltip_item"><a name="method-gtkiconview--set-tooltip-item"></a><h3>gtk.IconView.set_tooltip_item</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_tooltip_cell</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>tooltip</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>tooltip</code></strong> :</span></p></td><td>A tooltip.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>A path.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.12 and above.</p></div><p>
            The <code class="methodname">set_tooltip_item</code>() method sets the tip area of
            <em class="parameter"><code>tooltip</code></em> to be the area covered by the item at
            <em class="parameter"><code>path</code></em>. See also
            <code class="methodname"><PYGTKDOCLINK HREF="method-gtktooltip--set-tip-area">gtk.Tooltip.set_tip_area</PYGTKDOCLINK></code>().
        </p></div><div class="refsect2" title="gtk.IconView.get_item_row"><a name="method-gtkiconview--get-item-row"></a><h3>gtk.IconView.get_item_row</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_item_row</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>The path of the item.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The row in which the item is displayed.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_item_row</code>() method gets the row in which the
      item path is currently displayed. Row numbers start at 0.</p></div><div class="refsect2" title="gtk.IconView.get_item_column"><a name="method-gtkiconview--get-item-column"></a><h3>gtk.IconView.get_item_column</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_item_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>path</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>path</code></strong> :</span></p></td><td>The path of the item.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The column in which the item is displayed.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_item_column</code>() method gets the column in which the
      item path is currently displayed. Column numbers start at 0.</p></div><div class="refsect2" title="gtk.IconView.set_item_orientation"><a name="method-gtkiconview--set-item-orientation"></a><h3>gtk.IconView.set_item_orientation</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_item_orientation</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>orientation</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>orientation</code></strong> :</span></p></td><td>The relative position of texts and icons.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_item_orientation</code>() method sets the "item-orientation"
      property which determines whether the labels are drawn beside the icons instead of below.</p></div><div class="refsect2" title="gtk.IconView.get_item_orientation"><a name="method-gtkiconview--get-item-orientation"></a><h3>gtk.IconView.get_item_orientation</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_item_orientation</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The relative position of texts and icons.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_item_orientation</code>() method returns the value of the
      "item-orientation" property which determines whether the labels are drawn beside the icons
      instead of below.</p></div><div class="refsect2" title="gtk.IconView.set_item_padding"><a name="method-gtkiconview--set-item-padding"></a><h3>gtk.IconView.set_item_padding</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_item_padding</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item_padding</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>item_padding</code></strong> :</span></p></td><td>The item padding.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">set_item_padding</code>() method sets the "item-padding"
      property which specifies the padding around each of the icon view's items.</p></div><div class="refsect2" title="gtk.IconView.get_item_padding"><a name="method-gtkiconview--get-item-padding"></a><h3>gtk.IconView.get_item_padding</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_item_padding</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The padding around items.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.22 and above.</p></div><p>The <code class="methodname">get_item_padding</code>() method returns the value of
      the "item-padding" property.</p></div></div><div class="refsect1" title="Signals"><a name="id3750905"></a><h2>Signals</h2><div class="refsect2" title='The "activate-cursor-item" gtk.IconView Signal'><a name="signal-gtkiconview--activate-cursor-item"></a><h3>The "activate-cursor-item" gtk.IconView Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iconview</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal
was handled.</td></tr></tbody></table><p>The "activate-cursor-item" signal is emitted when an icon is
selected and the <span class="keycap"><strong>Enter</strong></span> key is pressed.</p></div><div class="refsect2" title='The "item-activated" gtk.IconView Signal'><a name="signal-gtkiconview--item-activated"></a><h3>The "item-activated" gtk.IconView Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iconview</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td><td>the path to the activated icon
item.</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "item-activated" signal is emitted when an icon item is
activated by the user double clicking an icon item, pressing the
<span class="keycap"><strong>Enter</strong></span> key when an icon item is selected or via a call to
the <a class="link" href="class-gtkiconview.html#method-gtkiconview--item-activated" title="gtk.IconView.item_activated"><code class="methodname">item_activated</code>()</a>
method.</p></div><div class="refsect2" title='The "move-cursor" gtk.IconView Signal'><a name="signal-gtkiconview--move-cursor"></a><h3>The "move-cursor" gtk.IconView Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>step</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>number</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iconview</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>step</code></em> :</span></p></td><td>the step size to move the cursor</td></tr><tr><td><p><span class="term"><em class="parameter"><code>number</code></em> :</span></p></td><td>the number of steps to move</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the signal
was handled.</td></tr></tbody></table><p>The "move-cursor" signal is emitted when the cursor is moved
using the keyboard keys: <span class="keycap"><strong>Up</strong></span>, <span class="keycap"><strong>Down</strong></span>,
<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>p</strong></span>,
<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>n</strong></span>,
<span class="keycap"><strong>Home</strong></span>, <span class="keycap"><strong>End</strong></span>, <span class="keycap"><strong>Page_Up</strong></span>,
<span class="keycap"><strong>Page_Down</strong></span>, <span class="keycap"><strong>Right</strong></span>, <span class="keycap"><strong>Left</strong></span>
with various <span class="keycap"><strong>Shift</strong></span> and <span class="keycap"><strong>Control</strong></span>
combinations. <em class="parameter"><code>step</code></em> will be one of the <a class="xref" href="gtk-constants.html#gtk-movement-step-constants" title="GTK Movement Step Constants">GTK Movement Step Constants</a>.</p></div><div class="refsect2" title='The "select-all" gtk.IconView Signal'><a name="signal-gtkiconview--select-all"></a><h3>The "select-all" gtk.IconView Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iconview</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "select-all" signal is emitted when all icon items are
selected by pressing <span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>a</strong></span>.</p></div><div class="refsect2" title='The "select-cursor-item" gtk.IconView Signal'><a name="signal-gtkiconview--select-cursor-item"></a><h3>The "select-cursor-item" gtk.IconView Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iconview</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "select-cursor-item" signal is emitted when the icon item
at the cursor is selected by the user pressing the <span class="keycap"><strong>Space</strong></span>
key.</p></div><div class="refsect2" title='The "selection-changed" gtk.IconView Signal'><a name="signal-gtkiconview--selection-changed"></a><h3>The "selection-changed" gtk.IconView Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iconview</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "selection-changed" signal is emitted when the selection is
changed either by user action or program method calls.</p></div><div class="refsect2" title='The "set-scroll-adjustments" gtk.IconView Signal'><a name="signal-gtkiconview--set-scroll-adjustments"></a><h3>The "set-scroll-adjustments" gtk.IconView Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>hadj</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>vadj</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iconview</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>hadj</code></em> :</span></p></td><td>the new horizontal <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>vadj</code></em> :</span></p></td><td>the new vertical <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a></td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "set-scroll-adjustments" signal is emitted when the new
horizontal and veritcal scroll <a class="link" href="class-gtkadjustment.html" title="gtk.Adjustment"><code class="classname">gtk.Adjustment</code></a>
objects are set.</p></div><div class="refsect2" title='The "toggle-cursor-item" gtk.IconView Signal'><a name="signal-gtkiconview--toggle-cursor-item"></a><h3>The "toggle-cursor-item" gtk.IconView Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iconview</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "toggle-cursor-item" signal is emitted when the user presses
<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>Space</strong></span>.</p></div><div class="refsect2" title='The "unselect-all" gtk.IconView Signal'><a name="signal-gtkiconview--unselect-all"></a><h3>The "unselect-all" gtk.IconView Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>iconview</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>iconview</code></em> :</span></p></td><td>the widget that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "unselect-all" signal is emitted when the user presses
<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>a</strong></span>.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtkicontheme.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gtkimage.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.IconTheme </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.Image</td></tr></table></div></body></html>
python-gtk2-doc 2.24.0-4 / usr / share / gtk-doc / html / pygtk / class-gtkiconview.html
