<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<!--ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkIconView">
<refmeta>
<refentrytitle role="top_of_page" id="GtkIconView.top_of_page">GtkIconView</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkIconView</refname>
<refpurpose>A widget which displays a list of icons in a grid</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkIconView.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtk/gtk.h&gt;

                    <link linkend="GtkIconView-struct">GtkIconView</link>;
<link linkend="void">void</link>                (<link linkend="GtkIconViewForeachFunc">*GtkIconViewForeachFunc</link>)           (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-icon-view-new">gtk_icon_view_new</link>                   (void);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-icon-view-new-with-model">gtk_icon_view_new_with_model</link>        (<link linkend="GtkTreeModel">GtkTreeModel</link> *model);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-model">gtk_icon_view_set_model</link>             (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreeModel">GtkTreeModel</link> *model);
<link linkend="GtkTreeModel">GtkTreeModel</link> *      <link linkend="gtk-icon-view-get-model">gtk_icon_view_get_model</link>             (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-text-column">gtk_icon_view_set_text_column</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-text-column">gtk_icon_view_get_text_column</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-markup-column">gtk_icon_view_set_markup_column</link>     (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-markup-column">gtk_icon_view_get_markup_column</link>     (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-pixbuf-column">gtk_icon_view_set_pixbuf_column</link>     (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-pixbuf-column">gtk_icon_view_get_pixbuf_column</link>     (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="GtkTreePath">GtkTreePath</link> *       <link linkend="gtk-icon-view-get-path-at-pos">gtk_icon_view_get_path_at_pos</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> x,
                                                         <link linkend="gint">gint</link> y);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-icon-view-get-item-at-pos">gtk_icon_view_get_item_at_pos</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> x,
                                                         <link linkend="gint">gint</link> y,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> **cell);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-convert-widget-to-bin-window-coords">gtk_icon_view_convert_widget_to_bin_window_coords</link>
                                                        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> wx,
                                                         <link linkend="gint">gint</link> wy,
                                                         <link linkend="gint">gint</link> *bx,
                                                         <link linkend="gint">gint</link> *by);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-cursor">gtk_icon_view_set_cursor</link>            (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                                         <link linkend="gboolean">gboolean</link> start_editing);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-icon-view-get-cursor">gtk_icon_view_get_cursor</link>            (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> **cell);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-selected-foreach">gtk_icon_view_selected_foreach</link>      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkIconViewForeachFunc">GtkIconViewForeachFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-selection-mode">gtk_icon_view_set_selection_mode</link>    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkSelectionMode">GtkSelectionMode</link> mode);
<link linkend="GtkSelectionMode">GtkSelectionMode</link>    <link linkend="gtk-icon-view-get-selection-mode">gtk_icon_view_get_selection_mode</link>    (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-orientation">gtk_icon_view_set_orientation</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkOrientation">GtkOrientation</link> orientation);
<link linkend="GtkOrientation">GtkOrientation</link>      <link linkend="gtk-icon-view-get-orientation">gtk_icon_view_get_orientation</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-columns">gtk_icon_view_set_columns</link>           (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> columns);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-columns">gtk_icon_view_get_columns</link>           (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-item-width">gtk_icon_view_set_item_width</link>        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> item_width);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-item-width">gtk_icon_view_get_item_width</link>        (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-spacing">gtk_icon_view_set_spacing</link>           (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> spacing);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-spacing">gtk_icon_view_get_spacing</link>           (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-row-spacing">gtk_icon_view_set_row_spacing</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> row_spacing);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-row-spacing">gtk_icon_view_get_row_spacing</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-column-spacing">gtk_icon_view_set_column_spacing</link>    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column_spacing);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-column-spacing">gtk_icon_view_get_column_spacing</link>    (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-margin">gtk_icon_view_set_margin</link>            (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> margin);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-margin">gtk_icon_view_get_margin</link>            (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-item-padding">gtk_icon_view_set_item_padding</link>      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> item_padding);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-item-padding">gtk_icon_view_get_item_padding</link>      (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-select-path">gtk_icon_view_select_path</link>           (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-unselect-path">gtk_icon_view_unselect_path</link>         (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-icon-view-path-is-selected">gtk_icon_view_path_is_selected</link>      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);
<link linkend="GList">GList</link> *             <link linkend="gtk-icon-view-get-selected-items">gtk_icon_view_get_selected_items</link>    (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-select-all">gtk_icon_view_select_all</link>            (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-unselect-all">gtk_icon_view_unselect_all</link>          (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-item-activated">gtk_icon_view_item_activated</link>        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-scroll-to-path">gtk_icon_view_scroll_to_path</link>        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="gboolean">gboolean</link> use_align,
                                                         <link linkend="gfloat">gfloat</link> row_align,
                                                         <link linkend="gfloat">gfloat</link> col_align);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-icon-view-get-visible-range">gtk_icon_view_get_visible_range</link>     (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **start_path,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **end_path);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-tooltip-item">gtk_icon_view_set_tooltip_item</link>      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTooltip">GtkTooltip</link> *tooltip,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-tooltip-cell">gtk_icon_view_set_tooltip_cell</link>      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTooltip">GtkTooltip</link> *tooltip,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-icon-view-get-tooltip-context">gtk_icon_view_get_tooltip_context</link>   (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> *x,
                                                         <link linkend="gint">gint</link> *y,
                                                         <link linkend="gboolean">gboolean</link> keyboard_tip,
                                                         <link linkend="GtkTreeModel">GtkTreeModel</link> **model,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkTreeIter">GtkTreeIter</link> *iter);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-tooltip-column">gtk_icon_view_set_tooltip_column</link>    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column);
<link linkend="gint">gint</link>                <link linkend="gtk-icon-view-get-tooltip-column">gtk_icon_view_get_tooltip_column</link>    (<link linkend="GtkIconView">GtkIconView</link> *icon_view);

enum                <link linkend="GtkIconViewDropPosition">GtkIconViewDropPosition</link>;
<link linkend="void">void</link>                <link linkend="gtk-icon-view-enable-model-drag-source">gtk_icon_view_enable_model_drag_source</link>
                                                        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GdkModifierType">GdkModifierType</link> start_button_mask,
                                                         const <link linkend="GtkTargetEntry">GtkTargetEntry</link> *targets,
                                                         <link linkend="gint">gint</link> n_targets,
                                                         <link linkend="GdkDragAction">GdkDragAction</link> actions);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-enable-model-drag-dest">gtk_icon_view_enable_model_drag_dest</link>
                                                        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         const <link linkend="GtkTargetEntry">GtkTargetEntry</link> *targets,
                                                         <link linkend="gint">gint</link> n_targets,
                                                         <link linkend="GdkDragAction">GdkDragAction</link> actions);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-unset-model-drag-source">gtk_icon_view_unset_model_drag_source</link>
                                                        (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-unset-model-drag-dest">gtk_icon_view_unset_model_drag_dest</link> (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-reorderable">gtk_icon_view_set_reorderable</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gboolean">gboolean</link> reorderable);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-icon-view-get-reorderable">gtk_icon_view_get_reorderable</link>       (<link linkend="GtkIconView">GtkIconView</link> *icon_view);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-set-drag-dest-item">gtk_icon_view_set_drag_dest_item</link>    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="GtkIconViewDropPosition">GtkIconViewDropPosition</link> pos);
<link linkend="void">void</link>                <link linkend="gtk-icon-view-get-drag-dest-item">gtk_icon_view_get_drag_dest_item</link>    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkIconViewDropPosition">GtkIconViewDropPosition</link> *pos);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-icon-view-get-dest-item-at-pos">gtk_icon_view_get_dest_item_at_pos</link>  (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> drag_x,
                                                         <link linkend="gint">gint</link> drag_y,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkIconViewDropPosition">GtkIconViewDropPosition</link> *pos);
<link linkend="GdkPixmap">GdkPixmap</link> *         <link linkend="gtk-icon-view-create-drag-icon">gtk_icon_view_create_drag_icon</link>      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkIconView.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----GtkIconView
</synopsis>
</refsect1>



<refsect1 id="GtkIconView.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkIconView implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link> and  <link linkend="GtkCellLayout">GtkCellLayout</link>.</para>
</refsect1>


<refsect1 id="GtkIconView.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkIconView--column-spacing">column-spacing</link>&quot;           <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--columns">columns</link>&quot;                  <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--item-padding">item-padding</link>&quot;             <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--item-width">item-width</link>&quot;               <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--margin">margin</link>&quot;                   <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--markup-column">markup-column</link>&quot;            <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--model">model</link>&quot;                    <link linkend="GtkTreeModel">GtkTreeModel</link>*         : Read / Write
  &quot;<link linkend="GtkIconView--orientation">orientation</link>&quot;              <link linkend="GtkOrientation">GtkOrientation</link>        : Read / Write
  &quot;<link linkend="GtkIconView--pixbuf-column">pixbuf-column</link>&quot;            <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--reorderable">reorderable</link>&quot;              <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkIconView--row-spacing">row-spacing</link>&quot;              <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--selection-mode">selection-mode</link>&quot;           <link linkend="GtkSelectionMode">GtkSelectionMode</link>      : Read / Write
  &quot;<link linkend="GtkIconView--spacing">spacing</link>&quot;                  <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--text-column">text-column</link>&quot;              <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkIconView--tooltip-column">tooltip-column</link>&quot;           <link linkend="gint">gint</link>                  : Read / Write
</synopsis>
</refsect1>
<refsect1 id="GtkIconView.style-properties" role="style_properties">
<title role="style_properties.title">Style Properties</title>
<synopsis>
  &quot;<link linkend="GtkIconView--s-selection-box-alpha">selection-box-alpha</link>&quot;      <link linkend="guchar">guchar</link>                : Read
  &quot;<link linkend="GtkIconView--s-selection-box-color">selection-box-color</link>&quot;      <link linkend="GdkColor">GdkColor</link>*             : Read
</synopsis>
</refsect1>

<refsect1 id="GtkIconView.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkIconView-activate-cursor-item">activate-cursor-item</link>&quot;                           : Run Last / Action
  &quot;<link linkend="GtkIconView-item-activated">item-activated</link>&quot;                                 : Run Last
  &quot;<link linkend="GtkIconView-move-cursor">move-cursor</link>&quot;                                    : Run Last / Action
  &quot;<link linkend="GtkIconView-select-all">select-all</link>&quot;                                     : Run Last / Action
  &quot;<link linkend="GtkIconView-select-cursor-item">select-cursor-item</link>&quot;                             : Run Last / Action
  &quot;<link linkend="GtkIconView-selection-changed">selection-changed</link>&quot;                              : Run First
  &quot;<link linkend="GtkIconView-set-scroll-adjustments">set-scroll-adjustments</link>&quot;                         : Run Last
  &quot;<link linkend="GtkIconView-toggle-cursor-item">toggle-cursor-item</link>&quot;                             : Run Last / Action
  &quot;<link linkend="GtkIconView-unselect-all">unselect-all</link>&quot;                                   : Run Last / Action
</synopsis>
</refsect1>


<refsect1 id="GtkIconView.description" role="desc">
<title role="desc.title">Description</title>
<para>
<link linkend="GtkIconView"><type>GtkIconView</type></link> provides an alternative view on a list model.
It displays the model as a grid of icons with labels. Like
<link linkend="GtkTreeView"><type>GtkTreeView</type></link>, it allows to select one or multiple items
(depending on the selection mode, see <link linkend="gtk-icon-view-set-selection-mode"><function>gtk_icon_view_set_selection_mode()</function></link>).
In addition to selection with the arrow keys, <link linkend="GtkIconView"><type>GtkIconView</type></link> supports
rubberband selection, which is controlled by dragging the pointer.
</para>
</refsect1>

<refsect1 id="GtkIconView.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkIconView-struct" role="struct">
<title>GtkIconView</title>
<indexterm zone="GtkIconView-struct"><primary sortas="IconView">GtkIconView</primary></indexterm><programlisting>typedef struct _GtkIconView GtkIconView;</programlisting>
<para>
The <structname>GtkIconView</structname> struct contains only
private fields and should not be directly accessed.
</para></refsect2>
<refsect2 id="GtkIconViewForeachFunc" role="function">
<title>GtkIconViewForeachFunc ()</title>
<indexterm zone="GtkIconViewForeachFunc"><primary sortas="IconViewForeachFunc">GtkIconViewForeachFunc</primary></indexterm><programlisting><link linkend="void">void</link>                (*GtkIconViewForeachFunc)           (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
A function used by <link linkend="gtk-icon-view-selected-foreach"><function>gtk_icon_view_selected_foreach()</function></link> to map all
selected rows.  It will be called on every selected row in the view.
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkTreePath"><type>GtkTreePath</type></link> of a selected row
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>user data
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-icon-view-new" role="function" condition="since:2.6">
<title>gtk_icon_view_new ()</title>
<indexterm zone="gtk-icon-view-new" role="2.6"><primary sortas="icon_view_new">gtk_icon_view_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_icon_view_new                   (void);</programlisting>
<para>
Creates a new <link linkend="GtkIconView"><type>GtkIconView</type></link> widget</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A newly created <link linkend="GtkIconView"><type>GtkIconView</type></link> widget

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-new-with-model" role="function" condition="since:2.6">
<title>gtk_icon_view_new_with_model ()</title>
<indexterm zone="gtk-icon-view-new-with-model" role="2.6"><primary sortas="icon_view_new_with_model">gtk_icon_view_new_with_model</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_icon_view_new_with_model        (<link linkend="GtkTreeModel">GtkTreeModel</link> *model);</programlisting>
<para>
Creates a new <link linkend="GtkIconView"><type>GtkIconView</type></link> widget with the model <parameter>model</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>model</parameter>&#160;:</term>
<listitem><simpara> The model.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A newly created <link linkend="GtkIconView"><type>GtkIconView</type></link> widget.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-model" role="function" condition="since:2.6">
<title>gtk_icon_view_set_model ()</title>
<indexterm zone="gtk-icon-view-set-model" role="2.6"><primary sortas="icon_view_set_model">gtk_icon_view_set_model</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_model             (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreeModel">GtkTreeModel</link> *model);</programlisting>
<para>
Sets the model for a <link linkend="GtkIconView"><type>GtkIconView</type></link>.  
If the <parameter>icon_view</parameter> already has a model set, it will remove 
it before setting the new model.  If <parameter>model</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>, then
it will unset the old model.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>model</parameter>&#160;:</term>
<listitem><simpara> The model.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-model" role="function" condition="since:2.6">
<title>gtk_icon_view_get_model ()</title>
<indexterm zone="gtk-icon-view-get-model" role="2.6"><primary sortas="icon_view_get_model">gtk_icon_view_get_model</primary></indexterm><programlisting><link linkend="GtkTreeModel">GtkTreeModel</link> *      gtk_icon_view_get_model             (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the model the <link linkend="GtkIconView"><type>GtkIconView</type></link> is based on.  Returns <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the
model is unset.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if none is currently being used.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-text-column" role="function" condition="since:2.6">
<title>gtk_icon_view_set_text_column ()</title>
<indexterm zone="gtk-icon-view-set-text-column" role="2.6"><primary sortas="icon_view_set_text_column">gtk_icon_view_set_text_column</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_text_column       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<para>
Sets the column with text for <parameter>icon_view</parameter> to be <parameter>column</parameter>. The text
column must be of type <link linkend="G-TYPE-STRING--CAPS"><type>G_TYPE_STRING</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara> A column in the currently used model, or -1 to display no text
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-text-column" role="function" condition="since:2.6">
<title>gtk_icon_view_get_text_column ()</title>
<indexterm zone="gtk-icon-view-get-text-column" role="2.6"><primary sortas="icon_view_get_text_column">gtk_icon_view_get_text_column</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_text_column       (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the column with text for <parameter>icon_view</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the text column, or -1 if it's unset.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-markup-column" role="function" condition="since:2.6">
<title>gtk_icon_view_set_markup_column ()</title>
<indexterm zone="gtk-icon-view-set-markup-column" role="2.6"><primary sortas="icon_view_set_markup_column">gtk_icon_view_set_markup_column</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_markup_column     (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<para>
Sets the column with markup information for <parameter>icon_view</parameter> to be
<parameter>column</parameter>. The markup column must be of type <link linkend="G-TYPE-STRING--CAPS"><type>G_TYPE_STRING</type></link>.
If the markup column is set to something, it overrides
the text column set by <link linkend="gtk-icon-view-set-text-column"><function>gtk_icon_view_set_text_column()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara> A column in the currently used model, or -1 to display no text
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-markup-column" role="function" condition="since:2.6">
<title>gtk_icon_view_get_markup_column ()</title>
<indexterm zone="gtk-icon-view-get-markup-column" role="2.6"><primary sortas="icon_view_get_markup_column">gtk_icon_view_get_markup_column</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_markup_column     (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the column with markup text for <parameter>icon_view</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the markup column, or -1 if it's unset.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-pixbuf-column" role="function" condition="since:2.6">
<title>gtk_icon_view_set_pixbuf_column ()</title>
<indexterm zone="gtk-icon-view-set-pixbuf-column" role="2.6"><primary sortas="icon_view_set_pixbuf_column">gtk_icon_view_set_pixbuf_column</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_pixbuf_column     (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<para>
Sets the column with pixbufs for <parameter>icon_view</parameter> to be <parameter>column</parameter>. The pixbuf
column must be of type <link linkend="GDK-TYPE-PIXBUF--CAPS"><type>GDK_TYPE_PIXBUF</type></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara> A column in the currently used model, or -1 to disable
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-pixbuf-column" role="function" condition="since:2.6">
<title>gtk_icon_view_get_pixbuf_column ()</title>
<indexterm zone="gtk-icon-view-get-pixbuf-column" role="2.6"><primary sortas="icon_view_get_pixbuf_column">gtk_icon_view_get_pixbuf_column</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_pixbuf_column     (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the column with pixbufs for <parameter>icon_view</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the pixbuf column, or -1 if it's unset.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-path-at-pos" role="function" condition="since:2.6">
<title>gtk_icon_view_get_path_at_pos ()</title>
<indexterm zone="gtk-icon-view-get-path-at-pos" role="2.6"><primary sortas="icon_view_get_path_at_pos">gtk_icon_view_get_path_at_pos</primary></indexterm><programlisting><link linkend="GtkTreePath">GtkTreePath</link> *       gtk_icon_view_get_path_at_pos       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> x,
                                                         <link linkend="gint">gint</link> y);</programlisting>
<para>
Finds the path at the point (<parameter>x</parameter>, <parameter>y</parameter>), relative to bin_window coordinates.
See <link linkend="gtk-icon-view-get-item-at-pos"><function>gtk_icon_view_get_item_at_pos()</function></link>, if you are also interested in
the cell at the specified position. 
See <link linkend="gtk-icon-view-convert-widget-to-bin-window-coords"><function>gtk_icon_view_convert_widget_to_bin_window_coords()</function></link> for converting
widget coordinates to bin_window coordinates.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>x</parameter>&#160;:</term>
<listitem><simpara> The x position to be identified
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>y</parameter>&#160;:</term>
<listitem><simpara> The y position to be identified
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The <link linkend="GtkTreePath"><type>GtkTreePath</type></link> corresponding to the icon or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
if no icon exists at that position.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-item-at-pos" role="function" condition="since:2.8">
<title>gtk_icon_view_get_item_at_pos ()</title>
<indexterm zone="gtk-icon-view-get-item-at-pos" role="2.8"><primary sortas="icon_view_get_item_at_pos">gtk_icon_view_get_item_at_pos</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_icon_view_get_item_at_pos       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> x,
                                                         <link linkend="gint">gint</link> y,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> **cell);</programlisting>
<para>
Finds the path at the point (<parameter>x</parameter>, <parameter>y</parameter>), relative to bin_window coordinates.
In contrast to <link linkend="gtk-icon-view-get-path-at-pos"><function>gtk_icon_view_get_path_at_pos()</function></link>, this function also 
obtains the cell at the specified position. The returned path should
be freed with <link linkend="gtk-tree-path-free"><function>gtk_tree_path_free()</function></link>.
See <link linkend="gtk-icon-view-convert-widget-to-bin-window-coords"><function>gtk_icon_view_convert_widget_to_bin_window_coords()</function></link> for converting
widget coordinates to bin_window coordinates.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>x</parameter>&#160;:</term>
<listitem><simpara> The x position to be identified
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>y</parameter>&#160;:</term>
<listitem><simpara> The y position to be identified
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> Return location for the path, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara> Return location for the renderer responsible for the cell
  at (<parameter>x</parameter>, <parameter>y</parameter>), or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if an item exists at the specified position

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-convert-widget-to-bin-window-coords" role="function" condition="since:2.12">
<title>gtk_icon_view_convert_widget_to_bin_window_coords ()</title>
<indexterm zone="gtk-icon-view-convert-widget-to-bin-window-coords" role="2.12"><primary sortas="icon_view_convert_widget_to_bin_window_coords">gtk_icon_view_convert_widget_to_bin_window_coords</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_convert_widget_to_bin_window_coords
                                                        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> wx,
                                                         <link linkend="gint">gint</link> wy,
                                                         <link linkend="gint">gint</link> *bx,
                                                         <link linkend="gint">gint</link> *by);</programlisting>
<para>
Converts widget coordinates to coordinates for the bin_window,
as expected by e.g. <link linkend="gtk-icon-view-get-path-at-pos"><function>gtk_icon_view_get_path_at_pos()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link> 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>wx</parameter>&#160;:</term>
<listitem><simpara> X coordinate relative to the widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>wy</parameter>&#160;:</term>
<listitem><simpara> Y coordinate relative to the widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>bx</parameter>&#160;:</term>
<listitem><simpara> return location for bin_window X coordinate
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>by</parameter>&#160;:</term>
<listitem><simpara> return location for bin_window Y coordinate
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.12</para></refsect2>
<refsect2 id="gtk-icon-view-set-cursor" role="function" condition="since:2.8">
<title>gtk_icon_view_set_cursor ()</title>
<indexterm zone="gtk-icon-view-set-cursor" role="2.8"><primary sortas="icon_view_set_cursor">gtk_icon_view_set_cursor</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_cursor            (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell,
                                                         <link linkend="gboolean">gboolean</link> start_editing);</programlisting>
<para>
Sets the current keyboard focus to be at <parameter>path</parameter>, and selects it.  This is
useful when you want to focus the user's attention on a particular item.  
If <parameter>cell</parameter> is not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, then focus is given to the cell specified by 
it. Additionally, if <parameter>start_editing</parameter> is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, then editing should be 
started in the specified cell.  
</para>
<para>
This function is often followed by <literal>gtk_widget_grab_focus 
(icon_view)</literal> in order to give keyboard focus to the widget.  
Please note that editing can only happen when the widget is realized.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreePath"><type>GtkTreePath</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara> One of the cell renderers of <parameter>icon_view</parameter>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>start_editing</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the specified cell should start being edited.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-get-cursor" role="function" condition="since:2.8">
<title>gtk_icon_view_get_cursor ()</title>
<indexterm zone="gtk-icon-view-get-cursor" role="2.8"><primary sortas="icon_view_get_cursor">gtk_icon_view_get_cursor</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_icon_view_get_cursor            (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> **cell);</programlisting>
<para>
Fills in <parameter>path</parameter> and <parameter>cell</parameter> with the current cursor path and cell. 
If the cursor isn't currently set, then *<parameter>path</parameter> will be <link linkend="NULL--CAPS"><literal>NULL</literal></link>.  
If no cell currently has focus, then *<parameter>cell</parameter> will be <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</para>
<para>
The returned <link linkend="GtkTreePath"><type>GtkTreePath</type></link> must be freed with <link linkend="gtk-tree-path-free"><function>gtk_tree_path_free()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> Return location for the current cursor path, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara> Return location the current focus cell, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the cursor is set.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-selected-foreach" role="function" condition="since:2.6">
<title>gtk_icon_view_selected_foreach ()</title>
<indexterm zone="gtk-icon-view-selected-foreach" role="2.6"><primary sortas="icon_view_selected_foreach">gtk_icon_view_selected_foreach</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_selected_foreach      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkIconViewForeachFunc">GtkIconViewForeachFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Calls a function for each selected icon. Note that the model or
selection cannot be modified from within this function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> The funcion to call for each selected icon.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> User data to pass to the function.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-selection-mode" role="function" condition="since:2.6">
<title>gtk_icon_view_set_selection_mode ()</title>
<indexterm zone="gtk-icon-view-set-selection-mode" role="2.6"><primary sortas="icon_view_set_selection_mode">gtk_icon_view_set_selection_mode</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_selection_mode    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkSelectionMode">GtkSelectionMode</link> mode);</programlisting>
<para>
Sets the selection mode of the <parameter>icon_view</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>mode</parameter>&#160;:</term>
<listitem><simpara> The selection mode
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-selection-mode" role="function" condition="since:2.6">
<title>gtk_icon_view_get_selection_mode ()</title>
<indexterm zone="gtk-icon-view-get-selection-mode" role="2.6"><primary sortas="icon_view_get_selection_mode">gtk_icon_view_get_selection_mode</primary></indexterm><programlisting><link linkend="GtkSelectionMode">GtkSelectionMode</link>    gtk_icon_view_get_selection_mode    (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Gets the selection mode of the <parameter>icon_view</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the current selection mode

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-orientation" role="function" condition="since:2.6">
<title>gtk_icon_view_set_orientation ()</title>
<indexterm zone="gtk-icon-view-set-orientation" role="2.6"><primary sortas="icon_view_set_orientation">gtk_icon_view_set_orientation</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_orientation       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkOrientation">GtkOrientation</link> orientation);</programlisting>
<para>
Sets the ::orientation property which determines whether the labels 
are drawn beside the icons instead of below.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>orientation</parameter>&#160;:</term>
<listitem><simpara> the relative position of texts and icons 
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-orientation" role="function" condition="since:2.6">
<title>gtk_icon_view_get_orientation ()</title>
<indexterm zone="gtk-icon-view-get-orientation" role="2.6"><primary sortas="icon_view_get_orientation">gtk_icon_view_get_orientation</primary></indexterm><programlisting><link linkend="GtkOrientation">GtkOrientation</link>      gtk_icon_view_get_orientation       (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the value of the ::orientation property which determines 
whether the labels are drawn beside the icons instead of below.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the relative position of texts and icons 

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-columns" role="function" condition="since:2.6">
<title>gtk_icon_view_set_columns ()</title>
<indexterm zone="gtk-icon-view-set-columns" role="2.6"><primary sortas="icon_view_set_columns">gtk_icon_view_set_columns</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_columns           (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> columns);</programlisting>
<para>
Sets the ::columns property which determines in how
many columns the icons are arranged. If <parameter>columns</parameter> is
-1, the number of columns will be chosen automatically 
to fill the available area.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>columns</parameter>&#160;:</term>
<listitem><simpara> the number of columns
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-columns" role="function" condition="since:2.6">
<title>gtk_icon_view_get_columns ()</title>
<indexterm zone="gtk-icon-view-get-columns" role="2.6"><primary sortas="icon_view_get_columns">gtk_icon_view_get_columns</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_columns           (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the value of the ::columns property.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the number of columns, or -1

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-item-width" role="function" condition="since:2.6">
<title>gtk_icon_view_set_item_width ()</title>
<indexterm zone="gtk-icon-view-set-item-width" role="2.6"><primary sortas="icon_view_set_item_width">gtk_icon_view_set_item_width</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_item_width        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> item_width);</programlisting>
<para>
Sets the ::item-width property which specifies the width 
to use for each item. If it is set to -1, the icon view will 
automatically determine a suitable item size.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item_width</parameter>&#160;:</term>
<listitem><simpara> the width for each item
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-item-width" role="function" condition="since:2.6">
<title>gtk_icon_view_get_item_width ()</title>
<indexterm zone="gtk-icon-view-get-item-width" role="2.6"><primary sortas="icon_view_get_item_width">gtk_icon_view_get_item_width</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_item_width        (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the value of the ::item-width property.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the width of a single item, or -1

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-spacing" role="function" condition="since:2.6">
<title>gtk_icon_view_set_spacing ()</title>
<indexterm zone="gtk-icon-view-set-spacing" role="2.6"><primary sortas="icon_view_set_spacing">gtk_icon_view_set_spacing</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_spacing           (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> spacing);</programlisting>
<para>
Sets the ::spacing property which specifies the space 
which is inserted between the cells (i.e. the icon and 
the text) of an item.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>spacing</parameter>&#160;:</term>
<listitem><simpara> the spacing
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-spacing" role="function" condition="since:2.6">
<title>gtk_icon_view_get_spacing ()</title>
<indexterm zone="gtk-icon-view-get-spacing" role="2.6"><primary sortas="icon_view_get_spacing">gtk_icon_view_get_spacing</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_spacing           (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the value of the ::spacing property.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the space between cells 

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-row-spacing" role="function" condition="since:2.6">
<title>gtk_icon_view_set_row_spacing ()</title>
<indexterm zone="gtk-icon-view-set-row-spacing" role="2.6"><primary sortas="icon_view_set_row_spacing">gtk_icon_view_set_row_spacing</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_row_spacing       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> row_spacing);</programlisting>
<para>
Sets the ::row-spacing property which specifies the space 
which is inserted between the rows of the icon view.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row_spacing</parameter>&#160;:</term>
<listitem><simpara> the row spacing
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-row-spacing" role="function" condition="since:2.6">
<title>gtk_icon_view_get_row_spacing ()</title>
<indexterm zone="gtk-icon-view-get-row-spacing" role="2.6"><primary sortas="icon_view_get_row_spacing">gtk_icon_view_get_row_spacing</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_row_spacing       (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the value of the ::row-spacing property.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the space between rows

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-column-spacing" role="function" condition="since:2.6">
<title>gtk_icon_view_set_column_spacing ()</title>
<indexterm zone="gtk-icon-view-set-column-spacing" role="2.6"><primary sortas="icon_view_set_column_spacing">gtk_icon_view_set_column_spacing</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_column_spacing    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column_spacing);</programlisting>
<para>
Sets the ::column-spacing property which specifies the space 
which is inserted between the columns of the icon view.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column_spacing</parameter>&#160;:</term>
<listitem><simpara> the column spacing
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-column-spacing" role="function" condition="since:2.6">
<title>gtk_icon_view_get_column_spacing ()</title>
<indexterm zone="gtk-icon-view-get-column-spacing" role="2.6"><primary sortas="icon_view_get_column_spacing">gtk_icon_view_get_column_spacing</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_column_spacing    (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the value of the ::column-spacing property.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the space between columns

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-margin" role="function" condition="since:2.6">
<title>gtk_icon_view_set_margin ()</title>
<indexterm zone="gtk-icon-view-set-margin" role="2.6"><primary sortas="icon_view_set_margin">gtk_icon_view_set_margin</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_margin            (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> margin);</programlisting>
<para>
Sets the ::margin property which specifies the space 
which is inserted at the top, bottom, left and right 
of the icon view.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>margin</parameter>&#160;:</term>
<listitem><simpara> the margin
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-margin" role="function" condition="since:2.6">
<title>gtk_icon_view_get_margin ()</title>
<indexterm zone="gtk-icon-view-get-margin" role="2.6"><primary sortas="icon_view_get_margin">gtk_icon_view_get_margin</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_margin            (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the value of the ::margin property.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the space at the borders 

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-set-item-padding" role="function" condition="since:2.18">
<title>gtk_icon_view_set_item_padding ()</title>
<indexterm zone="gtk-icon-view-set-item-padding" role="2.18"><primary sortas="icon_view_set_item_padding">gtk_icon_view_set_item_padding</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_item_padding      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> item_padding);</programlisting>
<para>
Sets the ::item-padding property which specifies the padding 
around each of the icon view's items.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item_padding</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-icon-view-get-item-padding" role="function" condition="since:2.18">
<title>gtk_icon_view_get_item_padding ()</title>
<indexterm zone="gtk-icon-view-get-item-padding" role="2.18"><primary sortas="icon_view_get_item_padding">gtk_icon_view_get_item_padding</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_item_padding      (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the value of the ::item-padding property.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the padding around items

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-icon-view-select-path" role="function" condition="since:2.6">
<title>gtk_icon_view_select_path ()</title>
<indexterm zone="gtk-icon-view-select-path" role="2.6"><primary sortas="icon_view_select_path">gtk_icon_view_select_path</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_select_path           (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);</programlisting>
<para>
Selects the row at <parameter>path</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkTreePath"><type>GtkTreePath</type></link> to be selected.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-unselect-path" role="function" condition="since:2.6">
<title>gtk_icon_view_unselect_path ()</title>
<indexterm zone="gtk-icon-view-unselect-path" role="2.6"><primary sortas="icon_view_unselect_path">gtk_icon_view_unselect_path</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_unselect_path         (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);</programlisting>
<para>
Unselects the row at <parameter>path</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkTreePath"><type>GtkTreePath</type></link> to be unselected.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-path-is-selected" role="function" condition="since:2.6">
<title>gtk_icon_view_path_is_selected ()</title>
<indexterm zone="gtk-icon-view-path-is-selected" role="2.6"><primary sortas="icon_view_path_is_selected">gtk_icon_view_path_is_selected</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_icon_view_path_is_selected      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);</programlisting>
<para>
Returns <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the icon pointed to by <parameter>path</parameter> is currently
selected. If <parameter>path</parameter> does not point to a valid location, <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> is returned.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkTreePath"><type>GtkTreePath</type></link> to check selection on.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if <parameter>path</parameter> is selected.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-get-selected-items" role="function" condition="since:2.6">
<title>gtk_icon_view_get_selected_items ()</title>
<indexterm zone="gtk-icon-view-get-selected-items" role="2.6"><primary sortas="icon_view_get_selected_items">gtk_icon_view_get_selected_items</primary></indexterm><programlisting><link linkend="GList">GList</link> *             gtk_icon_view_get_selected_items    (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Creates a list of paths of all selected items. Additionally, if you are
planning on modifying the model after calling this function, you may
want to convert the returned list into a list of <link linkend="GtkTreeRowReference"><type>GtkTreeRowReference</type></link><!-- -->s.
To do this, you can use <link linkend="gtk-tree-row-reference-new"><function>gtk_tree_row_reference_new()</function></link>.
</para>
<para>
To free the return value, use:
<informalexample><programlisting>
g_list_foreach (list, gtk_tree_path_free, NULL);
g_list_free (list);
</programlisting></informalexample></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GList"><type>GList</type></link> containing a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> for each selected row.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-select-all" role="function" condition="since:2.6">
<title>gtk_icon_view_select_all ()</title>
<indexterm zone="gtk-icon-view-select-all" role="2.6"><primary sortas="icon_view_select_all">gtk_icon_view_select_all</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_select_all            (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Selects all the icons. <parameter>icon_view</parameter> must has its selection mode set
to <link linkend="GTK-SELECTION-MULTIPLE--CAPS"><type>GTK_SELECTION_MULTIPLE</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-unselect-all" role="function" condition="since:2.6">
<title>gtk_icon_view_unselect_all ()</title>
<indexterm zone="gtk-icon-view-unselect-all" role="2.6"><primary sortas="icon_view_unselect_all">gtk_icon_view_unselect_all</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_unselect_all          (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Unselects all the icons.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-item-activated" role="function" condition="since:2.6">
<title>gtk_icon_view_item_activated ()</title>
<indexterm zone="gtk-icon-view-item-activated" role="2.6"><primary sortas="icon_view_item_activated">gtk_icon_view_item_activated</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_item_activated        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);</programlisting>
<para>
Activates the item determined by <parameter>path</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkTreePath"><type>GtkTreePath</type></link> to be activated
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.6</para></refsect2>
<refsect2 id="gtk-icon-view-scroll-to-path" role="function" condition="since:2.8">
<title>gtk_icon_view_scroll_to_path ()</title>
<indexterm zone="gtk-icon-view-scroll-to-path" role="2.8"><primary sortas="icon_view_scroll_to_path">gtk_icon_view_scroll_to_path</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_scroll_to_path        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="gboolean">gboolean</link> use_align,
                                                         <link linkend="gfloat">gfloat</link> row_align,
                                                         <link linkend="gfloat">gfloat</link> col_align);</programlisting>
<para>
Moves the alignments of <parameter>icon_view</parameter> to the position specified by <parameter>path</parameter>.  
<parameter>row_align</parameter> determines where the row is placed, and <parameter>col_align</parameter> determines 
where <parameter>column</parameter> 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.
</para>
<para>
If <parameter>use_align</parameter> is <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>, then the alignment arguments are ignored, and the
tree 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.
</para>
<para>
This function only works if the model is set, and <parameter>path</parameter> is a valid row on 
the model. If the model changes before the <parameter>icon_view</parameter> is realized, the 
centered path will be modified to reflect this change.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> The path of the item to move to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>use_align</parameter>&#160;:</term>
<listitem><simpara> whether to use alignment arguments, or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row_align</parameter>&#160;:</term>
<listitem><simpara> The vertical alignment of the item specified by <parameter>path</parameter>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>col_align</parameter>&#160;:</term>
<listitem><simpara> The horizontal alignment of the item specified by <parameter>path</parameter>.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-get-visible-range" role="function" condition="since:2.8">
<title>gtk_icon_view_get_visible_range ()</title>
<indexterm zone="gtk-icon-view-get-visible-range" role="2.8"><primary sortas="icon_view_get_visible_range">gtk_icon_view_get_visible_range</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_icon_view_get_visible_range     (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **start_path,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **end_path);</programlisting>
<para>
Sets <parameter>start_path</parameter> and <parameter>end_path</parameter> to be the first and last visible path. 
Note that there may be invisible paths in between.
</para>
<para>
Both paths should be freed with <link linkend="gtk-tree-path-free"><function>gtk_tree_path_free()</function></link> after use.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>start_path</parameter>&#160;:</term>
<listitem><simpara> Return location for start of region, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>end_path</parameter>&#160;:</term>
<listitem><simpara> Return location for end of region, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, if valid paths were placed in <parameter>start_path</parameter> and <parameter>end_path</parameter>

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-set-tooltip-item" role="function" condition="since:2.12">
<title>gtk_icon_view_set_tooltip_item ()</title>
<indexterm zone="gtk-icon-view-set-tooltip-item" role="2.12"><primary sortas="icon_view_set_tooltip_item">gtk_icon_view_set_tooltip_item</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_tooltip_item      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTooltip">GtkTooltip</link> *tooltip,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);</programlisting>
<para>
Sets the tip area of <parameter>tooltip</parameter> to be the area covered by the item at <parameter>path</parameter>.
See also <link linkend="gtk-icon-view-set-tooltip-column"><function>gtk_icon_view_set_tooltip_column()</function></link> for a simpler alternative.
See also <link linkend="gtk-tooltip-set-tip-area"><function>gtk_tooltip_set_tip_area()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTooltip"><type>GtkTooltip</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreePath"><type>GtkTreePath</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.12</para></refsect2>
<refsect2 id="gtk-icon-view-set-tooltip-cell" role="function" condition="since:2.12">
<title>gtk_icon_view_set_tooltip_cell ()</title>
<indexterm zone="gtk-icon-view-set-tooltip-cell" role="2.12"><primary sortas="icon_view_set_tooltip_cell">gtk_icon_view_set_tooltip_cell</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_tooltip_cell      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTooltip">GtkTooltip</link> *tooltip,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="GtkCellRenderer">GtkCellRenderer</link> *cell);</programlisting>
<para>
Sets the tip area of <parameter>tooltip</parameter> to the area which <parameter>cell</parameter> occupies in
the item pointed to by <parameter>path</parameter>. See also <link linkend="gtk-tooltip-set-tip-area"><function>gtk_tooltip_set_tip_area()</function></link>.
</para>
<para>
See also <link linkend="gtk-icon-view-set-tooltip-column"><function>gtk_icon_view_set_tooltip_column()</function></link> for a simpler alternative.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTooltip"><type>GtkTooltip</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreePath"><type>GtkTreePath</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.12</para></refsect2>
<refsect2 id="gtk-icon-view-get-tooltip-context" role="function" condition="since:2.12">
<title>gtk_icon_view_get_tooltip_context ()</title>
<indexterm zone="gtk-icon-view-get-tooltip-context" role="2.12"><primary sortas="icon_view_get_tooltip_context">gtk_icon_view_get_tooltip_context</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_icon_view_get_tooltip_context   (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> *x,
                                                         <link linkend="gint">gint</link> *y,
                                                         <link linkend="gboolean">gboolean</link> keyboard_tip,
                                                         <link linkend="GtkTreeModel">GtkTreeModel</link> **model,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkTreeIter">GtkTreeIter</link> *iter);</programlisting>
<para>
This function is supposed to be used in a <link linkend="GtkWidget-query-tooltip"><type>"query-tooltip"</type></link>
signal handler for <link linkend="GtkIconView"><type>GtkIconView</type></link>.  The <parameter>x</parameter>, <parameter>y</parameter> and <parameter>keyboard_tip</parameter> values
which are received in the signal handler, should be passed to this
function without modification.
</para>
<para>
The return value indicates whether there is an icon view item at the given
coordinates (<link linkend="TRUE--CAPS"><literal>TRUE</literal></link>) or not (<link linkend="FALSE--CAPS"><literal>FALSE</literal></link>) for mouse tooltips. For keyboard
tooltips the item returned will be the cursor item. When <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, then any of
<parameter>model</parameter>, <parameter>path</parameter> and <parameter>iter</parameter> which have been provided will be set to point to
that row and the corresponding model. <parameter>x</parameter> and <parameter>y</parameter> will always be converted
to be relative to <parameter>icon_view</parameter>'s bin_window if <parameter>keyboard_tooltip</parameter> is <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> an <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>x</parameter>&#160;:</term>
<listitem><simpara> the x coordinate (relative to widget coordinates)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>y</parameter>&#160;:</term>
<listitem><simpara> the y coordinate (relative to widget coordinates)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>keyboard_tip</parameter>&#160;:</term>
<listitem><simpara> whether this is a keyboard tooltip or not
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>model</parameter>&#160;:</term>
<listitem><simpara> a pointer to receive a <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> a pointer to receive a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>iter</parameter>&#160;:</term>
<listitem><simpara> a pointer to receive a <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> whether or not the given tooltip context points to a item

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.12</para></refsect2>
<refsect2 id="gtk-icon-view-set-tooltip-column" role="function" condition="since:2.12">
<title>gtk_icon_view_set_tooltip_column ()</title>
<indexterm zone="gtk-icon-view-set-tooltip-column" role="2.12"><primary sortas="icon_view_set_tooltip_column">gtk_icon_view_set_tooltip_column</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_tooltip_column    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<para>
If you only plan to have simple (text-only) tooltips on full items, you
can use this function to have <link linkend="GtkIconView"><type>GtkIconView</type></link> handle these automatically
for you. <parameter>column</parameter> should be set to the column in <parameter>icon_view</parameter>'s model
containing the tooltip texts, or -1 to disable this feature.
</para>
<para>
When enabled, <link linkend="GtkWidget-has-tooltip"><type>"has-tooltip"</type></link> will be set to <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> and
<parameter>icon_view</parameter> will connect a <link linkend="GtkWidget-query-tooltip"><type>"query-tooltip"</type></link> signal handler.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara> an integer, which is a valid column number for <parameter>icon_view</parameter>'s model
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.12</para></refsect2>
<refsect2 id="gtk-icon-view-get-tooltip-column" role="function" condition="since:2.12">
<title>gtk_icon_view_get_tooltip_column ()</title>
<indexterm zone="gtk-icon-view-get-tooltip-column" role="2.12"><primary sortas="icon_view_get_tooltip_column">gtk_icon_view_get_tooltip_column</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_icon_view_get_tooltip_column    (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Returns the column of <parameter>icon_view</parameter>'s model which is being used for
displaying tooltips on <parameter>icon_view</parameter>'s rows.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the index of the tooltip column that is currently being
used, or -1 if this is disabled.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.12</para></refsect2>
<refsect2 id="GtkIconViewDropPosition" role="enum">
<title>enum GtkIconViewDropPosition</title>
<indexterm zone="GtkIconViewDropPosition"><primary sortas="IconViewDropPosition">GtkIconViewDropPosition</primary></indexterm><programlisting>typedef enum
{
  GTK_ICON_VIEW_NO_DROP,
  GTK_ICON_VIEW_DROP_INTO,
  GTK_ICON_VIEW_DROP_LEFT,
  GTK_ICON_VIEW_DROP_RIGHT,
  GTK_ICON_VIEW_DROP_ABOVE,
  GTK_ICON_VIEW_DROP_BELOW
} GtkIconViewDropPosition;
</programlisting>
<para>
An enum for determining where a dropped item goes.
</para><variablelist role="enum">
<varlistentry id="GTK-ICON-VIEW-NO-DROP--CAPS" role="constant">
<term><literal>GTK_ICON_VIEW_NO_DROP</literal></term>
<listitem><simpara>no drop possible
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-ICON-VIEW-DROP-INTO--CAPS" role="constant">
<term><literal>GTK_ICON_VIEW_DROP_INTO</literal></term>
<listitem><simpara>dropped item replaces the item
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-ICON-VIEW-DROP-LEFT--CAPS" role="constant">
<term><literal>GTK_ICON_VIEW_DROP_LEFT</literal></term>
<listitem><simpara>droppped item is inserted to the left
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-ICON-VIEW-DROP-RIGHT--CAPS" role="constant">
<term><literal>GTK_ICON_VIEW_DROP_RIGHT</literal></term>
<listitem><simpara>dropped item is inserted to the right
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-ICON-VIEW-DROP-ABOVE--CAPS" role="constant">
<term><literal>GTK_ICON_VIEW_DROP_ABOVE</literal></term>
<listitem><simpara>dropped item is inserted above
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-ICON-VIEW-DROP-BELOW--CAPS" role="constant">
<term><literal>GTK_ICON_VIEW_DROP_BELOW</literal></term>
<listitem><simpara>dropped item is inserted below
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-icon-view-enable-model-drag-source" role="function" condition="since:2.8">
<title>gtk_icon_view_enable_model_drag_source ()</title>
<indexterm zone="gtk-icon-view-enable-model-drag-source" role="2.8"><primary sortas="icon_view_enable_model_drag_source">gtk_icon_view_enable_model_drag_source</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_enable_model_drag_source
                                                        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GdkModifierType">GdkModifierType</link> start_button_mask,
                                                         const <link linkend="GtkTargetEntry">GtkTargetEntry</link> *targets,
                                                         <link linkend="gint">gint</link> n_targets,
                                                         <link linkend="GdkDragAction">GdkDragAction</link> actions);</programlisting>
<para>
Turns <parameter>icon_view</parameter> into a drag source for automatic DND. Calling this
method sets <link linkend="GtkIconView--reorderable"><type>"reorderable"</type></link> to <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconTreeView"><type>GtkIconTreeView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>start_button_mask</parameter>&#160;:</term>
<listitem><simpara> Mask of allowed buttons to start drag
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>targets</parameter>&#160;:</term>
<listitem><simpara> the table of targets that the drag will support
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n_targets</parameter>&#160;:</term>
<listitem><simpara> the number of items in <parameter>targets</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actions</parameter>&#160;:</term>
<listitem><simpara> the bitmask of possible actions for a drag from this
   widget
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-enable-model-drag-dest" role="function" condition="since:2.8">
<title>gtk_icon_view_enable_model_drag_dest ()</title>
<indexterm zone="gtk-icon-view-enable-model-drag-dest" role="2.8"><primary sortas="icon_view_enable_model_drag_dest">gtk_icon_view_enable_model_drag_dest</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_enable_model_drag_dest
                                                        (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         const <link linkend="GtkTargetEntry">GtkTargetEntry</link> *targets,
                                                         <link linkend="gint">gint</link> n_targets,
                                                         <link linkend="GdkDragAction">GdkDragAction</link> actions);</programlisting>
<para>
Turns <parameter>icon_view</parameter> into a drop destination for automatic DND. Calling this
method sets <link linkend="GtkIconView--reorderable"><type>"reorderable"</type></link> to <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>targets</parameter>&#160;:</term>
<listitem><simpara> the table of targets that the drag will support
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n_targets</parameter>&#160;:</term>
<listitem><simpara> the number of items in <parameter>targets</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>actions</parameter>&#160;:</term>
<listitem><simpara> the bitmask of possible actions for a drag to this
   widget
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-unset-model-drag-source" role="function" condition="since:2.8">
<title>gtk_icon_view_unset_model_drag_source ()</title>
<indexterm zone="gtk-icon-view-unset-model-drag-source" role="2.8"><primary sortas="icon_view_unset_model_drag_source">gtk_icon_view_unset_model_drag_source</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_unset_model_drag_source
                                                        (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Undoes the effect of <link linkend="gtk-icon-view-enable-model-drag-source"><function>gtk_icon_view_enable_model_drag_source()</function></link>. Calling this
method sets <link linkend="GtkIconView--reorderable"><type>"reorderable"</type></link> to <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-unset-model-drag-dest" role="function" condition="since:2.8">
<title>gtk_icon_view_unset_model_drag_dest ()</title>
<indexterm zone="gtk-icon-view-unset-model-drag-dest" role="2.8"><primary sortas="icon_view_unset_model_drag_dest">gtk_icon_view_unset_model_drag_dest</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_unset_model_drag_dest (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Undoes the effect of <link linkend="gtk-icon-view-enable-model-drag-dest"><function>gtk_icon_view_enable_model_drag_dest()</function></link>. Calling this
method sets <link linkend="GtkIconView--reorderable"><type>"reorderable"</type></link> to <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-set-reorderable" role="function" condition="since:2.8">
<title>gtk_icon_view_set_reorderable ()</title>
<indexterm zone="gtk-icon-view-set-reorderable" role="2.8"><primary sortas="icon_view_set_reorderable">gtk_icon_view_set_reorderable</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_reorderable       (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gboolean">gboolean</link> reorderable);</programlisting>
<para>
This function is a convenience function to allow you to reorder models that
support the <link linkend="GtkTreeDragSourceIface"><type>GtkTreeDragSourceIface</type></link> and the <link linkend="GtkTreeDragDestIface"><type>GtkTreeDragDestIface</type></link>.  Both
<link linkend="GtkTreeStore"><type>GtkTreeStore</type></link> and <link linkend="GtkListStore"><type>GtkListStore</type></link> support these.  If <parameter>reorderable</parameter> is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, then
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. The reordering is implemented by setting up
the icon view as a drag source and destination. Therefore, drag and
drop can not be used in a reorderable view for any other purpose.
</para>
<para>
This function does not give you any degree of control over the order -- any
reordering is allowed.  If more control is needed, you should probably
handle drag and drop manually.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkIconView"><type>GtkIconView</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>reorderable</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, if the list of items can be reordered.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-get-reorderable" role="function" condition="since:2.8">
<title>gtk_icon_view_get_reorderable ()</title>
<indexterm zone="gtk-icon-view-get-reorderable" role="2.8"><primary sortas="icon_view_get_reorderable">gtk_icon_view_get_reorderable</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_icon_view_get_reorderable       (<link linkend="GtkIconView">GtkIconView</link> *icon_view);</programlisting>
<para>
Retrieves whether the user can reorder the list via drag-and-drop. 
See <link linkend="gtk-icon-view-set-reorderable"><function>gtk_icon_view_set_reorderable()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the list can be reordered.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-set-drag-dest-item" role="function" condition="since:2.8">
<title>gtk_icon_view_set_drag_dest_item ()</title>
<indexterm zone="gtk-icon-view-set-drag-dest-item" role="2.8"><primary sortas="icon_view_set_drag_dest_item">gtk_icon_view_set_drag_dest_item</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_set_drag_dest_item    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                         <link linkend="GtkIconViewDropPosition">GtkIconViewDropPosition</link> pos);</programlisting>
<para>
Sets the item that is highlighted for feedback.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> The path of the item to highlight, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pos</parameter>&#160;:</term>
<listitem><simpara> Specifies where to drop, relative to the item
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-get-drag-dest-item" role="function" condition="since:2.8">
<title>gtk_icon_view_get_drag_dest_item ()</title>
<indexterm zone="gtk-icon-view-get-drag-dest-item" role="2.8"><primary sortas="icon_view_get_drag_dest_item">gtk_icon_view_get_drag_dest_item</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_icon_view_get_drag_dest_item    (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkIconViewDropPosition">GtkIconViewDropPosition</link> *pos);</programlisting>
<para>
Gets information about the item that is highlighted for feedback.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> Return location for the path of the highlighted item, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pos</parameter>&#160;:</term>
<listitem><simpara> Return location for the drop position, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-get-dest-item-at-pos" role="function" condition="since:2.8">
<title>gtk_icon_view_get_dest_item_at_pos ()</title>
<indexterm zone="gtk-icon-view-get-dest-item-at-pos" role="2.8"><primary sortas="icon_view_get_dest_item_at_pos">gtk_icon_view_get_dest_item_at_pos</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_icon_view_get_dest_item_at_pos  (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="gint">gint</link> drag_x,
                                                         <link linkend="gint">gint</link> drag_y,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> **path,
                                                         <link linkend="GtkIconViewDropPosition">GtkIconViewDropPosition</link> *pos);</programlisting>
<para>
Determines the destination item for a given position.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>drag_x</parameter>&#160;:</term>
<listitem><simpara> the position to determine the destination item for
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>drag_y</parameter>&#160;:</term>
<listitem><simpara> the position to determine the destination item for
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> Return location for the path of the item, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pos</parameter>&#160;:</term>
<listitem><simpara> Return location for the drop position, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> whether there is an item at the given position.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>
<refsect2 id="gtk-icon-view-create-drag-icon" role="function" condition="since:2.8">
<title>gtk_icon_view_create_drag_icon ()</title>
<indexterm zone="gtk-icon-view-create-drag-icon" role="2.8"><primary sortas="icon_view_create_drag_icon">gtk_icon_view_create_drag_icon</primary></indexterm><programlisting><link linkend="GdkPixmap">GdkPixmap</link> *         gtk_icon_view_create_drag_icon      (<link linkend="GtkIconView">GtkIconView</link> *icon_view,
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *path);</programlisting>
<para>
Creates a <link linkend="GdkPixmap"><type>GdkPixmap</type></link> representation of the item at <parameter>path</parameter>.  
This image is used for a drag icon.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>icon_view</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkIconView"><type>GtkIconView</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> in <parameter>icon_view</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a newly-allocated pixmap of the drag icon.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.8</para></refsect2>

</refsect1>
<refsect1 id="GtkIconView.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkIconView--column-spacing" role="property"><title>The <literal>&quot;column-spacing&quot;</literal> property</title>
<indexterm zone="GtkIconView--column-spacing" role="2.6"><primary sortas="IconView:column-spacing">GtkIconView:column-spacing</primary></indexterm><programlisting>  &quot;column-spacing&quot;           <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The column-spacing property specifies the space which is inserted between
the columns of the icon view.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 6</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--columns" role="property"><title>The <literal>&quot;columns&quot;</literal> property</title>
<indexterm zone="GtkIconView--columns" role="2.6"><primary sortas="IconView:columns">GtkIconView:columns</primary></indexterm><programlisting>  &quot;columns&quot;                  <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The columns property contains the number of the columns in which the
items should be displayed. If it is -1, the number of columns will
be chosen automatically to fill the available area.</para>
<para>
</para><para>Allowed values: &gt;= G_MAXULONG</para>
<para>Default value: -1</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--item-padding" role="property"><title>The <literal>&quot;item-padding&quot;</literal> property</title>
<indexterm zone="GtkIconView--item-padding" role="2.18"><primary sortas="IconView:item-padding">GtkIconView:item-padding</primary></indexterm><programlisting>  &quot;item-padding&quot;             <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The item-padding property specifies the padding around each
of the icon view's item.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 6</para>
<para>Since 2.18</para>
</refsect2>
<refsect2 id="GtkIconView--item-width" role="property"><title>The <literal>&quot;item-width&quot;</literal> property</title>
<indexterm zone="GtkIconView--item-width" role="2.6"><primary sortas="IconView:item-width">GtkIconView:item-width</primary></indexterm><programlisting>  &quot;item-width&quot;               <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The item-width property specifies the width to use for each item.
If it is set to -1, the icon view will automatically determine a 
suitable item size.</para>
<para>
</para><para>Allowed values: &gt;= G_MAXULONG</para>
<para>Default value: -1</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--margin" role="property"><title>The <literal>&quot;margin&quot;</literal> property</title>
<indexterm zone="GtkIconView--margin" role="2.6"><primary sortas="IconView:margin">GtkIconView:margin</primary></indexterm><programlisting>  &quot;margin&quot;                   <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The margin property specifies the space which is inserted 
at the edges of the icon view.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 6</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--markup-column" role="property"><title>The <literal>&quot;markup-column&quot;</literal> property</title>
<indexterm zone="GtkIconView--markup-column" role="2.6"><primary sortas="IconView:markup-column">GtkIconView:markup-column</primary></indexterm><programlisting>  &quot;markup-column&quot;            <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The ::markup-column property contains the number of the model column
containing markup information to be displayed. The markup column must be 
of type <link linkend="G-TYPE-STRING--CAPS"><type>G_TYPE_STRING</type></link>. If this property and the :text-column property 
are both set to column numbers, it overrides the text column.
If both are set to -1, no texts are displayed.</para>
<para>
</para><para>Allowed values: &gt;= G_MAXULONG</para>
<para>Default value: -1</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--model" role="property"><title>The <literal>&quot;model&quot;</literal> property</title>
<indexterm zone="GtkIconView--model"><primary sortas="IconView:model">GtkIconView:model</primary></indexterm><programlisting>  &quot;model&quot;                    <link linkend="GtkTreeModel">GtkTreeModel</link>*         : Read / Write</programlisting>
<para>The model for the icon view.</para></refsect2>
<refsect2 id="GtkIconView--orientation" role="property"><title>The <literal>&quot;orientation&quot;</literal> property</title>
<indexterm zone="GtkIconView--orientation" role="2.6"><primary sortas="IconView:orientation">GtkIconView:orientation</primary></indexterm><programlisting>  &quot;orientation&quot;              <link linkend="GtkOrientation">GtkOrientation</link>        : Read / Write</programlisting>
<para>
The orientation property specifies how the cells (i.e. the icon and 
the text) of the item are positioned relative to each other.</para>
<para>
</para><para>Default value: GTK_ORIENTATION_VERTICAL</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--pixbuf-column" role="property"><title>The <literal>&quot;pixbuf-column&quot;</literal> property</title>
<indexterm zone="GtkIconView--pixbuf-column" role="2.6"><primary sortas="IconView:pixbuf-column">GtkIconView:pixbuf-column</primary></indexterm><programlisting>  &quot;pixbuf-column&quot;            <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The ::pixbuf-column property contains the number of the model column
containing the pixbufs which are displayed. The pixbuf column must be 
of type <link linkend="GDK-TYPE-PIXBUF--CAPS"><type>GDK_TYPE_PIXBUF</type></link>. Setting this property to -1 turns off the
display of pixbufs.</para>
<para>
</para><para>Allowed values: &gt;= G_MAXULONG</para>
<para>Default value: -1</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--reorderable" role="property"><title>The <literal>&quot;reorderable&quot;</literal> property</title>
<indexterm zone="GtkIconView--reorderable" role="2.8"><primary sortas="IconView:reorderable">GtkIconView:reorderable</primary></indexterm><programlisting>  &quot;reorderable&quot;              <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
The reorderable property specifies if the items can be reordered
by DND.</para>
<para>
</para><para>Default value: FALSE</para>
<para>Since 2.8</para>
</refsect2>
<refsect2 id="GtkIconView--row-spacing" role="property"><title>The <literal>&quot;row-spacing&quot;</literal> property</title>
<indexterm zone="GtkIconView--row-spacing" role="2.6"><primary sortas="IconView:row-spacing">GtkIconView:row-spacing</primary></indexterm><programlisting>  &quot;row-spacing&quot;              <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The row-spacing property specifies the space which is inserted between
the rows of the icon view.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 6</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--selection-mode" role="property"><title>The <literal>&quot;selection-mode&quot;</literal> property</title>
<indexterm zone="GtkIconView--selection-mode" role="2.6"><primary sortas="IconView:selection-mode">GtkIconView:selection-mode</primary></indexterm><programlisting>  &quot;selection-mode&quot;           <link linkend="GtkSelectionMode">GtkSelectionMode</link>      : Read / Write</programlisting>
<para>
The ::selection-mode property specifies the selection mode of
icon view. If the mode is <link linkend="GTK-SELECTION-MULTIPLE--CAPS"><type>GTK_SELECTION_MULTIPLE</type></link>, rubberband selection
is enabled, for the other modes, only keyboard selection is possible.</para>
<para>
</para><para>Default value: GTK_SELECTION_SINGLE</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--spacing" role="property"><title>The <literal>&quot;spacing&quot;</literal> property</title>
<indexterm zone="GtkIconView--spacing" role="2.6"><primary sortas="IconView:spacing">GtkIconView:spacing</primary></indexterm><programlisting>  &quot;spacing&quot;                  <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The spacing property specifies the space which is inserted between
the cells (i.e. the icon and the text) of an item.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--text-column" role="property"><title>The <literal>&quot;text-column&quot;</literal> property</title>
<indexterm zone="GtkIconView--text-column" role="2.6"><primary sortas="IconView:text-column">GtkIconView:text-column</primary></indexterm><programlisting>  &quot;text-column&quot;              <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The ::text-column property contains the number of the model column
containing the texts which are displayed. The text column must be 
of type <link linkend="G-TYPE-STRING--CAPS"><type>G_TYPE_STRING</type></link>. If this property and the :markup-column 
property are both set to -1, no texts are displayed.</para>
<para>
</para><para>Allowed values: &gt;= G_MAXULONG</para>
<para>Default value: -1</para>
<para>Since 2.6</para>
</refsect2>
<refsect2 id="GtkIconView--tooltip-column" role="property"><title>The <literal>&quot;tooltip-column&quot;</literal> property</title>
<indexterm zone="GtkIconView--tooltip-column"><primary sortas="IconView:tooltip-column">GtkIconView:tooltip-column</primary></indexterm><programlisting>  &quot;tooltip-column&quot;           <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>The column in the model containing the tooltip texts for the items.</para><para>Allowed values: &gt;= G_MAXULONG</para>
<para>Default value: -1</para>
</refsect2>

</refsect1>
<refsect1 id="GtkIconView.style-property-details" role="style_properties_details">
<title role="style_properties_details.title">Style Property Details</title>
<refsect2 id="GtkIconView--s-selection-box-alpha" role="property"><title>The <literal>&quot;selection-box-alpha&quot;</literal> style property</title>
<indexterm zone="GtkIconView--s-selection-box-alpha"><primary sortas="IconView:selection-box-alpha">GtkIconView:selection-box-alpha</primary></indexterm><programlisting>  &quot;selection-box-alpha&quot;      <link linkend="guchar">guchar</link>                : Read</programlisting>
<para>Opacity of the selection box.</para><para>Default value: 64</para>
</refsect2>
<refsect2 id="GtkIconView--s-selection-box-color" role="property"><title>The <literal>&quot;selection-box-color&quot;</literal> style property</title>
<indexterm zone="GtkIconView--s-selection-box-color"><primary sortas="IconView:selection-box-color">GtkIconView:selection-box-color</primary></indexterm><programlisting>  &quot;selection-box-color&quot;      <link linkend="GdkColor">GdkColor</link>*             : Read</programlisting>
<para>Color of the selection box.</para></refsect2>
</refsect1>

<refsect1 id="GtkIconView.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkIconView-activate-cursor-item" role="signal"><title>The <literal>&quot;activate-cursor-item&quot;</literal> signal</title>
<indexterm zone="GtkIconView-activate-cursor-item"><primary sortas="IconView::activate-cursor-item">GtkIconView::activate-cursor-item</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            user_function                      (<link linkend="GtkIconView">GtkIconView</link> *iconview,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run Last / Action</programlisting>
<para>
A <link linkend="keybinding-signals">keybinding signal</link>
which gets emitted when the user activates the currently
focused item. 
</para>
<para>
Applications should not connect to it, but may emit it with
<link linkend="g-signal-emit-by-name"><function>g_signal_emit_by_name()</function></link> if they need to control activation
programmatically.
</para>
<para>
The default bindings for this signal are Space, Return and Enter.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>iconview</parameter>&#160;:</term>
<listitem><simpara> the object on which the signal is emitted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkIconView-item-activated" role="signal"><title>The <literal>&quot;item-activated&quot;</literal> signal</title>
<indexterm zone="GtkIconView-item-activated"><primary sortas="IconView::item-activated">GtkIconView::item-activated</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkIconView">GtkIconView</link> *iconview,
                                                        <link linkend="GtkTreePath">GtkTreePath</link> *path,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run Last</programlisting>
<para>
The ::item-activated signal is emitted when the method
<link linkend="gtk-icon-view-item-activated"><function>gtk_icon_view_item_activated()</function></link> is called or the user double 
clicks an item. It is also emitted when a non-editable item
is selected and one of the keys: Space, Return or Enter is
pressed.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>iconview</parameter>&#160;:</term>
<listitem><simpara> the object on which the signal is emitted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkTreePath"><type>GtkTreePath</type></link> for the activated item
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkIconView-move-cursor" role="signal"><title>The <literal>&quot;move-cursor&quot;</literal> signal</title>
<indexterm zone="GtkIconView-move-cursor"><primary sortas="IconView::move-cursor">GtkIconView::move-cursor</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            user_function                      (<link linkend="GtkIconView">GtkIconView</link>    *iconview,
                                                        <link linkend="GtkMovementStep">GtkMovementStep</link> step,
                                                        <link linkend="gint">gint</link>            count,
                                                        <link linkend="gpointer">gpointer</link>        user_data)      : Run Last / Action</programlisting>
<para>
The ::move-cursor signal is a
<link linkend="keybinding-signals">keybinding signal</link>
which gets emitted when the user initiates a cursor movement.
</para>
<para>
Applications should not connect to it, but may emit it with
<link linkend="g-signal-emit-by-name"><function>g_signal_emit_by_name()</function></link> if they need to control the cursor
programmatically.
</para>
<para>
The default bindings for this signal include
<itemizedlist>
<listitem>Arrow keys which move by individual steps</listitem>
<listitem>Home/End keys which move to the first/last item</listitem>
<listitem>PageUp/PageDown which move by "pages"</listitem>
</itemizedlist>
</para>
<para>
All of these will extend the selection when combined with
the Shift modifier.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>iconview</parameter>&#160;:</term>
<listitem><simpara> the object which received the signal
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>step</parameter>&#160;:</term>
<listitem><simpara> the granularity of the move, as a <link linkend="GtkMovementStep"><type>GtkMovementStep</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>count</parameter>&#160;:</term>
<listitem><simpara> the number of <parameter>step</parameter> units to move
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkIconView-select-all" role="signal"><title>The <literal>&quot;select-all&quot;</literal> signal</title>
<indexterm zone="GtkIconView-select-all"><primary sortas="IconView::select-all">GtkIconView::select-all</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkIconView">GtkIconView</link> *iconview,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run Last / Action</programlisting>
<para>
A <link linkend="keybinding-signals">keybinding signal</link>
which gets emitted when the user selects all items.
</para>
<para>
Applications should not connect to it, but may emit it with
<link linkend="g-signal-emit-by-name"><function>g_signal_emit_by_name()</function></link> if they need to control selection
programmatically.
</para>
<para>
The default binding for this signal is Ctrl-a.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>iconview</parameter>&#160;:</term>
<listitem><simpara> the object on which the signal is emitted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkIconView-select-cursor-item" role="signal"><title>The <literal>&quot;select-cursor-item&quot;</literal> signal</title>
<indexterm zone="GtkIconView-select-cursor-item"><primary sortas="IconView::select-cursor-item">GtkIconView::select-cursor-item</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkIconView">GtkIconView</link> *iconview,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run Last / Action</programlisting>
<para>
A <link linkend="keybinding-signals">keybinding signal</link>
which gets emitted when the user selects the item that is currently
focused.
</para>
<para>
Applications should not connect to it, but may emit it with
<link linkend="g-signal-emit-by-name"><function>g_signal_emit_by_name()</function></link> if they need to control selection
programmatically.
</para>
<para>
There is no default binding for this signal.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>iconview</parameter>&#160;:</term>
<listitem><simpara> the object on which the signal is emitted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkIconView-selection-changed" role="signal"><title>The <literal>&quot;selection-changed&quot;</literal> signal</title>
<indexterm zone="GtkIconView-selection-changed"><primary sortas="IconView::selection-changed">GtkIconView::selection-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkIconView">GtkIconView</link> *iconview,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run First</programlisting>
<para>
The ::selection-changed signal is emitted when the selection
(i.e. the set of selected items) changes.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>iconview</parameter>&#160;:</term>
<listitem><simpara> the object on which the signal is emitted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkIconView-set-scroll-adjustments" role="signal"><title>The <literal>&quot;set-scroll-adjustments&quot;</literal> signal</title>
<indexterm zone="GtkIconView-set-scroll-adjustments"><primary sortas="IconView::set-scroll-adjustments">GtkIconView::set-scroll-adjustments</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkIconView">GtkIconView</link>   *horizontal,
                                                        <link linkend="GtkAdjustment">GtkAdjustment</link> *vertical,
                                                        <link linkend="GtkAdjustment">GtkAdjustment</link> *arg2,
                                                        <link linkend="gpointer">gpointer</link>       user_data)       : Run Last</programlisting>
<para>
Set the scroll adjustments for the icon view. Usually scrolled containers
like <link linkend="GtkScrolledWindow"><type>GtkScrolledWindow</type></link> will emit this signal to connect two instances
of <link linkend="GtkScrollbar"><type>GtkScrollbar</type></link> to the scroll directions of the <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>horizontal</parameter>&#160;:</term>
<listitem><simpara> the horizontal <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>vertical</parameter>&#160;:</term>
<listitem><simpara> the vertical <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkIconView-toggle-cursor-item" role="signal"><title>The <literal>&quot;toggle-cursor-item&quot;</literal> signal</title>
<indexterm zone="GtkIconView-toggle-cursor-item"><primary sortas="IconView::toggle-cursor-item">GtkIconView::toggle-cursor-item</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkIconView">GtkIconView</link> *iconview,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run Last / Action</programlisting>
<para>
A <link linkend="keybinding-signals">keybinding signal</link>
which gets emitted when the user toggles whether the currently
focused item is selected or not. The exact effect of this 
depend on the selection mode.
</para>
<para>
Applications should not connect to it, but may emit it with
<link linkend="g-signal-emit-by-name"><function>g_signal_emit_by_name()</function></link> if they need to control selection
programmatically.
</para>
<para>
There is no default binding for this signal is Ctrl-Space.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>iconview</parameter>&#160;:</term>
<listitem><simpara> the object on which the signal is emitted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkIconView-unselect-all" role="signal"><title>The <literal>&quot;unselect-all&quot;</literal> signal</title>
<indexterm zone="GtkIconView-unselect-all"><primary sortas="IconView::unselect-all">GtkIconView::unselect-all</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkIconView">GtkIconView</link> *iconview,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run Last / Action</programlisting>
<para>
A <link linkend="keybinding-signals">keybinding signal</link>
which gets emitted when the user unselects all items.
</para>
<para>
Applications should not connect to it, but may emit it with
<link linkend="g-signal-emit-by-name"><function>g_signal_emit_by_name()</function></link> if they need to control selection
programmatically.
</para>
<para>
The default binding for this signal is Ctrl-Shift-a.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>iconview</parameter>&#160;:</term>
<listitem><simpara> the object on which the signal is emitted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
