1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>gtk.IconView</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><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="previous" 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" lang="en"><a name="class-gtkiconview"></a><div class="titlepage"><div></div><div></div></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" lang="en"><a name="id3439122"></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 href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a href="class-gtkiconview.html#constructor-gtkiconview" title="Constructor">gtk.IconView</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>model</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkiconview.html#method-gtkiconview--set-model" title="gtk.IconView.set_model">set_model</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>model</tt></b></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>column</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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"><b class="parameter"><tt>x</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>y</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkiconview.html#method-gtkiconview--selected-foreach" title="gtk.IconView.selected_foreach">selected_foreach</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>func</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>data</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>mode</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 href="class-gtkiconview.html#method-gtkiconview--set-orientation" title="gtk.IconView.set_orientation">set_orientation</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>orientation</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 href="class-gtkiconview.html#method-gtkiconview--select-path" title="gtk.IconView.select_path">select_path</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkiconview.html#method-gtkiconview--unselect-path" title="gtk.IconView.unselect_path">unselect_path</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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"><b class="parameter"><tt>path</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a 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 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 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 href="class-gtkiconview.html#method-gtkiconview--item-activated" title="gtk.IconView.item_activated">item_activated</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code><br></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3439515"></a><h2>Ancestry</h2><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="synopsis">+-- <a href="class-gobject.html" title="gobject.GObject">gobject.GObject</a>
+-- <a href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
+-- <a href="class-gtkiconview.html" title="gtk.IconView">gtk.IconView</a></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3439550"></a><h2>Properties</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col><col><col></colgroup><tbody><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: >= -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 href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></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:
<tt class="literal">gtk.ORIENTATION_VERTICAL</tt>. 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: >= -1. Default value: -1. 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
<tt class="literal">gtk.SELECTION_MULTIPLE</tt>, rubberband selection is enabled,
for the other modes, only keyboard selection is possible. Default value:
<tt class="literal">gtk.SELECTION_SINGLE</tt>. 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: >= -1. Default value:
-1. Available in GTK+ 2.6 and above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="id3439719"></a><h2>Style Properties</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col><col><col></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" lang="en"><a name="id3439797"></a><h2>Signal Prototypes</h2><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term">"<a href="class-gtkiconview.html#signal-gtkiconview--activate-cursor-item" title='The "activate-cursor-item" gtk.IconView Signal'>activate-cursor-item</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkiconview.html#signal-gtkiconview--item-activated" title='The "item-activated" gtk.IconView Signal'>item-activated</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkiconview.html#signal-gtkiconview--move-cursor" title='The "move-cursor" gtk.IconView Signal'>move-cursor</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>step</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>number</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkiconview.html#signal-gtkiconview--select-all" title='The "select-all" gtk.IconView Signal'>select-all</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkiconview.html#signal-gtkiconview--select-cursor-item" title='The "select-cursor-item" gtk.IconView Signal'>select-cursor-item</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkiconview.html#signal-gtkiconview--selection-changed" title='The "selection-changed" gtk.IconView Signal'>selection-changed</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkiconview.html#signal-gtkiconview--set-scroll-adjustments" title='The "set-scroll-adjustments" gtk.IconView Signal'>set-scroll-adjustments</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>hadj</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>vadj</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkiconview.html#signal-gtkiconview--toggle-cursor-item" title='The "toggle-cursor-item" gtk.IconView Signal'>toggle-cursor-item</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkiconview.html#signal-gtkiconview--unselect-all" title='The "unselect-all" gtk.IconView Signal'>unselect-all</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" lang="en"><a name="id3440142"></a><h2>Description</h2><div class="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 href="class-gtkiconview.html" title="gtk.IconView"><tt class="classname">gtk.IconView</tt></a>
widget provides an alternative view of a <a href="class-gtkliststore.html" title="gtk.ListStore"><tt class="classname">gtk.ListStore</tt></a>
model. It displays the model as a grid of icons with labels. Like <a href="class-gtktreeview.html" title="gtk.TreeView"><tt class="classname">gtk.TreeView</tt></a>, you
can select one or multiple items (depending on the selection mode, see the
<a href="class-gtkiconview.html#method-gtkiconview--set-selection-mode" title="gtk.IconView.set_selection_mode"><tt class="methodname">set_selection_mode</tt>()</a>
method for more information). In addition to selection with the arrow keys,
<a href="class-gtkiconview.html" title="gtk.IconView"><tt class="classname">gtk.IconView</tt></a>
supports rubberband selection, which is controlled by dragging the
pointer.</p></div><div class="refsect1" lang="en"><a name="constructor-gtkiconview"></a><h2>Constructor</h2><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.IconView</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>model</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>model</tt></b>:</span></td><td>A <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a>, or
<tt class="literal">None</tt></td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a new <a href="class-gtkiconview.html" title="gtk.IconView"><tt class="classname">gtk.IconView</tt></a>
widget.</td></tr></tbody></table><div class="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 href="class-gtkiconview.html" title="gtk.IconView"><tt class="classname">gtk.IconView</tt></a>
widget. If <i class="parameter"><tt>model</tt></i> is specified and not
<tt class="literal">None</tt> it should specify a <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a> to
be used as the model.</p></div><div class="refsect1" lang="en"><a name="id3440299"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-gtkiconview--set-model"></a><h3>gtk.IconView.set_model</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_model</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>model</tt></b></span><span class="initializer">=None</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>model</tt></b>:</span></td><td>a <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a>
or <tt class="literal">None</tt></td></tr></tbody></table><div class="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 <tt class="methodname">set_model</tt>() method sets the "model"
property to the <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a>
specified by <i class="parameter"><tt>model</tt></i>. If <i class="parameter"><tt>model</tt></i>
is <tt class="literal">None</tt> the old model will be unset.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--get-model"></a><h3>gtk.IconView.get_model</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_model</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>The <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a>
used by the cell view or <tt class="literal">None</tt>.</td></tr></tbody></table><div class="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 <tt class="methodname">get_model</tt>() method returns the
value of the "model" property which contains the <a href="class-gtktreemodel.html" title="gtk.TreeModel"><tt class="classname">gtk.TreeModel</tt></a>
used by the cell view. If no model is being used this method returns
<tt class="literal">None</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--set-text-column"></a><h3>gtk.IconView.set_text_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_text_column</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>The index of a column in the
model or -1 to unset the column</td></tr></tbody></table><div class="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 <tt class="methodname">set_text_column</tt>() method sets the
"text-column" property to the value of <i class="parameter"><tt>column</tt></i> which
should be the index of a column in the model containing strings to be used
for text. If <i class="parameter"><tt>column</tt></i> is -1 the text column is
unset.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--get-text-column"></a><h3>gtk.IconView.get_text_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_text_column</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>The index of a model's column or -1 if
unset.</td></tr></tbody></table><div class="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 <tt class="methodname">get_text_column</tt>() 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" lang="en"><a name="method-gtkiconview--set-markup-column"></a><h3>gtk.IconView.set_markup_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_markup_column</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>The index of a column in the model or -1.</td></tr></tbody></table><div class="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 <tt class="methodname">set_markup_column</tt>() method sets the
"markup-column" property to the value specified by
<i class="parameter"><tt>column</tt></i>. The "markup-column" property indicates the
index of a column in the model to be used for markup information. If
<i class="parameter"><tt>column</tt></i> is -1 the markup column will be unset. If the
markup column is set, it overrides the text column set by the <a href="class-gtkiconview.html#method-gtkiconview--set-text-column" title="gtk.IconView.set_text_column"><tt class="methodname">set_text_column</tt>()</a>
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--get-markup-column"></a><h3>gtk.IconView.get_markup_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_markup_column</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the index of the model column containing markup
or -1.</td></tr></tbody></table><div class="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 <tt class="methodname">get_markup_column</tt> 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" lang="en"><a name="method-gtkiconview--set-pixbuf-column"></a><h3>gtk.IconView.set_pixbuf_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_pixbuf_column</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>column</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>column</tt></b>:</span></td><td>the index of a model column or
-1</td></tr></tbody></table><div class="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 <tt class="methodname">set_pixbuf_column</tt>() method sets the
"pixbuf-column" property to the value of <i class="parameter"><tt>column</tt></i>. If
column >= 0 the icon view <a href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><tt class="classname">gtk.gdk.Pixbuf</tt></a>
objects will be retrieved from the specified column. If
<i class="parameter"><tt>column</tt></i> is -1 then no pixbufs will be used,</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--get-pixbuf-column"></a><h3>gtk.IconView.get_pixbuf_column</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_pixbuf_column</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>The index of a column in the model or
-1</td></tr></tbody></table><div class="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 <tt class="methodname">get_pixbuf_column</tt>() returns the
value of the "pixbuf-column" property which contains the index of the model
column use to to retrieve <a href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><tt class="classname">gtk.gdk.Pixbuf</tt></a>
objects to display. If the "pixbuf-column" property is -1 no pixbufs will be
retrieved.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--get-path-at-pos"></a><h3>gtk.IconView.get_path_at_pos</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_path_at_pos</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>x</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>y</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>x</tt></b>:</span></td><td>the x coordinate</td></tr><tr><td><span class="term"><b class="parameter"><tt>y</tt></b>:</span></td><td>the y coordinate</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the path at the specified point or
<tt class="literal">None</tt>.</td></tr></tbody></table><div class="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 <tt class="methodname">get_path_at_pos</tt>() method returns
the model path of the icon located at the coordinates specified by
(<i class="parameter"><tt>x</tt></i>, <i class="parameter"><tt>y</tt></i>). This method return
None if there is no icon at the specified location.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--selected-foreach"></a><h3>gtk.IconView.selected_foreach</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">selected_foreach</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>func</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>data</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>func</tt></b>:</span></td><td>a callback function or
method.</td></tr><tr><td><span class="term"><b class="parameter"><tt>data</tt></b>:</span></td><td>User data to pass to
<i class="parameter"><tt>func</tt></i>.</td></tr></tbody></table><div class="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 <tt class="methodname">selected_foreach</tt>() method calls the
callback function or method specified by <i class="parameter"><tt>func</tt></i> for
each selected icon. The signature of <i class="parameter"><tt>func</tt></i> is:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting">
def func(<i class="parameter"><tt>iconview</tt></i>, <i class="parameter"><tt>path</tt></i>, <i class="parameter"><tt>user_data</tt></i>):
</pre></td></tr></table><p>where <i class="parameter"><tt>iconview</tt></i> is the <a href="class-gtkiconview.html" title="gtk.IconView"><tt class="classname">gtk.IconView</tt></a>,
<i class="parameter"><tt>path</tt></i> is the tree path of the icon row and
<i class="parameter"><tt>user_data</tt></i> is data.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--set-selection-mode"></a><h3>gtk.IconView.set_selection_mode</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_selection_mode</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>mode</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>mode</tt></b>:</span></td><td>The selection mode.</td></tr></tbody></table><div class="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 <tt class="methodname">set_selection_mode</tt>() method sets
the "selection-mode" property to the value of
<i class="parameter"><tt>mode</tt></i>. <i class="parameter"><tt>mode</tt></i> should be one of
the <a href="gtk-constants.html#gtk-selection-mode-constants">GTK Selection Mode Constants</a>.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--get-selection-mode"></a><h3>gtk.IconView.get_selection_mode</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_selection_mode</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the selection mode.</td></tr></tbody></table><div class="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 <tt class="methodname">get_selection_mode</tt>() method returns
the value of the "selection-mode" property which contains one of the <a href="gtk-constants.html#gtk-selection-mode-constants">GTK Selection Mode Constants</a>.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--set-orientation"></a><h3>gtk.IconView.set_orientation</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_orientation</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>orientation</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>orientation</tt></b>:</span></td><td>the relative position of the icon and
text.</td></tr></tbody></table><div class="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 <tt class="methodname">set_orientation</tt>() method sets the
"orientation" property to the value of
<i class="parameter"><tt>orientation</tt></i>. <i class="parameter"><tt>orientation</tt></i>
should contain one of the <a href="gtk-constants.html#gtk-orientation-constants">GTK Orientation Constants</a>. The "orientation"
property indicates the relative positioning of the icon and text.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--get-orientation"></a><h3>gtk.IconView.get_orientation</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_orientation</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt></tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt></tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the relative position of the icon and
text.</td></tr></tbody></table><div class="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 <tt class="methodname">get_orientation</tt>() method returns
the value of the "orientation" property that indicates the relative position
between the icon and text. See the <a href="class-gtkiconview.html#method-gtkiconview--set-orientation" title="gtk.IconView.set_orientation"><tt class="methodname">set_orientation</tt>()</a>
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--select-path"></a><h3>gtk.IconView.select_path</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">select_path</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>a path indicating the icon to be
selected</td></tr></tbody></table><div class="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 <tt class="methodname">select_path</tt> method selects the icon
with the tree path specified by <i class="parameter"><tt>path</tt></i>.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--unselect-path"></a><h3>gtk.IconView.unselect_path</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unselect_path</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>a path indicating the icon to be
unselected</td></tr></tbody></table><div class="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 <tt class="methodname">unselect_path</tt> method unselects the
icon with the tree path specified by <i class="parameter"><tt>path</tt></i>.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--path-is-selected"></a><h3>gtk.IconView.path_is_selected</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">path_is_selected</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>a path of an icon.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if
<i class="parameter"><tt>path</tt></i> is selected.</td></tr></tbody></table><div class="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 <tt class="methodname">path_is_selected</tt>() method returns
<tt class="literal">TRUE</tt> if the icon with the tree path specified by
<i class="parameter"><tt>path</tt></i> is selected.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--get-selected-items"></a><h3>gtk.IconView.get_selected_items</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_selected_items</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a list of the paths of the selected
icons.</td></tr></tbody></table><div class="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 <tt class="methodname">get_selected_items</tt>() method returns
a list of the paths of the selected icons.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--select-all"></a><h3>gtk.IconView.select_all</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">select_all</span>()</code></pre></td></tr></table><div class="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 <tt class="methodname">select_all</tt>() method selects all the
icons if the selection mode is set to
<tt class="literal">gtk.SELECTION_MULTIPLE</tt>.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--unselect-all"></a><h3>gtk.IconView.unselect_all</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unselect_all</span>()</code></pre></td></tr></table><div class="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 <tt class="methodname">unselect_all</tt>() method unselects all
the icons.</p></div><div class="refsect2" lang="en"><a name="method-gtkiconview--item-activated"></a><h3>gtk.IconView.item_activated</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">item_activated</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>path</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>path</tt></b>:</span></td><td>a tree path pointing to an icon
row.</td></tr></tbody></table><div class="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 <tt class="methodname">item_activated</tt>() method activates
the icon pointed to by the path specified by
<i class="parameter"><tt>path</tt></i>.</p></div></div><div class="refsect1" lang="en"><a name="id3441695"></a><h2>Signals</h2><div class="refsect2" lang="en"><a name="signal-gtkiconview--activate-cursor-item"></a><h3>The "activate-cursor-item" gtk.IconView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>iconview</tt></i>:</span></td><td>the widget that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> 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><b class="keycap">Enter</b></span> key is pressed.</p></div><div class="refsect2" lang="en"><a name="signal-gtkiconview--item-activated"></a><h3>The "item-activated" gtk.IconView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>path</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>iconview</tt></i>:</span></td><td>the widget that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>path</tt></i>:</span></td><td>the path to the activated icon
item.</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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><b class="keycap">Enter</b></span> key when an icon item is selected or via a call to
the <a href="class-gtkiconview.html#method-gtkiconview--item-activated" title="gtk.IconView.item_activated"><tt class="methodname">item_activated</tt>()</a>
method.</p></div><div class="refsect2" lang="en"><a name="signal-gtkiconview--move-cursor"></a><h3>The "move-cursor" gtk.IconView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>step</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>number</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>iconview</tt></i>:</span></td><td>the widget that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>step</tt></i>:</span></td><td>the step size to move the cursor</td></tr><tr><td><span class="term"><i class="parameter"><tt>number</tt></i>:</span></td><td>the number of steps to move</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> 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><b class="keycap">Up</b></span>, <span><b class="keycap">Down</b></span>,
<span><b class="keycap">Control</b></span>-<span><b class="keycap">p</b></span>,
<span><b class="keycap">Control</b></span>-<span><b class="keycap">n</b></span>,
<span><b class="keycap">Home</b></span>, <span><b class="keycap">End</b></span>, <span><b class="keycap">Page_Up</b></span>,
<span><b class="keycap">Page_Down</b></span>, <span><b class="keycap">Right</b></span>, <span><b class="keycap">Left</b></span>
with various <span><b class="keycap">Shift</b></span> and <span><b class="keycap">Control</b></span>
combinations. <i class="parameter"><tt>step</tt></i> will be one of the <a href="gtk-constants.html#gtk-movement-step-constants">GTK Movement Step Constants</a>.</p></div><div class="refsect2" lang="en"><a name="signal-gtkiconview--select-all"></a><h3>The "select-all" gtk.IconView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>iconview</tt></i>:</span></td><td>the widget that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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><b class="keycap">Control</b></span>-<span><b class="keycap">a</b></span>.</p></div><div class="refsect2" lang="en"><a name="signal-gtkiconview--select-cursor-item"></a><h3>The "select-cursor-item" gtk.IconView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>iconview</tt></i>:</span></td><td>the widget that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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><b class="keycap">Space</b></span>
key.</p></div><div class="refsect2" lang="en"><a name="signal-gtkiconview--selection-changed"></a><h3>The "selection-changed" gtk.IconView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>iconview</tt></i>:</span></td><td>the widget that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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" lang="en"><a name="signal-gtkiconview--set-scroll-adjustments"></a><h3>The "set-scroll-adjustments" gtk.IconView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>hadj</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>vadj</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>iconview</tt></i>:</span></td><td>the widget that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>hadj</tt></i>:</span></td><td>the new horizontal <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a></td></tr><tr><td><span class="term"><i class="parameter"><tt>vadj</tt></i>:</span></td><td>the new vertical <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a></td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></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 href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
objects are set.</p></div><div class="refsect2" lang="en"><a name="signal-gtkiconview--toggle-cursor-item"></a><h3>The "toggle-cursor-item" gtk.IconView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>iconview</tt></i>:</span></td><td>the widget that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "toggle-cursor-item" signal is emitted when the user presses
<span><b class="keycap">Control</b></span>-<span><b class="keycap">Space</b></span>.</p></div><div class="refsect2" lang="en"><a name="signal-gtkiconview--unselect-all"></a><h3>The "unselect-all" gtk.IconView Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>iconview</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>iconview</tt></i>:</span></td><td>the widget that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "unselect-all" signal is emitted when the user presses
<span><b class="keycap">Control</b></span>-<span><b class="keycap">Shift</b></span>-<span><b class="keycap">a</b></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>
|
