64
65
<th width="100%" align="center">GTK+ Reference Manual</th>
65
66
<td><a accesskey="n" href="GtkTreeSortable.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3237562" class="shortcut">Top</a>
69
<a href="#id3239697" class="shortcut">Description</a>
71
<a href="#id3239206" class="shortcut">Object Hierarchy</a>
73
<a href="#id3239261" class="shortcut">Implemented Interfaces</a>
75
<a href="#id3239291" class="shortcut">Properties</a>
77
<a href="#id3239532" class="shortcut">Style Properties</a>
79
<a href="#id3239583" class="shortcut">Signals</a></nobr></td></tr>
68
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3315445" class="shortcut">Top</a>
70
<a href="#id3317553" class="shortcut">Description</a>
72
<a href="#id3317089" class="shortcut">Object Hierarchy</a>
74
<a href="#id3317143" class="shortcut">Implemented Interfaces</a>
76
<a href="#id3317173" class="shortcut">Properties</a>
78
<a href="#id3317398" class="shortcut">Style Properties</a>
80
<a href="#id3317448" class="shortcut">Signals</a></nobr></td></tr>
81
82
<div class="refentry" lang="en">
82
83
<a name="GtkIconView"></a><div class="titlepage"></div>
83
84
<div class="refnamediv"><table width="100%"><tr>
86
<a name="id3237562"></a><span class="refentrytitle">GtkIconView</span>
87
<a name="id3315445"></a><span class="refentrytitle">GtkIconView</span>
88
89
<p>GtkIconView — A widget which displays a list of icons in a grid</p>
234
235
<div class="refsect1" lang="en">
235
<a name="id3239261"></a><h2>Implemented Interfaces</h2>
236
<a name="id3317143"></a><h2>Implemented Interfaces</h2>
237
238
GtkIconView implements
238
239
AtkImplementorIface and <a href="GtkCellLayout.html" title="GtkCellLayout">GtkCellLayout</a>.</p>
240
241
<div class="refsect1" lang="en">
241
<a name="id3239291"></a><h2>Properties</h2>
242
<a name="id3317173"></a><h2>Properties</h2>
242
243
<pre class="synopsis">
244
"<a href="GtkIconView.html#GtkIconView--column-spacing">column-spacing</a>" gint : Read / Write
245
"<a href="GtkIconView.html#GtkIconView--columns">columns</a>" gint : Read / Write
246
"<a href="GtkIconView.html#GtkIconView--item-width">item-width</a>" gint : Read / Write
247
"<a href="GtkIconView.html#GtkIconView--margin">margin</a>" gint : Read / Write
248
"<a href="GtkIconView.html#GtkIconView--markup-column">markup-column</a>" gint : Read / Write
249
"<a href="GtkIconView.html#GtkIconView--model">model</a>" <a href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a> : Read / Write
250
"<a href="GtkIconView.html#GtkIconView--orientation">orientation</a>" <a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> : Read / Write
251
"<a href="GtkIconView.html#GtkIconView--pixbuf-column">pixbuf-column</a>" gint : Read / Write
252
"<a href="GtkIconView.html#GtkIconView--reorderable">reorderable</a>" gboolean : Read / Write
253
"<a href="GtkIconView.html#GtkIconView--row-spacing">row-spacing</a>" gint : Read / Write
254
"<a href="GtkIconView.html#GtkIconView--selection-mode">selection-mode</a>" <a href="gtk-Standard-Enumerations.html#GtkSelectionMode">GtkSelectionMode</a> : Read / Write
255
"<a href="GtkIconView.html#GtkIconView--spacing">spacing</a>" gint : Read / Write
256
"<a href="GtkIconView.html#GtkIconView--text-column">text-column</a>" gint : Read / Write
245
<a href="GtkIconView.html#GtkIconView--column-spacing">column-spacing</a> gint : Read / Write
246
<a href="GtkIconView.html#GtkIconView--columns">columns</a> gint : Read / Write
247
<a href="GtkIconView.html#GtkIconView--item-width">item-width</a> gint : Read / Write
248
<a href="GtkIconView.html#GtkIconView--margin">margin</a> gint : Read / Write
249
<a href="GtkIconView.html#GtkIconView--markup-column">markup-column</a> gint : Read / Write
250
<a href="GtkIconView.html#GtkIconView--model">model</a> <a href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a> : Read / Write
251
<a href="GtkIconView.html#GtkIconView--orientation">orientation</a> <a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> : Read / Write
252
<a href="GtkIconView.html#GtkIconView--pixbuf-column">pixbuf-column</a> gint : Read / Write
253
<a href="GtkIconView.html#GtkIconView--reorderable">reorderable</a> gboolean : Read / Write
254
<a href="GtkIconView.html#GtkIconView--row-spacing">row-spacing</a> gint : Read / Write
255
<a href="GtkIconView.html#GtkIconView--selection-mode">selection-mode</a> <a href="gtk-Standard-Enumerations.html#GtkSelectionMode">GtkSelectionMode</a> : Read / Write
256
<a href="GtkIconView.html#GtkIconView--spacing">spacing</a> gint : Read / Write
257
<a href="GtkIconView.html#GtkIconView--text-column">text-column</a> gint : Read / Write
259
260
<div class="refsect1" lang="en">
260
<a name="id3239532"></a><h2>Style Properties</h2>
261
<a name="id3317398"></a><h2>Style Properties</h2>
261
262
<pre class="synopsis">
263
"<a href="GtkIconView.html#GtkIconView--selection-box-alpha">selection-box-alpha</a>" guchar : Read
264
"<a href="GtkIconView.html#GtkIconView--selection-box-color">selection-box-color</a>" <a
264
<a href="GtkIconView.html#GtkIconView--selection-box-alpha">selection-box-alpha</a> guchar : Read
265
<a href="GtkIconView.html#GtkIconView--selection-box-color">selection-box-color</a> <a
265
266
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"
266
267
>GdkColor</a> : Read
269
270
<div class="refsect1" lang="en">
270
<a name="id3239583"></a><h2>Signals</h2>
271
<a name="id3317448"></a><h2>Signals</h2>
271
272
<pre class="synopsis">
273
"<a href="GtkIconView.html#GtkIconView-activate-cursor-item">activate-cursor-item</a>" : Run Last / Action
274
"<a href="GtkIconView.html#GtkIconView-item-activated">item-activated</a>" : Run Last
275
"<a href="GtkIconView.html#GtkIconView-move-cursor">move-cursor</a>" : Run Last / Action
276
"<a href="GtkIconView.html#GtkIconView-select-all">select-all</a>" : Run Last / Action
277
"<a href="GtkIconView.html#GtkIconView-select-cursor-item">select-cursor-item</a>" : Run Last / Action
278
"<a href="GtkIconView.html#GtkIconView-selection-changed">selection-changed</a>" : Run First
279
"<a href="GtkIconView.html#GtkIconView-set-scroll-adjustments">set-scroll-adjustments</a>" : Run Last
280
"<a href="GtkIconView.html#GtkIconView-toggle-cursor-item">toggle-cursor-item</a>" : Run Last / Action
281
"<a href="GtkIconView.html#GtkIconView-unselect-all">unselect-all</a>" : Run Last / Action
274
<a href="GtkIconView.html#GtkIconView-activate-cursor-item">activate-cursor-item</a> : Run Last / Action
275
<a href="GtkIconView.html#GtkIconView-item-activated">item-activated</a> : Run Last
276
<a href="GtkIconView.html#GtkIconView-move-cursor">move-cursor</a> : Run Last / Action
277
<a href="GtkIconView.html#GtkIconView-select-all">select-all</a> : Run Last / Action
278
<a href="GtkIconView.html#GtkIconView-select-cursor-item">select-cursor-item</a> : Run Last / Action
279
<a href="GtkIconView.html#GtkIconView-selection-changed">selection-changed</a> : Run First
280
<a href="GtkIconView.html#GtkIconView-set-scroll-adjustments">set-scroll-adjustments</a> : Run Last
281
<a href="GtkIconView.html#GtkIconView-toggle-cursor-item">toggle-cursor-item</a> : Run Last / Action
282
<a href="GtkIconView.html#GtkIconView-unselect-all">unselect-all</a> : Run Last / Action
284
285
<div class="refsect1" lang="en">
285
<a name="id3239697"></a><h2>Description</h2>
286
<a name="id3317553"></a><h2>Description</h2>
287
288
<a href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> provides an alternative view on a list model.
288
289
It displays the model as a grid of icons with labels. Like
1425
1426
<div class="refsect2" lang="en">
1426
<a name="id3243894"></a><h3>
1427
<a name="id3321751"></a><h3>
1427
1428
<a name="gtk-icon-view-path-is-selected"></a>gtk_icon_view_path_is_selected ()</h3>
1428
<a class="indexterm" name="id3243909"></a><pre class="programlisting">gboolean gtk_icon_view_path_is_selected (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *icon_view,
1429
<a class="indexterm" name="id3321766"></a><pre class="programlisting">gboolean gtk_icon_view_path_is_selected (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *icon_view,
1429
1430
<a href="GtkTreeModel.html#GtkTreePath">GtkTreePath</a> *path);</pre>
1431
1432
Returns <code class="literal">TRUE</code> if the icon pointed to by <em class="parameter"><code>path</code></em> is currently
1432
selected. If <em class="parameter"><code>icon</code></em> does not point to a valid location, <code class="literal">FALSE</code> is returned.</p>
1433
selected. If <em class="parameter"><code>path</code></em> does not point to a valid location, <code class="literal">FALSE</code> is returned.</p>
2121
2122
<div class="refsect1" lang="en">
2122
<a name="id3246592"></a><h2>Property Details</h2>
2123
<a name="id3324449"></a><h2>Property Details</h2>
2123
2124
<div class="refsect2" lang="en">
2124
<a name="id3246602"></a><h3>
2125
<a name="GtkIconView--column-spacing"></a>The "<code class="literal">column-spacing</code>" property</h3>
2126
<a class="indexterm" name="id3246619"></a><pre class="programlisting"> "column-spacing" gint : Read / Write</pre>
2125
<a name="id3324460"></a><h3>
2126
<a name="GtkIconView--column-spacing"></a>The :<code class="literal">column-spacing</code> property</h3>
2127
<a class="indexterm" name="id3324476"></a><pre class="programlisting"> column-spacing gint : Read / Write</pre>
2128
2129
The column-spacing property specifies the space which is inserted between
2129
2130
the columns of the icon view.</p>
2208
2209
<div class="refsect2" lang="en">
2209
<a name="id3246901"></a><h3>
2210
<a name="GtkIconView--model"></a>The "<code class="literal">model</code>" property</h3>
2211
<a class="indexterm" name="id3246917"></a><pre class="programlisting"> "model" <a href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a> : Read / Write</pre>
2210
<a name="id3324755"></a><h3>
2211
<a name="GtkIconView--model"></a>The :<code class="literal">model</code> property</h3>
2212
<a class="indexterm" name="id3324771"></a><pre class="programlisting"> model <a href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a> : Read / Write</pre>
2212
2213
<p>The model for the icon view.</p>
2215
2216
<div class="refsect2" lang="en">
2216
<a name="id3246942"></a><h3>
2217
<a name="GtkIconView--orientation"></a>The "<code class="literal">orientation</code>" property</h3>
2218
<a class="indexterm" name="id3246958"></a><pre class="programlisting"> "orientation" <a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> : Read / Write</pre>
2217
<a name="id3324794"></a><h3>
2218
<a name="GtkIconView--orientation"></a>The :<code class="literal">orientation</code> property</h3>
2219
<a class="indexterm" name="id3324810"></a><pre class="programlisting"> orientation <a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> : Read / Write</pre>
2220
2221
The orientation property specifies how the cells (i.e. the icon and
2221
2222
the text) of the item are positioned relative to each other.</p>
2329
2330
<div class="refsect1" lang="en">
2330
<a name="id3247361"></a><h2>Style Property Details</h2>
2331
<a name="id3325210"></a><h2>Style Property Details</h2>
2331
2332
<div class="refsect2" lang="en">
2332
<a name="id3247372"></a><h3>
2333
<a name="GtkIconView--selection-box-alpha"></a>The "<code class="literal">selection-box-alpha</code>" style property</h3>
2334
<a class="indexterm" name="id3247388"></a><pre class="programlisting"> "selection-box-alpha" guchar : Read</pre>
2333
<a name="id3325221"></a><h3>
2334
<a name="GtkIconView--selection-box-alpha"></a>The :<code class="literal">selection-box-alpha</code> style property</h3>
2335
<a class="indexterm" name="id3325237"></a><pre class="programlisting"> selection-box-alpha guchar : Read</pre>
2335
2336
<p>Opacity of the selection box.</p>
2336
2337
<p>Default value: 64</p>
2339
2340
<div class="refsect2" lang="en">
2340
<a name="id3247415"></a><h3>
2341
<a name="GtkIconView--selection-box-color"></a>The "<code class="literal">selection-box-color</code>" style property</h3>
2342
<a class="indexterm" name="id3247432"></a><pre class="programlisting"> "selection-box-color" <a
2341
<a name="id3325264"></a><h3>
2342
<a name="GtkIconView--selection-box-color"></a>The :<code class="literal">selection-box-color</code> style property</h3>
2343
<a class="indexterm" name="id3325280"></a><pre class="programlisting"> selection-box-color <a
2343
2344
href="../gdk/gdk-Colormaps-and-Colors.html#GdkColor"
2344
2345
>GdkColor</a> : Read</pre>
2345
2346
<p>Color of the selection box.</p>
2348
2349
<div class="refsect1" lang="en">
2349
<a name="id3247457"></a><h2>Signal Details</h2>
2350
<a name="id3325304"></a><h2>Signal Details</h2>
2350
2351
<div class="refsect2" lang="en">
2351
<a name="id3247467"></a><h3>
2352
<a name="GtkIconView-activate-cursor-item"></a>The "activate-cursor-item" signal</h3>
2353
<a class="indexterm" name="id3247479"></a><pre class="programlisting">gboolean user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2352
<a name="id3325314"></a><h3>
2353
<a name="GtkIconView-activate-cursor-item"></a>The <code class="literal">::activate-cursor-item</code> signal</h3>
2354
<a class="indexterm" name="id3325331"></a><pre class="programlisting">gboolean user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2354
2355
gpointer user_data) : Run Last / Action</pre>
2453
2454
<div class="refsect2" lang="en">
2454
<a name="id3247790"></a><h3>
2455
<a name="GtkIconView-select-all"></a>The "select-all" signal</h3>
2456
<a class="indexterm" name="id3247800"></a><pre class="programlisting">void user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2457
gpointer user_data) : Run Last / Action</pre>
2461
<div class="variablelist"><table border="0">
2462
<col align="left" valign="top">
2465
<td><span class="term"><em class="parameter"><code>iconview</code></em> :</span></td>
2466
<td>the object which received the signal.
2471
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2472
<td>user data set when the signal handler was connected.</td>
2478
<div class="refsect2" lang="en">
2479
<a name="id3247869"></a><h3>
2480
<a name="GtkIconView-select-cursor-item"></a>The "select-cursor-item" signal</h3>
2481
<a class="indexterm" name="id3247880"></a><pre class="programlisting">void user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2482
gpointer user_data) : Run Last / Action</pre>
2486
<div class="variablelist"><table border="0">
2487
<col align="left" valign="top">
2490
<td><span class="term"><em class="parameter"><code>iconview</code></em> :</span></td>
2491
<td>the object which received the signal.
2496
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2497
<td>user data set when the signal handler was connected.</td>
2503
<div class="refsect2" lang="en">
2504
<a name="id3247949"></a><h3>
2505
<a name="GtkIconView-selection-changed"></a>The "selection-changed" signal</h3>
2506
<a class="indexterm" name="id3247960"></a><pre class="programlisting">void user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2455
<a name="id3325654"></a><h3>
2456
<a name="GtkIconView-select-all"></a>The <code class="literal">::select-all</code> signal</h3>
2457
<a class="indexterm" name="id3325670"></a><pre class="programlisting">void user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2458
gpointer user_data) : Run Last / Action</pre>
2462
<div class="variablelist"><table border="0">
2463
<col align="left" valign="top">
2466
<td><span class="term"><em class="parameter"><code>iconview</code></em> :</span></td>
2467
<td>the object which received the signal.
2472
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2473
<td>user data set when the signal handler was connected.</td>
2479
<div class="refsect2" lang="en">
2480
<a name="id3325738"></a><h3>
2481
<a name="GtkIconView-select-cursor-item"></a>The <code class="literal">::select-cursor-item</code> signal</h3>
2482
<a class="indexterm" name="id3325755"></a><pre class="programlisting">void user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2483
gpointer user_data) : Run Last / Action</pre>
2487
<div class="variablelist"><table border="0">
2488
<col align="left" valign="top">
2491
<td><span class="term"><em class="parameter"><code>iconview</code></em> :</span></td>
2492
<td>the object which received the signal.
2497
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
2498
<td>user data set when the signal handler was connected.</td>
2504
<div class="refsect2" lang="en">
2505
<a name="id3325824"></a><h3>
2506
<a name="GtkIconView-selection-changed"></a>The <code class="literal">::selection-changed</code> signal</h3>
2507
<a class="indexterm" name="id3325840"></a><pre class="programlisting">void user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2507
2508
gpointer user_data) : Run First</pre>
2528
2529
<div class="refsect2" lang="en">
2529
<a name="id3248029"></a><h3>
2530
<a name="GtkIconView-set-scroll-adjustments"></a>The "set-scroll-adjustments" signal</h3>
2531
<a class="indexterm" name="id3248040"></a><pre class="programlisting">void user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2530
<a name="id3325909"></a><h3>
2531
<a name="GtkIconView-set-scroll-adjustments"></a>The <code class="literal">::set-scroll-adjustments</code> signal</h3>
2532
<a class="indexterm" name="id3325926"></a><pre class="programlisting">void user_function (<a href="GtkIconView.html" title="GtkIconView">GtkIconView</a> *iconview,
2532
2533
<a href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *arg1,
2533
2534
<a href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *arg2,
2534
2535
gpointer user_data) : Run Last</pre>