<?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 pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkIconView">
<refmeta>
<refentrytitle role="top_of_page" id="GtkIconView.top_of_page">GtkIconView</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkIconView</refname>
<refpurpose>A widget which displays a list of icons in a grid</refpurpose>
</refnamediv>

<refsect1 id="GtkIconView.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><phrase role="c_punctuation">(</phrase><link linkend="GtkIconViewForeachFunc">*GtkIconViewForeachFunc</link><phrase role="c_punctuation">)</phrase>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-icon-view-new">gtk_icon_view_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-icon-view-new-with-area">gtk_icon_view_new_with_area</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-icon-view-new-with-model">gtk_icon_view_new_with_model</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-model">gtk_icon_view_set_model</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkTreeModel"><returnvalue>GtkTreeModel</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-model">gtk_icon_view_get_model</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-text-column">gtk_icon_view_set_text_column</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-text-column">gtk_icon_view_get_text_column</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-markup-column">gtk_icon_view_set_markup_column</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-markup-column">gtk_icon_view_get_markup_column</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-pixbuf-column">gtk_icon_view_set_pixbuf_column</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-pixbuf-column">gtk_icon_view_get_pixbuf_column</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkTreePath"><returnvalue>GtkTreePath</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-path-at-pos">gtk_icon_view_get_path_at_pos</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-item-at-pos">gtk_icon_view_get_item_at_pos</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-cursor">gtk_icon_view_set_cursor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-cursor">gtk_icon_view_get_cursor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-selected-foreach">gtk_icon_view_selected_foreach</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-selection-mode">gtk_icon_view_set_selection_mode</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkSelectionMode"><returnvalue>GtkSelectionMode</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-selection-mode">gtk_icon_view_get_selection_mode</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-item-orientation">gtk_icon_view_set_item_orientation</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkOrientation"><returnvalue>GtkOrientation</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-item-orientation">gtk_icon_view_get_item_orientation</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-columns">gtk_icon_view_set_columns</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-columns">gtk_icon_view_get_columns</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-item-width">gtk_icon_view_set_item_width</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-item-width">gtk_icon_view_get_item_width</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-spacing">gtk_icon_view_set_spacing</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-spacing">gtk_icon_view_get_spacing</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-row-spacing">gtk_icon_view_set_row_spacing</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-row-spacing">gtk_icon_view_get_row_spacing</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-column-spacing">gtk_icon_view_set_column_spacing</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-column-spacing">gtk_icon_view_get_column_spacing</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-margin">gtk_icon_view_set_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-margin">gtk_icon_view_get_margin</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-item-padding">gtk_icon_view_set_item_padding</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-item-padding">gtk_icon_view_get_item_padding</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-activate-on-single-click">gtk_icon_view_set_activate_on_single_click</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-activate-on-single-click">gtk_icon_view_get_activate_on_single_click</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-cell-rect">gtk_icon_view_get_cell_rect</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-select-path">gtk_icon_view_select_path</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-unselect-path">gtk_icon_view_unselect_path</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-path-is-selected">gtk_icon_view_path_is_selected</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GList"><returnvalue>GList</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-selected-items">gtk_icon_view_get_selected_items</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-select-all">gtk_icon_view_select_all</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-unselect-all">gtk_icon_view_unselect_all</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-item-activated">gtk_icon_view_item_activated</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-scroll-to-path">gtk_icon_view_scroll_to_path</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-visible-range">gtk_icon_view_get_visible_range</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-tooltip-item">gtk_icon_view_set_tooltip_item</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-tooltip-cell">gtk_icon_view_set_tooltip_cell</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-tooltip-context">gtk_icon_view_get_tooltip_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-tooltip-column">gtk_icon_view_set_tooltip_column</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-tooltip-column">gtk_icon_view_get_tooltip_column</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-item-row">gtk_icon_view_get_item_row</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-item-column">gtk_icon_view_get_item_column</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-enable-model-drag-source">gtk_icon_view_enable_model_drag_source</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-enable-model-drag-dest">gtk_icon_view_enable_model_drag_dest</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-unset-model-drag-source">gtk_icon_view_unset_model_drag_source</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-unset-model-drag-dest">gtk_icon_view_unset_model_drag_dest</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-reorderable">gtk_icon_view_set_reorderable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-reorderable">gtk_icon_view_get_reorderable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-set-drag-dest-item">gtk_icon_view_set_drag_dest_item</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-drag-dest-item">gtk_icon_view_get_drag_dest_item</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-icon-view-get-dest-item-at-pos">gtk_icon_view_get_dest_item_at_pos</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkPaintable"><returnvalue>GdkPaintable</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-icon-view-create-drag-icon">gtk_icon_view_create_drag_icon</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkIconView.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkIconView--activate-on-single-click">activate-on-single-click</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkCellArea"><type>GtkCellArea</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkIconView--cell-area">cell-area</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--column-spacing">column-spacing</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--columns">columns</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkOrientation"><type>GtkOrientation</type></link></entry><entry role="property_name"><link linkend="GtkIconView--item-orientation">item-orientation</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--item-padding">item-padding</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--item-width">item-width</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--margin">margin</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--markup-column">markup-column</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkIconView--model">model</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--pixbuf-column">pixbuf-column</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkIconView--reorderable">reorderable</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--row-spacing">row-spacing</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkSelectionMode"><type>GtkSelectionMode</type></link></entry><entry role="property_name"><link linkend="GtkIconView--selection-mode">selection-mode</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--spacing">spacing</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--text-column">text-column</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkIconView--tooltip-column">tooltip-column</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkIconView.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkIconView-activate-cursor-item">activate-cursor-item</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkIconView-item-activated">item-activated</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkIconView-move-cursor">move-cursor</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkIconView-select-all">select-all</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkIconView-select-cursor-item">select-cursor-item</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkIconView-selection-changed">selection-changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkIconView-toggle-cursor-item">toggle-cursor-item</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkIconView-unselect-all">unselect-all</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkIconView.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkIconView-struct">GtkIconView</link></entry></row>

<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkIconViewDropPosition">GtkIconViewDropPosition</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkIconView.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkWidget">GtkWidget</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkIconView
</screen>
</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>,  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link>,  <link linkend="GtkCellLayout">GtkCellLayout</link> and  <link linkend="GtkScrollable">GtkScrollable</link>.</para>

</refsect1>

<refsect1 id="GtkIconView.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</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 <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>.
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>
<para>Note that if the tree model is backed by an actual tree store (as
opposed to a flat list where the mapping to icons is obvious),
<link linkend="GtkIconView"><type>GtkIconView</type></link> will only display the first level of the tree and
ignore the tree’s branches.</para>
<refsect2><title>CSS nodes</title><informalexample><programlisting role="example"><![CDATA[
iconview.view
╰── [rubberband]
]]></programlisting></informalexample>
<para></para>
<para>GtkIconView has a single CSS node with name iconview and style class .view.
For rubberband selection, a subnode with name rubberband is used.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkIconView.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="GtkIconViewForeachFunc" role="function">
<title>GtkIconViewForeachFunc&#160;()</title>
<indexterm zone="GtkIconViewForeachFunc"><primary>GtkIconViewForeachFunc</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
<phrase role="c_punctuation">(</phrase>*GtkIconViewForeachFunc<phrase role="c_punctuation">)</phrase> (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                           <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>,
                           <parameter><link linkend="gpointer"><type>gpointer</type></link> data</parameter>);</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>
<refsect3 id="GtkIconViewForeachFunc.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>The <link linkend="GtkTreePath"><type>GtkTreePath</type></link> of a selected row</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>data</para></entry>
<entry role="parameter_description"><para>user data. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-new" role="function">
<title>gtk_icon_view_new&#160;()</title>
<indexterm zone="gtk-icon-view-new"><primary>gtk_icon_view_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_icon_view_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new <link linkend="GtkIconView"><type>GtkIconView</type></link> widget</para>
<refsect3 id="gtk-icon-view-new.returns" role="returns">
<title>Returns</title>
<para> A newly created <link linkend="GtkIconView"><type>GtkIconView</type></link> widget</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-new-with-area" role="function">
<title>gtk_icon_view_new_with_area&#160;()</title>
<indexterm zone="gtk-icon-view-new-with-area"><primary>gtk_icon_view_new_with_area</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_icon_view_new_with_area (<parameter><link linkend="GtkCellArea"><type>GtkCellArea</type></link> *area</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkIconView"><type>GtkIconView</type></link> widget using the
specified <parameter>area</parameter>
 to layout cells inside the icons.</para>
<refsect3 id="gtk-icon-view-new-with-area.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>area</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkCellArea"><type>GtkCellArea</type></link> to use to layout cells</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-new-with-area.returns" role="returns">
<title>Returns</title>
<para> A newly created <link linkend="GtkIconView"><type>GtkIconView</type></link> widget</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-new-with-model" role="function">
<title>gtk_icon_view_new_with_model&#160;()</title>
<indexterm zone="gtk-icon-view-new-with-model"><primary>gtk_icon_view_new_with_model</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_icon_view_new_with_model (<parameter><link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> *model</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkIconView"><type>GtkIconView</type></link> widget with the model <parameter>model</parameter>
.</para>
<refsect3 id="gtk-icon-view-new-with-model.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>model</para></entry>
<entry role="parameter_description"><para>The model.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-new-with-model.returns" role="returns">
<title>Returns</title>
<para> A newly created <link linkend="GtkIconView"><type>GtkIconView</type></link> widget.</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-model" role="function">
<title>gtk_icon_view_set_model&#160;()</title>
<indexterm zone="gtk-icon-view-set-model"><primary>gtk_icon_view_set_model</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_model (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                         <parameter><link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> *model</parameter>);</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>
<refsect3 id="gtk-icon-view-set-model.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>model</para></entry>
<entry role="parameter_description"><para>The model. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-model" role="function">
<title>gtk_icon_view_get_model&#160;()</title>
<indexterm zone="gtk-icon-view-get-model"><primary>gtk_icon_view_get_model</primary></indexterm>
<programlisting language="C"><link linkend="GtkTreeModel"><returnvalue>GtkTreeModel</returnvalue></link>&#160;*
gtk_icon_view_get_model (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</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>
<refsect3 id="gtk-icon-view-get-model.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-model.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if none is
currently being used. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-text-column" role="function">
<title>gtk_icon_view_set_text_column&#160;()</title>
<indexterm zone="gtk-icon-view-set-text-column"><primary>gtk_icon_view_set_text_column</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_text_column (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                               <parameter><link linkend="gint"><type>gint</type></link> column</parameter>);</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>
<refsect3 id="gtk-icon-view-set-text-column.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>column</para></entry>
<entry role="parameter_description"><para>A column in the currently used model, or -1 to display no text</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-text-column" role="function">
<title>gtk_icon_view_get_text_column&#160;()</title>
<indexterm zone="gtk-icon-view-get-text-column"><primary>gtk_icon_view_get_text_column</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_text_column (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the column with text for <parameter>icon_view</parameter>
.</para>
<refsect3 id="gtk-icon-view-get-text-column.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-text-column.returns" role="returns">
<title>Returns</title>
<para> the text column, or -1 if it’s unset.</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-markup-column" role="function">
<title>gtk_icon_view_set_markup_column&#160;()</title>
<indexterm zone="gtk-icon-view-set-markup-column"><primary>gtk_icon_view_set_markup_column</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_markup_column (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                 <parameter><link linkend="gint"><type>gint</type></link> column</parameter>);</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>
<refsect3 id="gtk-icon-view-set-markup-column.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>column</para></entry>
<entry role="parameter_description"><para>A column in the currently used model, or -1 to display no text</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-markup-column" role="function">
<title>gtk_icon_view_get_markup_column&#160;()</title>
<indexterm zone="gtk-icon-view-get-markup-column"><primary>gtk_icon_view_get_markup_column</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_markup_column (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the column with markup text for <parameter>icon_view</parameter>
.</para>
<refsect3 id="gtk-icon-view-get-markup-column.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-markup-column.returns" role="returns">
<title>Returns</title>
<para> the markup column, or -1 if it’s unset.</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-pixbuf-column" role="function">
<title>gtk_icon_view_set_pixbuf_column&#160;()</title>
<indexterm zone="gtk-icon-view-set-pixbuf-column"><primary>gtk_icon_view_set_pixbuf_column</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_pixbuf_column (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                 <parameter><link linkend="gint"><type>gint</type></link> column</parameter>);</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>
<refsect3 id="gtk-icon-view-set-pixbuf-column.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>column</para></entry>
<entry role="parameter_description"><para>A column in the currently used model, or -1 to disable</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-pixbuf-column" role="function">
<title>gtk_icon_view_get_pixbuf_column&#160;()</title>
<indexterm zone="gtk-icon-view-get-pixbuf-column"><primary>gtk_icon_view_get_pixbuf_column</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_pixbuf_column (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the column with pixbufs for <parameter>icon_view</parameter>
.</para>
<refsect3 id="gtk-icon-view-get-pixbuf-column.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-pixbuf-column.returns" role="returns">
<title>Returns</title>
<para> the pixbuf column, or -1 if it’s unset.</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-path-at-pos" role="function">
<title>gtk_icon_view_get_path_at_pos&#160;()</title>
<indexterm zone="gtk-icon-view-get-path-at-pos"><primary>gtk_icon_view_get_path_at_pos</primary></indexterm>
<programlisting language="C"><link linkend="GtkTreePath"><returnvalue>GtkTreePath</returnvalue></link>&#160;*
gtk_icon_view_get_path_at_pos (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                               <parameter><link linkend="gint"><type>gint</type></link> x</parameter>,
                               <parameter><link linkend="gint"><type>gint</type></link> y</parameter>);</programlisting>
<refsect3 id="gtk-icon-view-get-path-at-pos.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>The x position to be identified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>The y position to be identified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-path-at-pos.returns" role="returns">
<title>Returns</title>
<para>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. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-item-at-pos" role="function">
<title>gtk_icon_view_get_item_at_pos&#160;()</title>
<indexterm zone="gtk-icon-view-get-item-at-pos"><primary>gtk_icon_view_get_item_at_pos</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_icon_view_get_item_at_pos (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                               <parameter><link linkend="gint"><type>gint</type></link> x</parameter>,
                               <parameter><link linkend="gint"><type>gint</type></link> y</parameter>,
                               <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> **path</parameter>,
                               <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> **cell</parameter>);</programlisting>
<refsect3 id="gtk-icon-view-get-item-at-pos.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>The x position to be identified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>The y position to be identified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>Return location for the path, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>cell</para></entry>
<entry role="parameter_description"><para>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>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>][<acronym>transfer none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-item-at-pos.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if an item exists at the specified position</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-cursor" role="function">
<title>gtk_icon_view_set_cursor&#160;()</title>
<indexterm zone="gtk-icon-view-set-cursor"><primary>gtk_icon_view_set_cursor</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_cursor (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                          <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>,
                          <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *cell</parameter>,
                          <parameter><link linkend="gboolean"><type>gboolean</type></link> start_editing</parameter>);</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>
<refsect3 id="gtk-icon-view-set-cursor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkTreePath"><type>GtkTreePath</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell</para></entry>
<entry role="parameter_description"><para>One of the cell renderers of <parameter>icon_view</parameter>
, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>start_editing</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the specified cell should start being edited.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-cursor" role="function">
<title>gtk_icon_view_get_cursor&#160;()</title>
<indexterm zone="gtk-icon-view-get-cursor"><primary>gtk_icon_view_get_cursor</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_icon_view_get_cursor (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                          <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> **path</parameter>,
                          <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> **cell</parameter>);</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>
<refsect3 id="gtk-icon-view-get-cursor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>Return location for the current
cursor path, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>][<acronym>transfer full</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>cell</para></entry>
<entry role="parameter_description"><para>Return location the current
focus cell, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>][<acronym>transfer none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-cursor.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the cursor is set.</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-selected-foreach" role="function">
<title>gtk_icon_view_selected_foreach&#160;()</title>
<indexterm zone="gtk-icon-view-selected-foreach"><primary>gtk_icon_view_selected_foreach</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_selected_foreach (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                <parameter><link linkend="GtkIconViewForeachFunc"><type>GtkIconViewForeachFunc</type></link> func</parameter>,
                                <parameter><link linkend="gpointer"><type>gpointer</type></link> data</parameter>);</programlisting>
<para>Calls a function for each selected icon. Note that the model or
selection cannot be modified from within this function.</para>
<refsect3 id="gtk-icon-view-selected-foreach.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>func</para></entry>
<entry role="parameter_description"><para>The function to call for each selected icon. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope call</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>data</para></entry>
<entry role="parameter_description"><para>User data to pass to the function.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-selection-mode" role="function">
<title>gtk_icon_view_set_selection_mode&#160;()</title>
<indexterm zone="gtk-icon-view-set-selection-mode"><primary>gtk_icon_view_set_selection_mode</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_selection_mode (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                  <parameter><link linkend="GtkSelectionMode"><type>GtkSelectionMode</type></link> mode</parameter>);</programlisting>
<para>Sets the selection mode of the <parameter>icon_view</parameter>
.</para>
<refsect3 id="gtk-icon-view-set-selection-mode.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>mode</para></entry>
<entry role="parameter_description"><para>The selection mode</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-selection-mode" role="function">
<title>gtk_icon_view_get_selection_mode&#160;()</title>
<indexterm zone="gtk-icon-view-get-selection-mode"><primary>gtk_icon_view_get_selection_mode</primary></indexterm>
<programlisting language="C"><link linkend="GtkSelectionMode"><returnvalue>GtkSelectionMode</returnvalue></link>
gtk_icon_view_get_selection_mode (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Gets the selection mode of the <parameter>icon_view</parameter>
.</para>
<refsect3 id="gtk-icon-view-get-selection-mode.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-selection-mode.returns" role="returns">
<title>Returns</title>
<para> the current selection mode</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-item-orientation" role="function">
<title>gtk_icon_view_set_item_orientation&#160;()</title>
<indexterm zone="gtk-icon-view-set-item-orientation"><primary>gtk_icon_view_set_item_orientation</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_item_orientation (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                    <parameter><link linkend="GtkOrientation"><type>GtkOrientation</type></link> orientation</parameter>);</programlisting>
<para>Sets the ::item-orientation property which determines whether the labels 
are drawn beside the icons instead of below.</para>
<refsect3 id="gtk-icon-view-set-item-orientation.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>orientation</para></entry>
<entry role="parameter_description"><para>the relative position of texts and icons </para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-item-orientation" role="function">
<title>gtk_icon_view_get_item_orientation&#160;()</title>
<indexterm zone="gtk-icon-view-get-item-orientation"><primary>gtk_icon_view_get_item_orientation</primary></indexterm>
<programlisting language="C"><link linkend="GtkOrientation"><returnvalue>GtkOrientation</returnvalue></link>
gtk_icon_view_get_item_orientation (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the value of the ::item-orientation property which determines 
whether the labels are drawn beside the icons instead of below.</para>
<refsect3 id="gtk-icon-view-get-item-orientation.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-item-orientation.returns" role="returns">
<title>Returns</title>
<para> the relative position of texts and icons </para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-columns" role="function">
<title>gtk_icon_view_set_columns&#160;()</title>
<indexterm zone="gtk-icon-view-set-columns"><primary>gtk_icon_view_set_columns</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_columns (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> columns</parameter>);</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>
<refsect3 id="gtk-icon-view-set-columns.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>columns</para></entry>
<entry role="parameter_description"><para>the number of columns</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-columns" role="function">
<title>gtk_icon_view_get_columns&#160;()</title>
<indexterm zone="gtk-icon-view-get-columns"><primary>gtk_icon_view_get_columns</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_columns (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the value of the ::columns property.</para>
<refsect3 id="gtk-icon-view-get-columns.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-columns.returns" role="returns">
<title>Returns</title>
<para> the number of columns, or -1</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-item-width" role="function">
<title>gtk_icon_view_set_item_width&#160;()</title>
<indexterm zone="gtk-icon-view-set-item-width"><primary>gtk_icon_view_set_item_width</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_item_width (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                              <parameter><link linkend="gint"><type>gint</type></link> item_width</parameter>);</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>
<refsect3 id="gtk-icon-view-set-item-width.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>item_width</para></entry>
<entry role="parameter_description"><para>the width for each item</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-item-width" role="function">
<title>gtk_icon_view_get_item_width&#160;()</title>
<indexterm zone="gtk-icon-view-get-item-width"><primary>gtk_icon_view_get_item_width</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_item_width (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the value of the ::item-width property.</para>
<refsect3 id="gtk-icon-view-get-item-width.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-item-width.returns" role="returns">
<title>Returns</title>
<para> the width of a single item, or -1</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-spacing" role="function">
<title>gtk_icon_view_set_spacing&#160;()</title>
<indexterm zone="gtk-icon-view-set-spacing"><primary>gtk_icon_view_set_spacing</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_spacing (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> spacing</parameter>);</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>
<refsect3 id="gtk-icon-view-set-spacing.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>spacing</para></entry>
<entry role="parameter_description"><para>the spacing</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-spacing" role="function">
<title>gtk_icon_view_get_spacing&#160;()</title>
<indexterm zone="gtk-icon-view-get-spacing"><primary>gtk_icon_view_get_spacing</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_spacing (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the value of the ::spacing property.</para>
<refsect3 id="gtk-icon-view-get-spacing.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-spacing.returns" role="returns">
<title>Returns</title>
<para> the space between cells </para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-row-spacing" role="function">
<title>gtk_icon_view_set_row_spacing&#160;()</title>
<indexterm zone="gtk-icon-view-set-row-spacing"><primary>gtk_icon_view_set_row_spacing</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_row_spacing (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                               <parameter><link linkend="gint"><type>gint</type></link> row_spacing</parameter>);</programlisting>
<para>Sets the ::row-spacing property which specifies the space 
which is inserted between the rows of the icon view.</para>
<refsect3 id="gtk-icon-view-set-row-spacing.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>row_spacing</para></entry>
<entry role="parameter_description"><para>the row spacing</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-row-spacing" role="function">
<title>gtk_icon_view_get_row_spacing&#160;()</title>
<indexterm zone="gtk-icon-view-get-row-spacing"><primary>gtk_icon_view_get_row_spacing</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_row_spacing (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the value of the ::row-spacing property.</para>
<refsect3 id="gtk-icon-view-get-row-spacing.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-row-spacing.returns" role="returns">
<title>Returns</title>
<para> the space between rows</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-column-spacing" role="function">
<title>gtk_icon_view_set_column_spacing&#160;()</title>
<indexterm zone="gtk-icon-view-set-column-spacing"><primary>gtk_icon_view_set_column_spacing</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_column_spacing (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                  <parameter><link linkend="gint"><type>gint</type></link> column_spacing</parameter>);</programlisting>
<para>Sets the ::column-spacing property which specifies the space 
which is inserted between the columns of the icon view.</para>
<refsect3 id="gtk-icon-view-set-column-spacing.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>column_spacing</para></entry>
<entry role="parameter_description"><para>the column spacing</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-column-spacing" role="function">
<title>gtk_icon_view_get_column_spacing&#160;()</title>
<indexterm zone="gtk-icon-view-get-column-spacing"><primary>gtk_icon_view_get_column_spacing</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_column_spacing (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the value of the ::column-spacing property.</para>
<refsect3 id="gtk-icon-view-get-column-spacing.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-column-spacing.returns" role="returns">
<title>Returns</title>
<para> the space between columns</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-margin" role="function">
<title>gtk_icon_view_set_margin&#160;()</title>
<indexterm zone="gtk-icon-view-set-margin"><primary>gtk_icon_view_set_margin</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_margin (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                          <parameter><link linkend="gint"><type>gint</type></link> margin</parameter>);</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>
<refsect3 id="gtk-icon-view-set-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>margin</para></entry>
<entry role="parameter_description"><para>the margin</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-margin" role="function">
<title>gtk_icon_view_get_margin&#160;()</title>
<indexterm zone="gtk-icon-view-get-margin"><primary>gtk_icon_view_get_margin</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_margin (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the value of the ::margin property.</para>
<refsect3 id="gtk-icon-view-get-margin.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-margin.returns" role="returns">
<title>Returns</title>
<para> the space at the borders </para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-item-padding" role="function">
<title>gtk_icon_view_set_item_padding&#160;()</title>
<indexterm zone="gtk-icon-view-set-item-padding"><primary>gtk_icon_view_set_item_padding</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_item_padding (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                <parameter><link linkend="gint"><type>gint</type></link> item_padding</parameter>);</programlisting>
<para>Sets the <link linkend="GtkIconView--item-padding"><type>“item-padding”</type></link> property which specifies the padding
around each of the icon view’s items.</para>
<refsect3 id="gtk-icon-view-set-item-padding.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>item_padding</para></entry>
<entry role="parameter_description"><para>the item padding</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-item-padding" role="function">
<title>gtk_icon_view_get_item_padding&#160;()</title>
<indexterm zone="gtk-icon-view-get-item-padding"><primary>gtk_icon_view_get_item_padding</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_item_padding (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Returns the value of the ::item-padding property.</para>
<refsect3 id="gtk-icon-view-get-item-padding.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-item-padding.returns" role="returns">
<title>Returns</title>
<para> the padding around items</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-activate-on-single-click" role="function">
<title>gtk_icon_view_set_activate_on_single_click&#160;()</title>
<indexterm zone="gtk-icon-view-set-activate-on-single-click"><primary>gtk_icon_view_set_activate_on_single_click</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_activate_on_single_click
                               (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                <parameter><link linkend="gboolean"><type>gboolean</type></link> single</parameter>);</programlisting>
<para>Causes the <link linkend="GtkIconView-item-activated"><type>“item-activated”</type></link> signal to be emitted on
a single click instead of a double click.</para>
<refsect3 id="gtk-icon-view-set-activate-on-single-click.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>single</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to emit item-activated on a single click</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-activate-on-single-click" role="function">
<title>gtk_icon_view_get_activate_on_single_click&#160;()</title>
<indexterm zone="gtk-icon-view-get-activate-on-single-click"><primary>gtk_icon_view_get_activate_on_single_click</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_icon_view_get_activate_on_single_click
                               (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Gets the setting set by <link linkend="gtk-icon-view-set-activate-on-single-click"><function>gtk_icon_view_set_activate_on_single_click()</function></link>.</para>
<refsect3 id="gtk-icon-view-get-activate-on-single-click.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-activate-on-single-click.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if item-activated will be emitted on a single click</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-cell-rect" role="function">
<title>gtk_icon_view_get_cell_rect&#160;()</title>
<indexterm zone="gtk-icon-view-get-cell-rect"><primary>gtk_icon_view_get_cell_rect</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_icon_view_get_cell_rect (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                             <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>,
                             <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *cell</parameter>,
                             <parameter><link linkend="GdkRectangle"><type>GdkRectangle</type></link> *rect</parameter>);</programlisting>
<para>Fills the bounding rectangle in widget coordinates for the cell specified by
<parameter>path</parameter>
 and <parameter>cell</parameter>
. If <parameter>cell</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link> the main cell area is used.</para>
<para>This function is only valid if <parameter>icon_view</parameter>
 is realized.</para>
<refsect3 id="gtk-icon-view-get-cell-rect.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTreePath"><type>GtkTreePath</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>rect</para></entry>
<entry role="parameter_description"><para>rectangle to fill with cell rect. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-cell-rect.returns" role="returns">
<title>Returns</title>
<para> <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if there is no such item, <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> otherwise</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-select-path" role="function">
<title>gtk_icon_view_select_path&#160;()</title>
<indexterm zone="gtk-icon-view-select-path"><primary>gtk_icon_view_select_path</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_select_path (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                           <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>);</programlisting>
<para>Selects the row at <parameter>path</parameter>
.</para>
<refsect3 id="gtk-icon-view-select-path.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>The <link linkend="GtkTreePath"><type>GtkTreePath</type></link> to be selected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-unselect-path" role="function">
<title>gtk_icon_view_unselect_path&#160;()</title>
<indexterm zone="gtk-icon-view-unselect-path"><primary>gtk_icon_view_unselect_path</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_unselect_path (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                             <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>);</programlisting>
<para>Unselects the row at <parameter>path</parameter>
.</para>
<refsect3 id="gtk-icon-view-unselect-path.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>The <link linkend="GtkTreePath"><type>GtkTreePath</type></link> to be unselected.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-path-is-selected" role="function">
<title>gtk_icon_view_path_is_selected&#160;()</title>
<indexterm zone="gtk-icon-view-path-is-selected"><primary>gtk_icon_view_path_is_selected</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_icon_view_path_is_selected (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>);</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>
<refsect3 id="gtk-icon-view-path-is-selected.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkTreePath"><type>GtkTreePath</type></link> to check selection on.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-path-is-selected.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>path</parameter>
is selected.</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-selected-items" role="function">
<title>gtk_icon_view_get_selected_items&#160;()</title>
<indexterm zone="gtk-icon-view-get-selected-items"><primary>gtk_icon_view_get_selected_items</primary></indexterm>
<programlisting language="C"><link linkend="GList"><returnvalue>GList</returnvalue></link>&#160;*
gtk_icon_view_get_selected_items (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</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="GtkTreeRowReferences"><type>GtkTreeRowReferences</type></link>.
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:</para>
<informalexample><programlisting role="example"><![CDATA[
g_list_free_full (list, (GDestroyNotify) gtk_tree_path_free);
]]></programlisting></informalexample>
<para></para>
<refsect3 id="gtk-icon-view-get-selected-items.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-selected-items.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="GList"><type>GList</type></link> containing a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> for each selected row. </para>
<para><emphasis role="annotation">[<acronym>element-type</acronym> GtkTreePath][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-select-all" role="function">
<title>gtk_icon_view_select_all&#160;()</title>
<indexterm zone="gtk-icon-view-select-all"><primary>gtk_icon_view_select_all</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_select_all (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</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>
<refsect3 id="gtk-icon-view-select-all.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-unselect-all" role="function">
<title>gtk_icon_view_unselect_all&#160;()</title>
<indexterm zone="gtk-icon-view-unselect-all"><primary>gtk_icon_view_unselect_all</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_unselect_all (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</programlisting>
<para>Unselects all the icons.</para>
<refsect3 id="gtk-icon-view-unselect-all.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-item-activated" role="function">
<title>gtk_icon_view_item_activated&#160;()</title>
<indexterm zone="gtk-icon-view-item-activated"><primary>gtk_icon_view_item_activated</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_item_activated (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                              <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>);</programlisting>
<para>Activates the item determined by <parameter>path</parameter>
.</para>
<refsect3 id="gtk-icon-view-item-activated.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>The <link linkend="GtkTreePath"><type>GtkTreePath</type></link> to be activated</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-scroll-to-path" role="function">
<title>gtk_icon_view_scroll_to_path&#160;()</title>
<indexterm zone="gtk-icon-view-scroll-to-path"><primary>gtk_icon_view_scroll_to_path</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_scroll_to_path (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                              <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>,
                              <parameter><link linkend="gboolean"><type>gboolean</type></link> use_align</parameter>,
                              <parameter><link linkend="gfloat"><type>gfloat</type></link> row_align</parameter>,
                              <parameter><link linkend="gfloat"><type>gfloat</type></link> col_align</parameter>);</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>
<refsect3 id="gtk-icon-view-scroll-to-path.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>The path of the item to move to.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>use_align</para></entry>
<entry role="parameter_description"><para>whether to use alignment arguments, or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>row_align</para></entry>
<entry role="parameter_description"><para>The vertical alignment of the item specified by <parameter>path</parameter>
.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>col_align</para></entry>
<entry role="parameter_description"><para>The horizontal alignment of the item specified by <parameter>path</parameter>
.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-visible-range" role="function">
<title>gtk_icon_view_get_visible_range&#160;()</title>
<indexterm zone="gtk-icon-view-get-visible-range"><primary>gtk_icon_view_get_visible_range</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_icon_view_get_visible_range (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                 <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> **start_path</parameter>,
                                 <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> **end_path</parameter>);</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>
<refsect3 id="gtk-icon-view-get-visible-range.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>start_path</para></entry>
<entry role="parameter_description"><para>Return location for start of region,
or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>end_path</para></entry>
<entry role="parameter_description"><para>Return location for end of region, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-visible-range.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, if valid paths were placed in <parameter>start_path</parameter>
and <parameter>end_path</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-tooltip-item" role="function">
<title>gtk_icon_view_set_tooltip_item&#160;()</title>
<indexterm zone="gtk-icon-view-set-tooltip-item"><primary>gtk_icon_view_set_tooltip_item</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_tooltip_item (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                <parameter><link linkend="GtkTooltip"><type>GtkTooltip</type></link> *tooltip</parameter>,
                                <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>);</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>
<refsect3 id="gtk-icon-view-set-tooltip-item.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>tooltip</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTooltip"><type>GtkTooltip</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTreePath"><type>GtkTreePath</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-tooltip-cell" role="function">
<title>gtk_icon_view_set_tooltip_cell&#160;()</title>
<indexterm zone="gtk-icon-view-set-tooltip-cell"><primary>gtk_icon_view_set_tooltip_cell</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_tooltip_cell (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                <parameter><link linkend="GtkTooltip"><type>GtkTooltip</type></link> *tooltip</parameter>,
                                <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>,
                                <parameter><link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> *cell</parameter>);</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>
<refsect3 id="gtk-icon-view-set-tooltip-cell.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>tooltip</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTooltip"><type>GtkTooltip</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTreePath"><type>GtkTreePath</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cell</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkCellRenderer"><type>GtkCellRenderer</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-tooltip-context" role="function">
<title>gtk_icon_view_get_tooltip_context&#160;()</title>
<indexterm zone="gtk-icon-view-get-tooltip-context"><primary>gtk_icon_view_get_tooltip_context</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_icon_view_get_tooltip_context (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                   <parameter><link linkend="gint"><type>gint</type></link> *x</parameter>,
                                   <parameter><link linkend="gint"><type>gint</type></link> *y</parameter>,
                                   <parameter><link linkend="gboolean"><type>gboolean</type></link> keyboard_tip</parameter>,
                                   <parameter><link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> **model</parameter>,
                                   <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> **path</parameter>,
                                   <parameter><link linkend="GtkTreeIter"><type>GtkTreeIter</type></link> *iter</parameter>);</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.</para>
<refsect3 id="gtk-icon-view-get-tooltip-context.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>an <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x coordinate (relative to widget coordinates). </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>inout</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y coordinate (relative to widget coordinates). </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>inout</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>keyboard_tip</para></entry>
<entry role="parameter_description"><para>whether this is a keyboard tooltip or not</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>model</para></entry>
<entry role="parameter_description"><para>a pointer to receive a
<link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>][<acronym>transfer none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>a pointer to receive a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>iter</para></entry>
<entry role="parameter_description"><para>a pointer to receive a <link linkend="GtkTreeIter"><type>GtkTreeIter</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-tooltip-context.returns" role="returns">
<title>Returns</title>
<para> whether or not the given tooltip context points to an item</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-tooltip-column" role="function">
<title>gtk_icon_view_set_tooltip_column&#160;()</title>
<indexterm zone="gtk-icon-view-set-tooltip-column"><primary>gtk_icon_view_set_tooltip_column</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_tooltip_column (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                  <parameter><link linkend="gint"><type>gint</type></link> column</parameter>);</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>Note that the signal handler sets the text with <link linkend="gtk-tooltip-set-markup"><function>gtk_tooltip_set_markup()</function></link>,
so &amp;, &lt;, etc have to be escaped in the text.</para>
<refsect3 id="gtk-icon-view-set-tooltip-column.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>column</para></entry>
<entry role="parameter_description"><para>an integer, which is a valid column number for <parameter>icon_view</parameter>
’s model</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-tooltip-column" role="function">
<title>gtk_icon_view_get_tooltip_column&#160;()</title>
<indexterm zone="gtk-icon-view-get-tooltip-column"><primary>gtk_icon_view_get_tooltip_column</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_tooltip_column (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</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>
<refsect3 id="gtk-icon-view-get-tooltip-column.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-tooltip-column.returns" role="returns">
<title>Returns</title>
<para> the index of the tooltip column that is currently being
used, or -1 if this is disabled.</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-item-row" role="function">
<title>gtk_icon_view_get_item_row&#160;()</title>
<indexterm zone="gtk-icon-view-get-item-row"><primary>gtk_icon_view_get_item_row</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_item_row (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                            <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>);</programlisting>
<para>Gets the row in which the item <parameter>path</parameter>
 is currently
displayed. Row numbers start at 0.</para>
<refsect3 id="gtk-icon-view-get-item-row.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkTreePath"><type>GtkTreePath</type></link> of the item</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-item-row.returns" role="returns">
<title>Returns</title>
<para> The row in which the item is displayed</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-item-column" role="function">
<title>gtk_icon_view_get_item_column&#160;()</title>
<indexterm zone="gtk-icon-view-get-item-column"><primary>gtk_icon_view_get_item_column</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_icon_view_get_item_column (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                               <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>);</programlisting>
<para>Gets the column in which the item <parameter>path</parameter>
 is currently
displayed. Column numbers start at 0.</para>
<refsect3 id="gtk-icon-view-get-item-column.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkTreePath"><type>GtkTreePath</type></link> of the item</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-item-column.returns" role="returns">
<title>Returns</title>
<para> The column in which the item is displayed</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-enable-model-drag-source" role="function">
<title>gtk_icon_view_enable_model_drag_source&#160;()</title>
<indexterm zone="gtk-icon-view-enable-model-drag-source"><primary>gtk_icon_view_enable_model_drag_source</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_enable_model_drag_source
                               (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                <parameter><link linkend="GdkModifierType"><type>GdkModifierType</type></link> start_button_mask</parameter>,
                                <parameter><link linkend="GdkContentFormats"><type>GdkContentFormats</type></link> *formats</parameter>,
                                <parameter><link linkend="GdkDragAction"><type>GdkDragAction</type></link> actions</parameter>);</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>
<refsect3 id="gtk-icon-view-enable-model-drag-source.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>start_button_mask</para></entry>
<entry role="parameter_description"><para>Mask of allowed buttons to start drag</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>formats</para></entry>
<entry role="parameter_description"><para>the formats that the drag will support</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>actions</para></entry>
<entry role="parameter_description"><para>the bitmask of possible actions for a drag from this
widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-enable-model-drag-dest" role="function">
<title>gtk_icon_view_enable_model_drag_dest&#160;()</title>
<indexterm zone="gtk-icon-view-enable-model-drag-dest"><primary>gtk_icon_view_enable_model_drag_dest</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_enable_model_drag_dest (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                      <parameter><link linkend="GdkContentFormats"><type>GdkContentFormats</type></link> *formats</parameter>,
                                      <parameter><link linkend="GdkDragAction"><type>GdkDragAction</type></link> actions</parameter>);</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>
<refsect3 id="gtk-icon-view-enable-model-drag-dest.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>formats</para></entry>
<entry role="parameter_description"><para>the formats that the drag will support</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>actions</para></entry>
<entry role="parameter_description"><para>the bitmask of possible actions for a drag to this
widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-unset-model-drag-source" role="function">
<title>gtk_icon_view_unset_model_drag_source&#160;()</title>
<indexterm zone="gtk-icon-view-unset-model-drag-source"><primary>gtk_icon_view_unset_model_drag_source</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_unset_model_drag_source (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</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>
<refsect3 id="gtk-icon-view-unset-model-drag-source.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-unset-model-drag-dest" role="function">
<title>gtk_icon_view_unset_model_drag_dest&#160;()</title>
<indexterm zone="gtk-icon-view-unset-model-drag-dest"><primary>gtk_icon_view_unset_model_drag_dest</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_unset_model_drag_dest (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</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>
<refsect3 id="gtk-icon-view-unset-model-drag-dest.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-reorderable" role="function">
<title>gtk_icon_view_set_reorderable&#160;()</title>
<indexterm zone="gtk-icon-view-set-reorderable"><primary>gtk_icon_view_set_reorderable</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_reorderable (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                               <parameter><link linkend="gboolean"><type>gboolean</type></link> reorderable</parameter>);</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>
<refsect3 id="gtk-icon-view-set-reorderable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkIconView"><type>GtkIconView</type></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>reorderable</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, if the list of items can be reordered.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-reorderable" role="function">
<title>gtk_icon_view_get_reorderable&#160;()</title>
<indexterm zone="gtk-icon-view-get-reorderable"><primary>gtk_icon_view_get_reorderable</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_icon_view_get_reorderable (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>);</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>
<refsect3 id="gtk-icon-view-get-reorderable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-reorderable.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the list can be reordered.</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-set-drag-dest-item" role="function">
<title>gtk_icon_view_set_drag_dest_item&#160;()</title>
<indexterm zone="gtk-icon-view-set-drag-dest-item"><primary>gtk_icon_view_set_drag_dest_item</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_set_drag_dest_item (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                  <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>,
                                  <parameter><link linkend="GtkIconViewDropPosition"><type>GtkIconViewDropPosition</type></link> pos</parameter>);</programlisting>
<para>Sets the item that is highlighted for feedback.</para>
<refsect3 id="gtk-icon-view-set-drag-dest-item.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>The path of the item to highlight, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>pos</para></entry>
<entry role="parameter_description"><para>Specifies where to drop, relative to the item</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-drag-dest-item" role="function">
<title>gtk_icon_view_get_drag_dest_item&#160;()</title>
<indexterm zone="gtk-icon-view-get-drag-dest-item"><primary>gtk_icon_view_get_drag_dest_item</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_icon_view_get_drag_dest_item (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                  <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> **path</parameter>,
                                  <parameter><link linkend="GtkIconViewDropPosition"><type>GtkIconViewDropPosition</type></link> *pos</parameter>);</programlisting>
<para>Gets information about the item that is highlighted for feedback.</para>
<refsect3 id="gtk-icon-view-get-drag-dest-item.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>Return location for the path of
the highlighted item, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>pos</para></entry>
<entry role="parameter_description"><para>Return location for the drop position, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-get-dest-item-at-pos" role="function">
<title>gtk_icon_view_get_dest_item_at_pos&#160;()</title>
<indexterm zone="gtk-icon-view-get-dest-item-at-pos"><primary>gtk_icon_view_get_dest_item_at_pos</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_icon_view_get_dest_item_at_pos (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                    <parameter><link linkend="gint"><type>gint</type></link> drag_x</parameter>,
                                    <parameter><link linkend="gint"><type>gint</type></link> drag_y</parameter>,
                                    <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> **path</parameter>,
                                    <parameter><link linkend="GtkIconViewDropPosition"><type>GtkIconViewDropPosition</type></link> *pos</parameter>);</programlisting>
<para>Determines the destination item for a given position.</para>
<refsect3 id="gtk-icon-view-get-dest-item-at-pos.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>drag_x</para></entry>
<entry role="parameter_description"><para>the position to determine the destination item for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>drag_y</para></entry>
<entry role="parameter_description"><para>the position to determine the destination item for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>Return location for the path of the item,
or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>pos</para></entry>
<entry role="parameter_description"><para>Return location for the drop position, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-get-dest-item-at-pos.returns" role="returns">
<title>Returns</title>
<para> whether there is an item at the given position.</para>
</refsect3></refsect2>
<refsect2 id="gtk-icon-view-create-drag-icon" role="function">
<title>gtk_icon_view_create_drag_icon&#160;()</title>
<indexterm zone="gtk-icon-view-create-drag-icon"><primary>gtk_icon_view_create_drag_icon</primary></indexterm>
<programlisting language="C"><link linkend="GdkPaintable"><returnvalue>GdkPaintable</returnvalue></link>&#160;*
gtk_icon_view_create_drag_icon (<parameter><link linkend="GtkIconView"><type>GtkIconView</type></link> *icon_view</parameter>,
                                <parameter><link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path</parameter>);</programlisting>
<para>Creates a <link linkend="cairo-surface-t"><type>cairo_surface_t</type></link> representation of the item at <parameter>path</parameter>
.  
This image is used for a drag icon.</para>
<refsect3 id="gtk-icon-view-create-drag-icon.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>icon_view</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkIconView"><type>GtkIconView</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> in <parameter>icon_view</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-icon-view-create-drag-icon.returns" role="returns">
<title>Returns</title>
<para>a newly-allocated surface of the drag icon. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkIconView.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkIconView-struct" role="struct">
<title>GtkIconView</title>
<indexterm zone="GtkIconView-struct"><primary>GtkIconView</primary></indexterm>
<programlisting language="C">typedef struct _GtkIconView GtkIconView;</programlisting>
</refsect2>
<refsect2 id="GtkIconViewDropPosition" role="enum">
<title>enum GtkIconViewDropPosition</title>
<indexterm zone="GtkIconViewDropPosition"><primary>GtkIconViewDropPosition</primary></indexterm>
<para>An enum for determining where a dropped item goes.</para>
<refsect3 id="GtkIconViewDropPosition.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ICON-VIEW-NO-DROP:CAPS">GTK_ICON_VIEW_NO_DROP</para></entry>
<entry role="enum_member_description"><para>no drop possible</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ICON-VIEW-DROP-INTO:CAPS">GTK_ICON_VIEW_DROP_INTO</para></entry>
<entry role="enum_member_description"><para>dropped item replaces the item</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ICON-VIEW-DROP-LEFT:CAPS">GTK_ICON_VIEW_DROP_LEFT</para></entry>
<entry role="enum_member_description"><para>droppped item is inserted to the left</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ICON-VIEW-DROP-RIGHT:CAPS">GTK_ICON_VIEW_DROP_RIGHT</para></entry>
<entry role="enum_member_description"><para>dropped item is inserted to the right</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ICON-VIEW-DROP-ABOVE:CAPS">GTK_ICON_VIEW_DROP_ABOVE</para></entry>
<entry role="enum_member_description"><para>dropped item is inserted above</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ICON-VIEW-DROP-BELOW:CAPS">GTK_ICON_VIEW_DROP_BELOW</para></entry>
<entry role="enum_member_description"><para>dropped item is inserted below</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkIconView.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkIconView--activate-on-single-click" role="property"><title>The <literal>“activate-on-single-click”</literal> property</title>
<indexterm zone="GtkIconView--activate-on-single-click"><primary>GtkIconView:activate-on-single-click</primary></indexterm>
<programlisting>  “activate-on-single-click” <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>The activate-on-single-click property specifies whether the "item-activated" signal
will be emitted after a single click.</para>
<para>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkIconView--cell-area" role="property"><title>The <literal>“cell-area”</literal> property</title>
<indexterm zone="GtkIconView--cell-area"><primary>GtkIconView:cell-area</primary></indexterm>
<programlisting>  “cell-area”                <link linkend="GtkCellArea"><type>GtkCellArea</type></link>&#160;*</programlisting>
<para>The <link linkend="GtkCellArea"><type>GtkCellArea</type></link> used to layout cell renderers for this view.</para>
<para>If no area is specified when creating the icon view with <link linkend="gtk-icon-view-new-with-area"><function>gtk_icon_view_new_with_area()</function></link>

a <link linkend="GtkCellAreaBox"><type>GtkCellAreaBox</type></link> will be used.</para>
<para>Owner: GtkIconView</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
</refsect2>
<refsect2 id="GtkIconView--column-spacing" role="property"><title>The <literal>“column-spacing”</literal> property</title>
<indexterm zone="GtkIconView--column-spacing"><primary>GtkIconView:column-spacing</primary></indexterm>
<programlisting>  “column-spacing”           <link linkend="gint"><type>gint</type></link></programlisting>
<para>The column-spacing property specifies the space which is inserted between
the columns of the icon view.</para>
<para>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 6</para>
</refsect2>
<refsect2 id="GtkIconView--columns" role="property"><title>The <literal>“columns”</literal> property</title>
<indexterm zone="GtkIconView--columns"><primary>GtkIconView:columns</primary></indexterm>
<programlisting>  “columns”                  <link linkend="gint"><type>gint</type></link></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>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkIconView--item-orientation" role="property"><title>The <literal>“item-orientation”</literal> property</title>
<indexterm zone="GtkIconView--item-orientation"><primary>GtkIconView:item-orientation</primary></indexterm>
<programlisting>  “item-orientation”         <link linkend="GtkOrientation"><type>GtkOrientation</type></link></programlisting>
<para>The item-orientation property specifies how the cells (i.e. the icon and
the text) of the item are positioned relative to each other.</para>
<para>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_ORIENTATION_VERTICAL</para>
</refsect2>
<refsect2 id="GtkIconView--item-padding" role="property"><title>The <literal>“item-padding”</literal> property</title>
<indexterm zone="GtkIconView--item-padding"><primary>GtkIconView:item-padding</primary></indexterm>
<programlisting>  “item-padding”             <link linkend="gint"><type>gint</type></link></programlisting>
<para>The item-padding property specifies the padding around each
of the icon view's item.</para>
<para>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 6</para>
</refsect2>
<refsect2 id="GtkIconView--item-width" role="property"><title>The <literal>“item-width”</literal> property</title>
<indexterm zone="GtkIconView--item-width"><primary>GtkIconView:item-width</primary></indexterm>
<programlisting>  “item-width”               <link linkend="gint"><type>gint</type></link></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>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkIconView--margin" role="property"><title>The <literal>“margin”</literal> property</title>
<indexterm zone="GtkIconView--margin"><primary>GtkIconView:margin</primary></indexterm>
<programlisting>  “margin”                   <link linkend="gint"><type>gint</type></link></programlisting>
<para>The margin property specifies the space which is inserted

at the edges of the icon view.</para>
<para>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 6</para>
</refsect2>
<refsect2 id="GtkIconView--markup-column" role="property"><title>The <literal>“markup-column”</literal> property</title>
<indexterm zone="GtkIconView--markup-column"><primary>GtkIconView:markup-column</primary></indexterm>
<programlisting>  “markup-column”            <link linkend="gint"><type>gint</type></link></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>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkIconView--model" role="property"><title>The <literal>“model”</literal> property</title>
<indexterm zone="GtkIconView--model"><primary>GtkIconView:model</primary></indexterm>
<programlisting>  “model”                    <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>&#160;*</programlisting>
<para>The model for the icon view.</para><para>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkIconView--pixbuf-column" role="property"><title>The <literal>“pixbuf-column”</literal> property</title>
<indexterm zone="GtkIconView--pixbuf-column"><primary>GtkIconView:pixbuf-column</primary></indexterm>
<programlisting>  “pixbuf-column”            <link linkend="gint"><type>gint</type></link></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>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkIconView--reorderable" role="property"><title>The <literal>“reorderable”</literal> property</title>
<indexterm zone="GtkIconView--reorderable"><primary>GtkIconView:reorderable</primary></indexterm>
<programlisting>  “reorderable”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>The reorderable property specifies if the items can be reordered
by DND.</para>
<para>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkIconView--row-spacing" role="property"><title>The <literal>“row-spacing”</literal> property</title>
<indexterm zone="GtkIconView--row-spacing"><primary>GtkIconView:row-spacing</primary></indexterm>
<programlisting>  “row-spacing”              <link linkend="gint"><type>gint</type></link></programlisting>
<para>The row-spacing property specifies the space which is inserted between
the rows of the icon view.</para>
<para>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 6</para>
</refsect2>
<refsect2 id="GtkIconView--selection-mode" role="property"><title>The <literal>“selection-mode”</literal> property</title>
<indexterm zone="GtkIconView--selection-mode"><primary>GtkIconView:selection-mode</primary></indexterm>
<programlisting>  “selection-mode”           <link linkend="GtkSelectionMode"><type>GtkSelectionMode</type></link></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>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_SELECTION_SINGLE</para>
</refsect2>
<refsect2 id="GtkIconView--spacing" role="property"><title>The <literal>“spacing”</literal> property</title>
<indexterm zone="GtkIconView--spacing"><primary>GtkIconView:spacing</primary></indexterm>
<programlisting>  “spacing”                  <link linkend="gint"><type>gint</type></link></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>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkIconView--text-column" role="property"><title>The <literal>“text-column”</literal> property</title>
<indexterm zone="GtkIconView--text-column"><primary>GtkIconView:text-column</primary></indexterm>
<programlisting>  “text-column”              <link linkend="gint"><type>gint</type></link></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>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkIconView--tooltip-column" role="property"><title>The <literal>“tooltip-column”</literal> property</title>
<indexterm zone="GtkIconView--tooltip-column"><primary>GtkIconView:tooltip-column</primary></indexterm>
<programlisting>  “tooltip-column”           <link linkend="gint"><type>gint</type></link></programlisting>
<para>The column in the model containing the tooltip texts for the items.</para><para>Owner: GtkIconView</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</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>“activate-cursor-item”</literal> signal</title>
<indexterm zone="GtkIconView-activate-cursor-item"><primary>GtkIconView::activate-cursor-item</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
user_function (<link linkend="GtkIconView"><type>GtkIconView</type></link> *iconview,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para>A <link linkend="GtkBindingSignal">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>
<refsect3 id="GtkIconView-activate-cursor-item.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>iconview</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkIconView-item-activated" role="signal"><title>The <literal>“item-activated”</literal> signal</title>
<indexterm zone="GtkIconView-item-activated"><primary>GtkIconView::item-activated</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkIconView"><type>GtkIconView</type></link> *iconview,
               <link linkend="GtkTreePath"><type>GtkTreePath</type></link> *path,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</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, when the user double
clicks an item with the "activate-on-single-click" property set
to <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>, or when the user single clicks an item when the
"activate-on-single-click" property set to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>. It is also
emitted when a non-editable item is selected and one of the keys:
Space, Return or Enter is pressed.</para>
<refsect3 id="GtkIconView-item-activated.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>iconview</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkTreePath"><type>GtkTreePath</type></link> for the activated item</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GtkIconView-move-cursor" role="signal"><title>The <literal>“move-cursor”</literal> signal</title>
<indexterm zone="GtkIconView-move-cursor"><primary>GtkIconView::move-cursor</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
user_function (<link linkend="GtkIconView"><type>GtkIconView</type></link>    *iconview,
               <link linkend="GtkMovementStep"><type>GtkMovementStep</type></link> step,
               <link linkend="gint"><type>gint</type></link>            count,
               <link linkend="gboolean"><type>gboolean</type></link>        extend,
               <link linkend="gboolean"><type>gboolean</type></link>        modify,
               <link linkend="gpointer"><type>gpointer</type></link>        user_data)</programlisting>
<para>The ::move-cursor signal is a
<link linkend="GtkBindingSignal">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</para>
<itemizedlist>
<listitem><para>Arrow keys which move by individual steps</para></listitem>
<listitem><para>Home/End keys which move to the first/last item</para></listitem>
<listitem><para>PageUp/PageDown which move by "pages"
All of these will extend the selection when combined with
the Shift modifier.</para></listitem>
</itemizedlist>
<refsect3 id="GtkIconView-move-cursor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>iconview</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>step</para></entry>
<entry role="parameter_description"><para>the granularity of the move, as a <link linkend="GtkMovementStep"><type>GtkMovementStep</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>count</para></entry>
<entry role="parameter_description"><para>the number of <parameter>step</parameter>
units to move</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>extend</para></entry>
<entry role="parameter_description"><para>whether to extend the selection</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>modify</para></entry>
<entry role="parameter_description"><para>whether to modify the selection</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkIconView-select-all" role="signal"><title>The <literal>“select-all”</literal> signal</title>
<indexterm zone="GtkIconView-select-all"><primary>GtkIconView::select-all</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkIconView"><type>GtkIconView</type></link> *iconview,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para>A <link linkend="GtkBindingSignal">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>
<refsect3 id="GtkIconView-select-all.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>iconview</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkIconView-select-cursor-item" role="signal"><title>The <literal>“select-cursor-item”</literal> signal</title>
<indexterm zone="GtkIconView-select-cursor-item"><primary>GtkIconView::select-cursor-item</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkIconView"><type>GtkIconView</type></link> *iconview,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para>A <link linkend="GtkBindingSignal">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>
<refsect3 id="GtkIconView-select-cursor-item.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>iconview</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkIconView-selection-changed" role="signal"><title>The <literal>“selection-changed”</literal> signal</title>
<indexterm zone="GtkIconView-selection-changed"><primary>GtkIconView::selection-changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkIconView"><type>GtkIconView</type></link> *iconview,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para>The ::selection-changed signal is emitted when the selection
(i.e. the set of selected items) changes.</para>
<refsect3 id="GtkIconView-selection-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>iconview</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkIconView-toggle-cursor-item" role="signal"><title>The <literal>“toggle-cursor-item”</literal> signal</title>
<indexterm zone="GtkIconView-toggle-cursor-item"><primary>GtkIconView::toggle-cursor-item</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkIconView"><type>GtkIconView</type></link> *iconview,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para>A <link linkend="GtkBindingSignal">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>
<refsect3 id="GtkIconView-toggle-cursor-item.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>iconview</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkIconView-unselect-all" role="signal"><title>The <literal>“unselect-all”</literal> signal</title>
<indexterm zone="GtkIconView-unselect-all"><primary>GtkIconView::unselect-all</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkIconView"><type>GtkIconView</type></link> *iconview,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para>A <link linkend="GtkBindingSignal">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>
<refsect3 id="GtkIconView-unselect-all.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>iconview</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2>
</refsect1>

</refentry>
