gtk3/docs/reference/gtk/html/GtkIconView.html
2017-12-21 20:47:04 -05:00

3804 lines
200 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkIconView: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="prev" href="GtkCellView.html" title="GtkCellView">
<link rel="next" href="GtkTreeSortable.html" title="GtkTreeSortable">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
<a href="#GtkIconView.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
<a href="#GtkIconView.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
<a href="#GtkIconView.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
<a href="#GtkIconView.properties" class="shortcut">Properties</a></span><span id="nav_style_properties">  <span class="dim">|</span> 
<a href="#GtkIconView.style-properties" class="shortcut">Style Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
<a href="#GtkIconView.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="TreeWidgetObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GtkCellView.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GtkTreeSortable.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GtkIconView"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkIconView.top_of_page"></a>GtkIconView</span></h2>
<p>GtkIconView — A widget which displays a list of icons in a grid</p>
</td>
<td class="gallery_image" valign="top" align="right"><img src="icon-view.png"></td>
</tr></table></div>
<div class="refsect1">
<a name="GtkIconView.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<span class="c_punctuation">(</span><a class="link" href="GtkIconView.html#GtkIconViewForeachFunc" title="GtkIconViewForeachFunc ()">*GtkIconViewForeachFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-new" title="gtk_icon_view_new ()">gtk_icon_view_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-new-with-area" title="gtk_icon_view_new_with_area ()">gtk_icon_view_new_with_area</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-new-with-model" title="gtk_icon_view_new_with_model ()">gtk_icon_view_new_with_model</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-model" title="gtk_icon_view_set_model ()">gtk_icon_view_set_model</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="returnvalue">GtkTreeModel</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-model" title="gtk_icon_view_get_model ()">gtk_icon_view_get_model</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-text-column" title="gtk_icon_view_set_text_column ()">gtk_icon_view_set_text_column</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-text-column" title="gtk_icon_view_get_text_column ()">gtk_icon_view_get_text_column</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-markup-column" title="gtk_icon_view_set_markup_column ()">gtk_icon_view_set_markup_column</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-markup-column" title="gtk_icon_view_get_markup_column ()">gtk_icon_view_get_markup_column</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-pixbuf-column" title="gtk_icon_view_set_pixbuf_column ()">gtk_icon_view_set_pixbuf_column</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-pixbuf-column" title="gtk_icon_view_get_pixbuf_column ()">gtk_icon_view_get_pixbuf_column</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="returnvalue">GtkTreePath</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-path-at-pos" title="gtk_icon_view_get_path_at_pos ()">gtk_icon_view_get_path_at_pos</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-item-at-pos" title="gtk_icon_view_get_item_at_pos ()">gtk_icon_view_get_item_at_pos</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-convert-widget-to-bin-window-coords" title="gtk_icon_view_convert_widget_to_bin_window_coords ()">gtk_icon_view_convert_widget_to_bin_window_coords</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-cursor" title="gtk_icon_view_set_cursor ()">gtk_icon_view_set_cursor</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-cursor" title="gtk_icon_view_get_cursor ()">gtk_icon_view_get_cursor</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-selected-foreach" title="gtk_icon_view_selected_foreach ()">gtk_icon_view_selected_foreach</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-selection-mode" title="gtk_icon_view_set_selection_mode ()">gtk_icon_view_set_selection_mode</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="gtk3-Standard-Enumerations.html#GtkSelectionMode" title="enum GtkSelectionMode"><span class="returnvalue">GtkSelectionMode</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-selection-mode" title="gtk_icon_view_get_selection_mode ()">gtk_icon_view_get_selection_mode</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-item-orientation" title="gtk_icon_view_set_item_orientation ()">gtk_icon_view_set_item_orientation</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="returnvalue">GtkOrientation</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-item-orientation" title="gtk_icon_view_get_item_orientation ()">gtk_icon_view_get_item_orientation</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-columns" title="gtk_icon_view_set_columns ()">gtk_icon_view_set_columns</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-columns" title="gtk_icon_view_get_columns ()">gtk_icon_view_get_columns</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-item-width" title="gtk_icon_view_set_item_width ()">gtk_icon_view_set_item_width</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-item-width" title="gtk_icon_view_get_item_width ()">gtk_icon_view_get_item_width</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-spacing" title="gtk_icon_view_set_spacing ()">gtk_icon_view_set_spacing</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-spacing" title="gtk_icon_view_get_spacing ()">gtk_icon_view_get_spacing</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-row-spacing" title="gtk_icon_view_set_row_spacing ()">gtk_icon_view_set_row_spacing</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-row-spacing" title="gtk_icon_view_get_row_spacing ()">gtk_icon_view_get_row_spacing</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-column-spacing" title="gtk_icon_view_set_column_spacing ()">gtk_icon_view_set_column_spacing</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-column-spacing" title="gtk_icon_view_get_column_spacing ()">gtk_icon_view_get_column_spacing</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-margin" title="gtk_icon_view_set_margin ()">gtk_icon_view_set_margin</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-margin" title="gtk_icon_view_get_margin ()">gtk_icon_view_get_margin</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-item-padding" title="gtk_icon_view_set_item_padding ()">gtk_icon_view_set_item_padding</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-item-padding" title="gtk_icon_view_get_item_padding ()">gtk_icon_view_get_item_padding</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-activate-on-single-click" title="gtk_icon_view_set_activate_on_single_click ()">gtk_icon_view_set_activate_on_single_click</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-activate-on-single-click" title="gtk_icon_view_get_activate_on_single_click ()">gtk_icon_view_get_activate_on_single_click</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-cell-rect" title="gtk_icon_view_get_cell_rect ()">gtk_icon_view_get_cell_rect</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-select-path" title="gtk_icon_view_select_path ()">gtk_icon_view_select_path</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-unselect-path" title="gtk_icon_view_unselect_path ()">gtk_icon_view_unselect_path</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-path-is-selected" title="gtk_icon_view_path_is_selected ()">gtk_icon_view_path_is_selected</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-selected-items" title="gtk_icon_view_get_selected_items ()">gtk_icon_view_get_selected_items</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-select-all" title="gtk_icon_view_select_all ()">gtk_icon_view_select_all</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-unselect-all" title="gtk_icon_view_unselect_all ()">gtk_icon_view_unselect_all</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-item-activated" title="gtk_icon_view_item_activated ()">gtk_icon_view_item_activated</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-scroll-to-path" title="gtk_icon_view_scroll_to_path ()">gtk_icon_view_scroll_to_path</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-visible-range" title="gtk_icon_view_get_visible_range ()">gtk_icon_view_get_visible_range</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-tooltip-item" title="gtk_icon_view_set_tooltip_item ()">gtk_icon_view_set_tooltip_item</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-tooltip-cell" title="gtk_icon_view_set_tooltip_cell ()">gtk_icon_view_set_tooltip_cell</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-tooltip-context" title="gtk_icon_view_get_tooltip_context ()">gtk_icon_view_get_tooltip_context</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-tooltip-column" title="gtk_icon_view_set_tooltip_column ()">gtk_icon_view_set_tooltip_column</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-tooltip-column" title="gtk_icon_view_get_tooltip_column ()">gtk_icon_view_get_tooltip_column</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-item-row" title="gtk_icon_view_get_item_row ()">gtk_icon_view_get_item_row</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-item-column" title="gtk_icon_view_get_item_column ()">gtk_icon_view_get_item_column</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-enable-model-drag-source" title="gtk_icon_view_enable_model_drag_source ()">gtk_icon_view_enable_model_drag_source</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-enable-model-drag-dest" title="gtk_icon_view_enable_model_drag_dest ()">gtk_icon_view_enable_model_drag_dest</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-unset-model-drag-source" title="gtk_icon_view_unset_model_drag_source ()">gtk_icon_view_unset_model_drag_source</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-unset-model-drag-dest" title="gtk_icon_view_unset_model_drag_dest ()">gtk_icon_view_unset_model_drag_dest</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-reorderable" title="gtk_icon_view_set_reorderable ()">gtk_icon_view_set_reorderable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-reorderable" title="gtk_icon_view_get_reorderable ()">gtk_icon_view_get_reorderable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-set-drag-dest-item" title="gtk_icon_view_set_drag_dest_item ()">gtk_icon_view_set_drag_dest_item</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-drag-dest-item" title="gtk_icon_view_get_drag_dest_item ()">gtk_icon_view_get_drag_dest_item</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-get-dest-item-at-pos" title="gtk_icon_view_get_dest_item_at_pos ()">gtk_icon_view_get_dest_item_at_pos</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">cairo_surface_t</span> *
</td>
<td class="function_name">
<a class="link" href="GtkIconView.html#gtk-icon-view-create-drag-icon" title="gtk_icon_view_create_drag_icon ()">gtk_icon_view_create_drag_icon</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkIconView.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--activate-on-single-click" title="The “activate-on-single-click” property">activate-on-single-click</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *</td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--cell-area" title="The “cell-area” property">cell-area</a></td>
<td class="property_flags">Read / Write / Construct Only</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--column-spacing" title="The “column-spacing” property">column-spacing</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--columns" title="The “columns” property">columns</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--item-orientation" title="The “item-orientation” property">item-orientation</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--item-padding" title="The “item-padding” property">item-padding</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--item-width" title="The “item-width” property">item-width</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--margin" title="The “margin” property">margin</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--markup-column" title="The “markup-column” property">markup-column</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *</td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--model" title="The “model” property">model</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--pixbuf-column" title="The “pixbuf-column” property">pixbuf-column</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--reorderable" title="The “reorderable” property">reorderable</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--row-spacing" title="The “row-spacing” property">row-spacing</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="gtk3-Standard-Enumerations.html#GtkSelectionMode" title="enum GtkSelectionMode"><span class="type">GtkSelectionMode</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--selection-mode" title="The “selection-mode” property">selection-mode</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--spacing" title="The “spacing” property">spacing</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--text-column" title="The “text-column” property">text-column</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--tooltip-column" title="The “tooltip-column” property">tooltip-column</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkIconView.style-properties"></a><h2>Style Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="style_properties_type">
<col width="300px" class="style_properties_name">
<col width="200px" class="style_properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a></td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--s-selection-box-alpha" title="The “selection-box-alpha” style property">selection-box-alpha</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<td class="property_name"><a class="link" href="GtkIconView.html#GtkIconView--s-selection-box-color" title="The “selection-box-color” style property">selection-box-color</a></td>
<td class="property_flags">Read</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkIconView.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signals_return">
<col width="300px" class="signals_name">
<col width="200px" class="signals_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
<td class="signal_name"><a class="link" href="GtkIconView.html#GtkIconView-activate-cursor-item" title="The “activate-cursor-item” signal">activate-cursor-item</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkIconView.html#GtkIconView-item-activated" title="The “item-activated” signal">item-activated</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
</tr>
<tr>
<td class="signal_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
<td class="signal_name"><a class="link" href="GtkIconView.html#GtkIconView-move-cursor" title="The “move-cursor” signal">move-cursor</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkIconView.html#GtkIconView-select-all" title="The “select-all” signal">select-all</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkIconView.html#GtkIconView-select-cursor-item" title="The “select-cursor-item” signal">select-cursor-item</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkIconView.html#GtkIconView-selection-changed" title="The “selection-changed” signal">selection-changed</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkIconView.html#GtkIconView-toggle-cursor-item" title="The “toggle-cursor-item” signal">toggle-cursor-item</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkIconView.html#GtkIconView-unselect-all" title="The “unselect-all” signal">unselect-all</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkIconView.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkIconView.html#GtkIconView-struct" title="struct GtkIconView">GtkIconView</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GtkIconView.html#GtkIconViewDropPosition" title="enum GtkIconViewDropPosition">GtkIconViewDropPosition</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkIconView.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
<span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
<span class="lineart">╰──</span> GtkIconView
</pre>
</div>
<div class="refsect1">
<a name="GtkIconView.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkIconView implements
AtkImplementorIface, <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>, <a class="link" href="GtkCellLayout.html" title="GtkCellLayout">GtkCellLayout</a> and <a class="link" href="GtkScrollable.html" title="GtkScrollable">GtkScrollable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkIconView.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GtkIconView.description"></a><h2>Description</h2>
<p><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> provides an alternative view on a <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>.
It displays the model as a grid of icons with labels. Like
<a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>, it allows to select one or multiple items
(depending on the selection mode, see <a class="link" href="GtkIconView.html#gtk-icon-view-set-selection-mode" title="gtk_icon_view_set_selection_mode ()"><code class="function">gtk_icon_view_set_selection_mode()</code></a>).
In addition to selection with the arrow keys, <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> supports
rubberband selection, which is controlled by dragging the pointer.</p>
<p>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),
<a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> will only display the first level of the tree and
ignore the trees branches.</p>
<div class="refsect2">
<a name="id-1.3.12.9.11.4"></a><h3>CSS nodes</h3>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2</pre></td>
<td class="listing_code"><pre class="programlisting">iconview<span class="gtkdoc opt">.</span>view
╰── <span class="gtkdoc opt">[</span>rubberband<span class="gtkdoc opt">]</span></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<p>GtkIconView has a single CSS node with name iconview and style class .view.
For rubberband selection, a subnode with name rubberband is used.</p>
</div>
</div>
<div class="refsect1">
<a name="GtkIconView.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="GtkIconViewForeachFunc"></a><h3>GtkIconViewForeachFunc ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
<span class="c_punctuation">(</span>*GtkIconViewForeachFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
<p>A function used by <a class="link" href="GtkIconView.html#gtk-icon-view-selected-foreach" title="gtk_icon_view_selected_foreach ()"><code class="function">gtk_icon_view_selected_foreach()</code></a> to map all
selected rows. It will be called on every selected row in the view.</p>
<div class="refsect3">
<a name="GtkIconViewForeachFunc.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>The <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> of a selected row</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p> user data. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-new"></a><h3>gtk_icon_view_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_icon_view_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Creates a new <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> widget</p>
<div class="refsect3">
<a name="gtk-icon-view-new.returns"></a><h4>Returns</h4>
<p> A newly created <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> widget</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-new-with-area"></a><h3>gtk_icon_view_new_with_area ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_icon_view_new_with_area (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> widget using the
specified <em class="parameter"><code>area</code></em>
to layout cells inside the icons.</p>
<div class="refsect3">
<a name="gtk-icon-view-new-with-area.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>area</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> to use to layout cells</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-new-with-area.returns"></a><h4>Returns</h4>
<p> A newly created <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> widget</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-new-with-model"></a><h3>gtk_icon_view_new_with_model ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_icon_view_new_with_model (<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);</pre>
<p>Creates a new <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> widget with the model <em class="parameter"><code>model</code></em>
.</p>
<div class="refsect3">
<a name="gtk-icon-view-new-with-model.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>model</p></td>
<td class="parameter_description"><p>The model.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-new-with-model.returns"></a><h4>Returns</h4>
<p> A newly created <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> widget.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-model"></a><h3>gtk_icon_view_set_model ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_model (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);</pre>
<p>Sets the model for a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.
If the <em class="parameter"><code>icon_view</code></em>
already has a model set, it will remove
it before setting the new model. If <em class="parameter"><code>model</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
it will unset the old model.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-model.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>model</p></td>
<td class="parameter_description"><p> The model. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-model"></a><h3>gtk_icon_view_get_model ()</h3>
<pre class="programlisting"><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="returnvalue">GtkTreeModel</span></a> *
gtk_icon_view_get_model (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the model the <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> is based on. Returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the
model is unset.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-model.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-model.returns"></a><h4>Returns</h4>
<p> A <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none is
currently being used. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-text-column"></a><h3>gtk_icon_view_set_text_column ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_text_column (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>);</pre>
<p>Sets the column with text for <em class="parameter"><code>icon_view</code></em>
to be <em class="parameter"><code>column</code></em>
. The text
column must be of type <a href="../gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><span class="type">G_TYPE_STRING</span></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-text-column.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>column</p></td>
<td class="parameter_description"><p>A column in the currently used model, or -1 to display no text</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-text-column"></a><h3>gtk_icon_view_get_text_column ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_text_column (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the column with text for <em class="parameter"><code>icon_view</code></em>
.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-text-column.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-text-column.returns"></a><h4>Returns</h4>
<p> the text column, or -1 if its unset.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-markup-column"></a><h3>gtk_icon_view_set_markup_column ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_markup_column (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>);</pre>
<p>Sets the column with markup information for <em class="parameter"><code>icon_view</code></em>
to be
<em class="parameter"><code>column</code></em>
. The markup column must be of type <a href="../gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><span class="type">G_TYPE_STRING</span></a>.
If the markup column is set to something, it overrides
the text column set by <a class="link" href="GtkIconView.html#gtk-icon-view-set-text-column" title="gtk_icon_view_set_text_column ()"><code class="function">gtk_icon_view_set_text_column()</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-markup-column.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>column</p></td>
<td class="parameter_description"><p>A column in the currently used model, or -1 to display no text</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-markup-column"></a><h3>gtk_icon_view_get_markup_column ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_markup_column (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the column with markup text for <em class="parameter"><code>icon_view</code></em>
.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-markup-column.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-markup-column.returns"></a><h4>Returns</h4>
<p> the markup column, or -1 if its unset.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-pixbuf-column"></a><h3>gtk_icon_view_set_pixbuf_column ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_pixbuf_column (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>);</pre>
<p>Sets the column with pixbufs for <em class="parameter"><code>icon_view</code></em>
to be <em class="parameter"><code>column</code></em>
. The pixbuf
column must be of type <span class="type">GDK_TYPE_PIXBUF</span></p>
<div class="refsect3">
<a name="gtk-icon-view-set-pixbuf-column.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>column</p></td>
<td class="parameter_description"><p>A column in the currently used model, or -1 to disable</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-pixbuf-column"></a><h3>gtk_icon_view_get_pixbuf_column ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_pixbuf_column (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the column with pixbufs for <em class="parameter"><code>icon_view</code></em>
.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-pixbuf-column.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-pixbuf-column.returns"></a><h4>Returns</h4>
<p> the pixbuf column, or -1 if its unset.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-path-at-pos"></a><h3>gtk_icon_view_get_path_at_pos ()</h3>
<pre class="programlisting"><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="returnvalue">GtkTreePath</span></a> *
gtk_icon_view_get_path_at_pos (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
<p>Finds the path at the point (<em class="parameter"><code>x</code></em>
, <em class="parameter"><code>y</code></em>
), relative to bin_window coordinates.
See <a class="link" href="GtkIconView.html#gtk-icon-view-get-item-at-pos" title="gtk_icon_view_get_item_at_pos ()"><code class="function">gtk_icon_view_get_item_at_pos()</code></a>, if you are also interested in
the cell at the specified position.
See <a class="link" href="GtkIconView.html#gtk-icon-view-convert-widget-to-bin-window-coords" title="gtk_icon_view_convert_widget_to_bin_window_coords ()"><code class="function">gtk_icon_view_convert_widget_to_bin_window_coords()</code></a> for converting
widget coordinates to bin_window coordinates.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-path-at-pos.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>The x position to be identified</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>The y position to be identified</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-path-at-pos.returns"></a><h4>Returns</h4>
<p> The <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> corresponding
to the icon or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no icon exists at that position. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-item-at-pos"></a><h3>gtk_icon_view_get_item_at_pos ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_icon_view_get_item_at_pos (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> **path</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> **cell</code></em>);</pre>
<p>Finds the path at the point (<em class="parameter"><code>x</code></em>
, <em class="parameter"><code>y</code></em>
), relative to bin_window coordinates.
In contrast to <a class="link" href="GtkIconView.html#gtk-icon-view-get-path-at-pos" title="gtk_icon_view_get_path_at_pos ()"><code class="function">gtk_icon_view_get_path_at_pos()</code></a>, this function also
obtains the cell at the specified position. The returned path should
be freed with <a class="link" href="GtkTreeModel.html#gtk-tree-path-free" title="gtk_tree_path_free ()"><code class="function">gtk_tree_path_free()</code></a>.
See <a class="link" href="GtkIconView.html#gtk-icon-view-convert-widget-to-bin-window-coords" title="gtk_icon_view_convert_widget_to_bin_window_coords ()"><code class="function">gtk_icon_view_convert_widget_to_bin_window_coords()</code></a> for converting
widget coordinates to bin_window coordinates.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-item-at-pos.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>The x position to be identified</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>The y position to be identified</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p> Return location for the path, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cell</p></td>
<td class="parameter_description"><p> Return location for the renderer
responsible for the cell at (<em class="parameter"><code>x</code></em>
, <em class="parameter"><code>y</code></em>
), or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-item-at-pos.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if an item exists at the specified position</p>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-convert-widget-to-bin-window-coords"></a><h3>gtk_icon_view_convert_widget_to_bin_window_coords ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_convert_widget_to_bin_window_coords
(<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> wx</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> wy</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *bx</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *by</code></em>);</pre>
<p>Converts widget coordinates to coordinates for the bin_window,
as expected by e.g. <a class="link" href="GtkIconView.html#gtk-icon-view-get-path-at-pos" title="gtk_icon_view_get_path_at_pos ()"><code class="function">gtk_icon_view_get_path_at_pos()</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-convert-widget-to-bin-window-coords.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> </p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>wx</p></td>
<td class="parameter_description"><p>X coordinate relative to the widget</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>wy</p></td>
<td class="parameter_description"><p>Y coordinate relative to the widget</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>bx</p></td>
<td class="parameter_description"><p> return location for bin_window X coordinate. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>by</p></td>
<td class="parameter_description"><p> return location for bin_window Y coordinate. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-cursor"></a><h3>gtk_icon_view_set_cursor ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_cursor (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> start_editing</code></em>);</pre>
<p>Sets the current keyboard focus to be at <em class="parameter"><code>path</code></em>
, and selects it. This is
useful when you want to focus the users attention on a particular item.
If <em class="parameter"><code>cell</code></em>
is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then focus is given to the cell specified by
it. Additionally, if <em class="parameter"><code>start_editing</code></em>
is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then editing should be
started in the specified cell. </p>
<p>This function is often followed by <code class="literal">gtk_widget_grab_focus
(icon_view)</code> in order to give keyboard focus to the widget.
Please note that editing can only happen when the widget is realized.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-cursor.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cell</p></td>
<td class="parameter_description"><p> One of the cell renderers of <em class="parameter"><code>icon_view</code></em>
, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>start_editing</p></td>
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the specified cell should start being edited.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-cursor"></a><h3>gtk_icon_view_get_cursor ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_icon_view_get_cursor (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> **path</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> **cell</code></em>);</pre>
<p>Fills in <em class="parameter"><code>path</code></em>
and <em class="parameter"><code>cell</code></em>
with the current cursor path and cell.
If the cursor isnt currently set, then *<em class="parameter"><code>path</code></em>
will be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
If no cell currently has focus, then *<em class="parameter"><code>cell</code></em>
will be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<p>The returned <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> must be freed with <a class="link" href="GtkTreeModel.html#gtk-tree-path-free" title="gtk_tree_path_free ()"><code class="function">gtk_tree_path_free()</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-cursor.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p> Return location for the current
cursor path, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cell</p></td>
<td class="parameter_description"><p> Return location the current
focus cell, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-cursor.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the cursor is set.</p>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-selected-foreach"></a><h3>gtk_icon_view_selected_foreach ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_selected_foreach (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkIconView.html#GtkIconViewForeachFunc" title="GtkIconViewForeachFunc ()"><span class="type">GtkIconViewForeachFunc</span></a> func</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
<p>Calls a function for each selected icon. Note that the model or
selection cannot be modified from within this function.</p>
<div class="refsect3">
<a name="gtk-icon-view-selected-foreach.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>func</p></td>
<td class="parameter_description"><p> The function to call for each selected icon. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>User data to pass to the function.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-selection-mode"></a><h3>gtk_icon_view_set_selection_mode ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_selection_mode (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkSelectionMode" title="enum GtkSelectionMode"><span class="type">GtkSelectionMode</span></a> mode</code></em>);</pre>
<p>Sets the selection mode of the <em class="parameter"><code>icon_view</code></em>
.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-selection-mode.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>The selection mode</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-selection-mode"></a><h3>gtk_icon_view_get_selection_mode ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkSelectionMode" title="enum GtkSelectionMode"><span class="returnvalue">GtkSelectionMode</span></a>
gtk_icon_view_get_selection_mode (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Gets the selection mode of the <em class="parameter"><code>icon_view</code></em>
.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-selection-mode.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-selection-mode.returns"></a><h4>Returns</h4>
<p> the current selection mode</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-item-orientation"></a><h3>gtk_icon_view_set_item_orientation ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_item_orientation (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation</code></em>);</pre>
<p>Sets the ::item-orientation property which determines whether the labels
are drawn beside the icons instead of below.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-item-orientation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>orientation</p></td>
<td class="parameter_description"><p>the relative position of texts and icons </p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-item-orientation"></a><h3>gtk_icon_view_get_item_orientation ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="returnvalue">GtkOrientation</span></a>
gtk_icon_view_get_item_orientation (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the value of the ::item-orientation property which determines
whether the labels are drawn beside the icons instead of below.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-item-orientation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-item-orientation.returns"></a><h4>Returns</h4>
<p> the relative position of texts and icons </p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-columns"></a><h3>gtk_icon_view_set_columns ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_columns (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> columns</code></em>);</pre>
<p>Sets the ::columns property which determines in how
many columns the icons are arranged. If <em class="parameter"><code>columns</code></em>
is
-1, the number of columns will be chosen automatically
to fill the available area.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-columns.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>columns</p></td>
<td class="parameter_description"><p>the number of columns</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-columns"></a><h3>gtk_icon_view_get_columns ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_columns (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the value of the ::columns property.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-columns.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-columns.returns"></a><h4>Returns</h4>
<p> the number of columns, or -1</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-item-width"></a><h3>gtk_icon_view_set_item_width ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_item_width (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> item_width</code></em>);</pre>
<p>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.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-item-width.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>item_width</p></td>
<td class="parameter_description"><p>the width for each item</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-item-width"></a><h3>gtk_icon_view_get_item_width ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_item_width (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the value of the ::item-width property.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-item-width.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-item-width.returns"></a><h4>Returns</h4>
<p> the width of a single item, or -1</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-spacing"></a><h3>gtk_icon_view_set_spacing ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_spacing (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> spacing</code></em>);</pre>
<p>Sets the ::spacing property which specifies the space
which is inserted between the cells (i.e. the icon and
the text) of an item.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-spacing.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>spacing</p></td>
<td class="parameter_description"><p>the spacing</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-spacing"></a><h3>gtk_icon_view_get_spacing ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_spacing (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the value of the ::spacing property.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-spacing.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-spacing.returns"></a><h4>Returns</h4>
<p> the space between cells </p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-row-spacing"></a><h3>gtk_icon_view_set_row_spacing ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_row_spacing (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> row_spacing</code></em>);</pre>
<p>Sets the ::row-spacing property which specifies the space
which is inserted between the rows of the icon view.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-row-spacing.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>row_spacing</p></td>
<td class="parameter_description"><p>the row spacing</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-row-spacing"></a><h3>gtk_icon_view_get_row_spacing ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_row_spacing (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the value of the ::row-spacing property.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-row-spacing.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-row-spacing.returns"></a><h4>Returns</h4>
<p> the space between rows</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-column-spacing"></a><h3>gtk_icon_view_set_column_spacing ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_column_spacing (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column_spacing</code></em>);</pre>
<p>Sets the ::column-spacing property which specifies the space
which is inserted between the columns of the icon view.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-column-spacing.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>column_spacing</p></td>
<td class="parameter_description"><p>the column spacing</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-column-spacing"></a><h3>gtk_icon_view_get_column_spacing ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_column_spacing (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the value of the ::column-spacing property.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-column-spacing.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-column-spacing.returns"></a><h4>Returns</h4>
<p> the space between columns</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-margin"></a><h3>gtk_icon_view_set_margin ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_margin (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> margin</code></em>);</pre>
<p>Sets the ::margin property which specifies the space
which is inserted at the top, bottom, left and right
of the icon view.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-margin.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>margin</p></td>
<td class="parameter_description"><p>the margin</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-margin"></a><h3>gtk_icon_view_get_margin ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_margin (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the value of the ::margin property.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-margin.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-margin.returns"></a><h4>Returns</h4>
<p> the space at the borders </p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-item-padding"></a><h3>gtk_icon_view_set_item_padding ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_item_padding (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> item_padding</code></em>);</pre>
<p>Sets the <a class="link" href="GtkIconView.html#GtkIconView--item-padding" title="The “item-padding” property"><span class="type">“item-padding”</span></a> property which specifies the padding
around each of the icon views items.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-item-padding.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>item_padding</p></td>
<td class="parameter_description"><p>the item padding</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-item-padding"></a><h3>gtk_icon_view_get_item_padding ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_item_padding (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the value of the ::item-padding property.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-item-padding.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-item-padding.returns"></a><h4>Returns</h4>
<p> the padding around items</p>
</div>
<p class="since">Since: 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-activate-on-single-click"></a><h3>gtk_icon_view_set_activate_on_single_click ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_activate_on_single_click
(<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> single</code></em>);</pre>
<p>Causes the <a class="link" href="GtkIconView.html#GtkIconView-item-activated" title="The “item-activated” signal"><span class="type">“item-activated”</span></a> signal to be emitted on
a single click instead of a double click.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-activate-on-single-click.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>single</p></td>
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to emit item-activated on a single click</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-activate-on-single-click"></a><h3>gtk_icon_view_get_activate_on_single_click ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_icon_view_get_activate_on_single_click
(<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Gets the setting set by <a class="link" href="GtkIconView.html#gtk-icon-view-set-activate-on-single-click" title="gtk_icon_view_set_activate_on_single_click ()"><code class="function">gtk_icon_view_set_activate_on_single_click()</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-activate-on-single-click.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-activate-on-single-click.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if item-activated will be emitted on a single click</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-cell-rect"></a><h3>gtk_icon_view_get_cell_rect ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_icon_view_get_cell_rect (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
<em class="parameter"><code><a href="../gdk4/gdk4-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
<p>Fills the bounding rectangle in widget coordinates for the cell specified by
<em class="parameter"><code>path</code></em>
and <em class="parameter"><code>cell</code></em>
. If <em class="parameter"><code>cell</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the main cell area is used.</p>
<p>This function is only valid if <em class="parameter"><code>icon_view</code></em>
is realized.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-cell-rect.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cell</p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>rect</p></td>
<td class="parameter_description"><p> rectangle to fill with cell rect. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-cell-rect.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there is no such item, <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-select-path"></a><h3>gtk_icon_view_select_path ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_select_path (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
<p>Selects the row at <em class="parameter"><code>path</code></em>
.</p>
<div class="refsect3">
<a name="gtk-icon-view-select-path.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>The <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> to be selected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-unselect-path"></a><h3>gtk_icon_view_unselect_path ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_unselect_path (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
<p>Unselects the row at <em class="parameter"><code>path</code></em>
.</p>
<div class="refsect3">
<a name="gtk-icon-view-unselect-path.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>The <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> to be unselected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-path-is-selected"></a><h3>gtk_icon_view_path_is_selected ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_icon_view_path_is_selected (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
<p>Returns <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon pointed to by <em class="parameter"><code>path</code></em>
is currently
selected. If <em class="parameter"><code>path</code></em>
does not point to a valid location, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned.</p>
<div class="refsect3">
<a name="gtk-icon-view-path-is-selected.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> to check selection on.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-path-is-selected.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>path</code></em>
is selected.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-selected-items"></a><h3>gtk_icon_view_get_selected_items ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gtk_icon_view_get_selected_items (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>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 <a href="GtkTreeModel.html#GtkTreeRowReference"><span class="type">GtkTreeRowReferences</span></a>.
To do this, you can use <a class="link" href="GtkTreeModel.html#gtk-tree-row-reference-new" title="gtk_tree_row_reference_new ()"><code class="function">gtk_tree_row_reference_new()</code></a>.</p>
<p>To free the return value, use:</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="function"><a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free-full">g_list_free_full</a></span> <span class="gtkdoc opt">(</span>list<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> gtk_tree_path_free<span class="gtkdoc opt">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<div class="refsect3">
<a name="gtk-icon-view-get-selected-items.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-selected-items.returns"></a><h4>Returns</h4>
<p> A <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> containing a <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> for each selected row. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkTreePath][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-select-all"></a><h3>gtk_icon_view_select_all ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_select_all (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Selects all the icons. <em class="parameter"><code>icon_view</code></em>
must has its selection mode set
to <a class="link" href="gtk3-Standard-Enumerations.html#GTK-SELECTION-MULTIPLE:CAPS"><span class="type">GTK_SELECTION_MULTIPLE</span></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-select-all.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-unselect-all"></a><h3>gtk_icon_view_unselect_all ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_unselect_all (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Unselects all the icons.</p>
<div class="refsect3">
<a name="gtk-icon-view-unselect-all.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-item-activated"></a><h3>gtk_icon_view_item_activated ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_item_activated (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
<p>Activates the item determined by <em class="parameter"><code>path</code></em>
.</p>
<div class="refsect3">
<a name="gtk-icon-view-item-activated.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>The <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> to be activated</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-scroll-to-path"></a><h3>gtk_icon_view_scroll_to_path ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_scroll_to_path (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_align</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> row_align</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> col_align</code></em>);</pre>
<p>Moves the alignments of <em class="parameter"><code>icon_view</code></em>
to the position specified by <em class="parameter"><code>path</code></em>
.
<em class="parameter"><code>row_align</code></em>
determines where the row is placed, and <em class="parameter"><code>col_align</code></em>
determines
where <em class="parameter"><code>column</code></em>
is placed. Both are expected to be between 0.0 and 1.0.
0.0 means left/top alignment, 1.0 means right/bottom alignment, 0.5 means
center.</p>
<p>If <em class="parameter"><code>use_align</code></em>
is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, 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.</p>
<p>This function only works if the model is set, and <em class="parameter"><code>path</code></em>
is a valid row on
the model. If the model changes before the <em class="parameter"><code>icon_view</code></em>
is realized, the
centered path will be modified to reflect this change.</p>
<div class="refsect3">
<a name="gtk-icon-view-scroll-to-path.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>The path of the item to move to.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>use_align</p></td>
<td class="parameter_description"><p>whether to use alignment arguments, or <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>row_align</p></td>
<td class="parameter_description"><p>The vertical alignment of the item specified by <em class="parameter"><code>path</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>col_align</p></td>
<td class="parameter_description"><p>The horizontal alignment of the item specified by <em class="parameter"><code>path</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-visible-range"></a><h3>gtk_icon_view_get_visible_range ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_icon_view_get_visible_range (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> **start_path</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> **end_path</code></em>);</pre>
<p>Sets <em class="parameter"><code>start_path</code></em>
and <em class="parameter"><code>end_path</code></em>
to be the first and last visible path.
Note that there may be invisible paths in between.</p>
<p>Both paths should be freed with <a class="link" href="GtkTreeModel.html#gtk-tree-path-free" title="gtk_tree_path_free ()"><code class="function">gtk_tree_path_free()</code></a> after use.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-visible-range.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>start_path</p></td>
<td class="parameter_description"><p> Return location for start of region,
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>end_path</p></td>
<td class="parameter_description"><p> Return location for end of region, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-visible-range.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if valid paths were placed in <em class="parameter"><code>start_path</code></em>
and <em class="parameter"><code>end_path</code></em>
</p>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-tooltip-item"></a><h3>gtk_icon_view_set_tooltip_item ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_tooltip_item (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
<p>Sets the tip area of <em class="parameter"><code>tooltip</code></em>
to be the area covered by the item at <em class="parameter"><code>path</code></em>
.
See also <a class="link" href="GtkIconView.html#gtk-icon-view-set-tooltip-column" title="gtk_icon_view_set_tooltip_column ()"><code class="function">gtk_icon_view_set_tooltip_column()</code></a> for a simpler alternative.
See also <a class="link" href="GtkTooltip.html#gtk-tooltip-set-tip-area" title="gtk_tooltip_set_tip_area ()"><code class="function">gtk_tooltip_set_tip_area()</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-tooltip-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tooltip</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-tooltip-cell"></a><h3>gtk_icon_view_set_tooltip_cell ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_tooltip_cell (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
<em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>);</pre>
<p>Sets the tip area of <em class="parameter"><code>tooltip</code></em>
to the area which <em class="parameter"><code>cell</code></em>
occupies in
the item pointed to by <em class="parameter"><code>path</code></em>
. See also <a class="link" href="GtkTooltip.html#gtk-tooltip-set-tip-area" title="gtk_tooltip_set_tip_area ()"><code class="function">gtk_tooltip_set_tip_area()</code></a>.</p>
<p>See also <a class="link" href="GtkIconView.html#gtk-icon-view-set-tooltip-column" title="gtk_icon_view_set_tooltip_column ()"><code class="function">gtk_icon_view_set_tooltip_column()</code></a> for a simpler alternative.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-tooltip-cell.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tooltip</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cell</p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-tooltip-context"></a><h3>gtk_icon_view_get_tooltip_context ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_icon_view_get_tooltip_context (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> keyboard_tip</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> **model</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> **path</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
<p>This function is supposed to be used in a <a class="link" href="GtkWidget.html#GtkWidget-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a>
signal handler for <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>. The <em class="parameter"><code>x</code></em>
, <em class="parameter"><code>y</code></em>
and <em class="parameter"><code>keyboard_tip</code></em>
values
which are received in the signal handler, should be passed to this
function without modification.</p>
<p>The return value indicates whether there is an icon view item at the given
coordinates (<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>) or not (<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>) for mouse tooltips. For keyboard
tooltips the item returned will be the cursor item. When <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then any of
<em class="parameter"><code>model</code></em>
, <em class="parameter"><code>path</code></em>
and <em class="parameter"><code>iter</code></em>
which have been provided will be set to point to
that row and the corresponding model. <em class="parameter"><code>x</code></em>
and <em class="parameter"><code>y</code></em>
will always be converted
to be relative to <em class="parameter"><code>icon_view</code></em>
s bin_window if <em class="parameter"><code>keyboard_tooltip</code></em>
is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-tooltip-context.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>an <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p> the x coordinate (relative to widget coordinates). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p> the y coordinate (relative to widget coordinates). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>keyboard_tip</p></td>
<td class="parameter_description"><p>whether this is a keyboard tooltip or not</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>model</p></td>
<td class="parameter_description"><p> a pointer to receive a
<a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p> a pointer to receive a <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> a pointer to receive a <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-tooltip-context.returns"></a><h4>Returns</h4>
<p> whether or not the given tooltip context points to a item</p>
</div>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-tooltip-column"></a><h3>gtk_icon_view_set_tooltip_column ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_tooltip_column (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>);</pre>
<p>If you only plan to have simple (text-only) tooltips on full items, you
can use this function to have <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> handle these automatically
for you. <em class="parameter"><code>column</code></em>
should be set to the column in <em class="parameter"><code>icon_view</code></em>
s model
containing the tooltip texts, or -1 to disable this feature.</p>
<p>When enabled, <a class="link" href="GtkWidget.html#GtkWidget--has-tooltip" title="The “has-tooltip” property"><span class="type">“has-tooltip”</span></a> will be set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and
<em class="parameter"><code>icon_view</code></em>
will connect a <a class="link" href="GtkWidget.html#GtkWidget-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a> signal handler.</p>
<p>Note that the signal handler sets the text with <a class="link" href="GtkTooltip.html#gtk-tooltip-set-markup" title="gtk_tooltip_set_markup ()"><code class="function">gtk_tooltip_set_markup()</code></a>,
so &amp;, &lt;, etc have to be escaped in the text.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-tooltip-column.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>column</p></td>
<td class="parameter_description"><p>an integer, which is a valid column number for <em class="parameter"><code>icon_view</code></em>
s model</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-tooltip-column"></a><h3>gtk_icon_view_get_tooltip_column ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_tooltip_column (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Returns the column of <em class="parameter"><code>icon_view</code></em>
s model which is being used for
displaying tooltips on <em class="parameter"><code>icon_view</code></em>
s rows.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-tooltip-column.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-tooltip-column.returns"></a><h4>Returns</h4>
<p> the index of the tooltip column that is currently being
used, or -1 if this is disabled.</p>
</div>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-item-row"></a><h3>gtk_icon_view_get_item_row ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_item_row (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
<p>Gets the row in which the item <em class="parameter"><code>path</code></em>
is currently
displayed. Row numbers start at 0.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-item-row.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> of the item</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-item-row.returns"></a><h4>Returns</h4>
<p> The row in which the item is displayed</p>
</div>
<p class="since">Since: 2.22</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-item-column"></a><h3>gtk_icon_view_get_item_column ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_icon_view_get_item_column (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
<p>Gets the column in which the item <em class="parameter"><code>path</code></em>
is currently
displayed. Column numbers start at 0.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-item-column.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> of the item</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-item-column.returns"></a><h4>Returns</h4>
<p> The column in which the item is displayed</p>
</div>
<p class="since">Since: 2.22</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-enable-model-drag-source"></a><h3>gtk_icon_view_enable_model_drag_source ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_enable_model_drag_source
(<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../gdk4/gdk4-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> start_button_mask</code></em>,
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</code></em>,
<em class="parameter"><code><a href="../gdk4/gdk4-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
<p>Turns <em class="parameter"><code>icon_view</code></em>
into a drag source for automatic DND. Calling this
method sets <a class="link" href="GtkIconView.html#GtkIconView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-enable-model-drag-source.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>start_button_mask</p></td>
<td class="parameter_description"><p>Mask of allowed buttons to start drag</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>targets</p></td>
<td class="parameter_description"><p> the table of targets that the drag will
support. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_targets]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>n_targets</p></td>
<td class="parameter_description"><p>the number of items in <em class="parameter"><code>targets</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>actions</p></td>
<td class="parameter_description"><p>the bitmask of possible actions for a drag from this
widget</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-enable-model-drag-dest"></a><h3>gtk_icon_view_enable_model_drag_dest ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_enable_model_drag_dest (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code>const <a class="link" href="gtk3-Selections.html#GtkTargetEntry" title="struct GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> *targets</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_targets</code></em>,
<em class="parameter"><code><a href="../gdk4/gdk4-Drag-and-Drop.html#GdkDragAction"><span class="type">GdkDragAction</span></a> actions</code></em>);</pre>
<p>Turns <em class="parameter"><code>icon_view</code></em>
into a drop destination for automatic DND. Calling this
method sets <a class="link" href="GtkIconView.html#GtkIconView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-enable-model-drag-dest.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>targets</p></td>
<td class="parameter_description"><p> the table of targets that the drag will
support. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_targets]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>n_targets</p></td>
<td class="parameter_description"><p>the number of items in <em class="parameter"><code>targets</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>actions</p></td>
<td class="parameter_description"><p>the bitmask of possible actions for a drag to this
widget</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-unset-model-drag-source"></a><h3>gtk_icon_view_unset_model_drag_source ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_unset_model_drag_source (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Undoes the effect of <a class="link" href="GtkIconView.html#gtk-icon-view-enable-model-drag-source" title="gtk_icon_view_enable_model_drag_source ()"><code class="function">gtk_icon_view_enable_model_drag_source()</code></a>. Calling this
method sets <a class="link" href="GtkIconView.html#GtkIconView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-unset-model-drag-source.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-unset-model-drag-dest"></a><h3>gtk_icon_view_unset_model_drag_dest ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_unset_model_drag_dest (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Undoes the effect of <a class="link" href="GtkIconView.html#gtk-icon-view-enable-model-drag-dest" title="gtk_icon_view_enable_model_drag_dest ()"><code class="function">gtk_icon_view_enable_model_drag_dest()</code></a>. Calling this
method sets <a class="link" href="GtkIconView.html#GtkIconView--reorderable" title="The “reorderable” property"><span class="type">“reorderable”</span></a> to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-unset-model-drag-dest.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-reorderable"></a><h3>gtk_icon_view_set_reorderable ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_reorderable (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> reorderable</code></em>);</pre>
<p>This function is a convenience function to allow you to reorder models that
support the <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragSourceIface" title="struct GtkTreeDragSourceIface"><span class="type">GtkTreeDragSourceIface</span></a> and the <a class="link" href="gtk3-GtkTreeView-drag-and-drop.html#GtkTreeDragDestIface" title="struct GtkTreeDragDestIface"><span class="type">GtkTreeDragDestIface</span></a>. Both
<a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> and <a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</span></a> support these. If <em class="parameter"><code>reorderable</code></em>
is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, 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.</p>
<p>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.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-reorderable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>reorderable</p></td>
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if the list of items can be reordered.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-reorderable"></a><h3>gtk_icon_view_get_reorderable ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_icon_view_get_reorderable (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>);</pre>
<p>Retrieves whether the user can reorder the list via drag-and-drop.
See <a class="link" href="GtkIconView.html#gtk-icon-view-set-reorderable" title="gtk_icon_view_set_reorderable ()"><code class="function">gtk_icon_view_set_reorderable()</code></a>.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-reorderable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-reorderable.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the list can be reordered.</p>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-set-drag-dest-item"></a><h3>gtk_icon_view_set_drag_dest_item ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_set_drag_dest_item (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>,
<em class="parameter"><code><a class="link" href="GtkIconView.html#GtkIconViewDropPosition" title="enum GtkIconViewDropPosition"><span class="type">GtkIconViewDropPosition</span></a> pos</code></em>);</pre>
<p>Sets the item that is highlighted for feedback.</p>
<div class="refsect3">
<a name="gtk-icon-view-set-drag-dest-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p> The path of the item to highlight, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>pos</p></td>
<td class="parameter_description"><p>Specifies where to drop, relative to the item</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-drag-dest-item"></a><h3>gtk_icon_view_get_drag_dest_item ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_icon_view_get_drag_dest_item (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> **path</code></em>,
<em class="parameter"><code><a class="link" href="GtkIconView.html#GtkIconViewDropPosition" title="enum GtkIconViewDropPosition"><span class="type">GtkIconViewDropPosition</span></a> *pos</code></em>);</pre>
<p>Gets information about the item that is highlighted for feedback.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-drag-dest-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p> Return location for the path of
the highlighted item, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>pos</p></td>
<td class="parameter_description"><p> Return location for the drop position, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-get-dest-item-at-pos"></a><h3>gtk_icon_view_get_dest_item_at_pos ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_icon_view_get_dest_item_at_pos (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> drag_x</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> drag_y</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> **path</code></em>,
<em class="parameter"><code><a class="link" href="GtkIconView.html#GtkIconViewDropPosition" title="enum GtkIconViewDropPosition"><span class="type">GtkIconViewDropPosition</span></a> *pos</code></em>);</pre>
<p>Determines the destination item for a given position.</p>
<div class="refsect3">
<a name="gtk-icon-view-get-dest-item-at-pos.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>drag_x</p></td>
<td class="parameter_description"><p>the position to determine the destination item for</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>drag_y</p></td>
<td class="parameter_description"><p>the position to determine the destination item for</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p> Return location for the path of the item,
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>pos</p></td>
<td class="parameter_description"><p> Return location for the drop position, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-dest-item-at-pos.returns"></a><h4>Returns</h4>
<p> whether there is an item at the given position.</p>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-icon-view-create-drag-icon"></a><h3>gtk_icon_view_create_drag_icon ()</h3>
<pre class="programlisting"><span class="returnvalue">cairo_surface_t</span> *
gtk_icon_view_create_drag_icon (<em class="parameter"><code><a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *icon_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path</code></em>);</pre>
<p>Creates a <span class="type">cairo_surface_t</span> representation of the item at <em class="parameter"><code>path</code></em>
.
This image is used for a drag icon.</p>
<div class="refsect3">
<a name="gtk-icon-view-create-drag-icon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>icon_view</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> in <em class="parameter"><code>icon_view</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-icon-view-create-drag-icon.returns"></a><h4>Returns</h4>
<p> a newly-allocated surface of the drag icon. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.8</p>
</div>
</div>
<div class="refsect1">
<a name="GtkIconView.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkIconView-struct"></a><h3>struct GtkIconView</h3>
<pre class="programlisting">struct GtkIconView;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconViewDropPosition"></a><h3>enum GtkIconViewDropPosition</h3>
<p>An enum for determining where a dropped item goes.</p>
<div class="refsect3">
<a name="GtkIconViewDropPosition.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GTK-ICON-VIEW-NO-DROP:CAPS"></a>GTK_ICON_VIEW_NO_DROP</p></td>
<td class="enum_member_description">
<p>no drop possible</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-ICON-VIEW-DROP-INTO:CAPS"></a>GTK_ICON_VIEW_DROP_INTO</p></td>
<td class="enum_member_description">
<p>dropped item replaces the item</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-ICON-VIEW-DROP-LEFT:CAPS"></a>GTK_ICON_VIEW_DROP_LEFT</p></td>
<td class="enum_member_description">
<p>droppped item is inserted to the left</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-ICON-VIEW-DROP-RIGHT:CAPS"></a>GTK_ICON_VIEW_DROP_RIGHT</p></td>
<td class="enum_member_description">
<p>dropped item is inserted to the right</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-ICON-VIEW-DROP-ABOVE:CAPS"></a>GTK_ICON_VIEW_DROP_ABOVE</p></td>
<td class="enum_member_description">
<p>dropped item is inserted above</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-ICON-VIEW-DROP-BELOW:CAPS"></a>GTK_ICON_VIEW_DROP_BELOW</p></td>
<td class="enum_member_description">
<p>dropped item is inserted below</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GtkIconView.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkIconView--activate-on-single-click"></a><h3>The <code class="literal">“activate-on-single-click”</code> property</h3>
<pre class="programlisting"> “activate-on-single-click” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p>The activate-on-single-click property specifies whether the "item-activated" signal
will be emitted after a single click.</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--cell-area"></a><h3>The <code class="literal">“cell-area”</code> property</h3>
<pre class="programlisting"> “cell-area” <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *</pre>
<p>The <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> used to layout cell renderers for this view.</p>
<p>If no area is specified when creating the icon view with <a class="link" href="GtkIconView.html#gtk-icon-view-new-with-area" title="gtk_icon_view_new_with_area ()"><code class="function">gtk_icon_view_new_with_area()</code></a>
a <a class="link" href="GtkCellAreaBox.html" title="GtkCellAreaBox"><span class="type">GtkCellAreaBox</span></a> will be used.</p>
<p>Flags: Read / Write / Construct Only</p>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--column-spacing"></a><h3>The <code class="literal">“column-spacing”</code> property</h3>
<pre class="programlisting"> “column-spacing” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>The column-spacing property specifies the space which is inserted between
the columns of the icon view.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 6</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--columns"></a><h3>The <code class="literal">“columns”</code> property</h3>
<pre class="programlisting"> “columns” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>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.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: -1</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--item-orientation"></a><h3>The <code class="literal">“item-orientation”</code> property</h3>
<pre class="programlisting"> “item-orientation” <a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a></pre>
<p>The item-orientation property specifies how the cells (i.e. the icon and
the text) of the item are positioned relative to each other.</p>
<p>Flags: Read / Write</p>
<p>Default value: GTK_ORIENTATION_VERTICAL</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--item-padding"></a><h3>The <code class="literal">“item-padding”</code> property</h3>
<pre class="programlisting"> “item-padding” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>The item-padding property specifies the padding around each
of the icon view's item.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 6</p>
<p class="since">Since: 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--item-width"></a><h3>The <code class="literal">“item-width”</code> property</h3>
<pre class="programlisting"> “item-width” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>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.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: -1</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--margin"></a><h3>The <code class="literal">“margin”</code> property</h3>
<pre class="programlisting"> “margin” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>The margin property specifies the space which is inserted
at the edges of the icon view.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 6</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--markup-column"></a><h3>The <code class="literal">“markup-column”</code> property</h3>
<pre class="programlisting"> “markup-column” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>The ::markup-column property contains the number of the model column
containing markup information to be displayed. The markup column must be
of type <a href="../gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><span class="type">G_TYPE_STRING</span></a>. 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.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: -1</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--model"></a><h3>The <code class="literal">“model”</code> property</h3>
<pre class="programlisting"> “model” <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *</pre>
<p>The model for the icon view.</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--pixbuf-column"></a><h3>The <code class="literal">“pixbuf-column”</code> property</h3>
<pre class="programlisting"> “pixbuf-column” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>The ::pixbuf-column property contains the number of the model column
containing the pixbufs which are displayed. The pixbuf column must be
of type <span class="type">GDK_TYPE_PIXBUF</span>. Setting this property to -1 turns off the
display of pixbufs.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: -1</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--reorderable"></a><h3>The <code class="literal">“reorderable”</code> property</h3>
<pre class="programlisting"> “reorderable” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p>The reorderable property specifies if the items can be reordered
by DND.</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--row-spacing"></a><h3>The <code class="literal">“row-spacing”</code> property</h3>
<pre class="programlisting"> “row-spacing” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>The row-spacing property specifies the space which is inserted between
the rows of the icon view.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 6</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--selection-mode"></a><h3>The <code class="literal">“selection-mode”</code> property</h3>
<pre class="programlisting"> “selection-mode” <a class="link" href="gtk3-Standard-Enumerations.html#GtkSelectionMode" title="enum GtkSelectionMode"><span class="type">GtkSelectionMode</span></a></pre>
<p>The ::selection-mode property specifies the selection mode of
icon view. If the mode is <a class="link" href="gtk3-Standard-Enumerations.html#GTK-SELECTION-MULTIPLE:CAPS"><span class="type">GTK_SELECTION_MULTIPLE</span></a>, rubberband selection
is enabled, for the other modes, only keyboard selection is possible.</p>
<p>Flags: Read / Write</p>
<p>Default value: GTK_SELECTION_SINGLE</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--spacing"></a><h3>The <code class="literal">“spacing”</code> property</h3>
<pre class="programlisting"> “spacing” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>The spacing property specifies the space which is inserted between
the cells (i.e. the icon and the text) of an item.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--text-column"></a><h3>The <code class="literal">“text-column”</code> property</h3>
<pre class="programlisting"> “text-column” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>The ::text-column property contains the number of the model column
containing the texts which are displayed. The text column must be
of type <a href="../gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><span class="type">G_TYPE_STRING</span></a>. If this property and the :markup-column
property are both set to -1, no texts are displayed.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: -1</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--tooltip-column"></a><h3>The <code class="literal">“tooltip-column”</code> property</h3>
<pre class="programlisting"> “tooltip-column” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>The column in the model containing the tooltip texts for the items.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: -1</p>
</div>
</div>
<div class="refsect1">
<a name="GtkIconView.style-property-details"></a><h2>Style Property Details</h2>
<div class="refsect2">
<a name="GtkIconView--s-selection-box-alpha"></a><h3>The <code class="literal">“selection-box-alpha”</code> style property</h3>
<pre class="programlisting"> “selection-box-alpha” <a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a></pre>
<p>The opacity of the selection box.</p>
<div class="warning">
<p><code class="literal">GtkIconView:selection-box-alpha</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
<p>The opacity of the selection box is determined by CSS;
the value of this style property is ignored.</p>
</div>
<p>Flags: Read</p>
<p>Default value: 64</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView--s-selection-box-color"></a><h3>The <code class="literal">“selection-box-color”</code> style property</h3>
<pre class="programlisting"> “selection-box-color” <span class="type">GdkColor</span> *</pre>
<p>The color of the selection box.</p>
<div class="warning">
<p><code class="literal">GtkIconView:selection-box-color</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
<p>The color of the selection box is determined by CSS;
the value of this style property is ignored.</p>
</div>
<p>Flags: Read</p>
</div>
</div>
<div class="refsect1">
<a name="GtkIconView.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkIconView-activate-cursor-item"></a><h3>The <code class="literal">“activate-cursor-item”</code> signal</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
user_function (<a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *iconview,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>A <a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted when the user activates the currently
focused item. </p>
<p>Applications should not connect to it, but may emit it with
<a href="../gobject/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control activation
programmatically.</p>
<p>The default bindings for this signal are Space, Return and Enter.</p>
<div class="refsect3">
<a name="GtkIconView-activate-cursor-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iconview</p></td>
<td class="parameter_description"><p>the object on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView-item-activated"></a><h3>The <code class="literal">“item-activated”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *iconview,
<a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> *path,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>The ::item-activated signal is emitted when the method
<a class="link" href="GtkIconView.html#gtk-icon-view-item-activated" title="gtk_icon_view_item_activated ()"><code class="function">gtk_icon_view_item_activated()</code></a> is called, when the user double
clicks an item with the "activate-on-single-click" property set
to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, or when the user single clicks an item when the
"activate-on-single-click" property set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. It is also
emitted when a non-editable item is selected and one of the keys:
Space, Return or Enter is pressed.</p>
<div class="refsect3">
<a name="GtkIconView-item-activated.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iconview</p></td>
<td class="parameter_description"><p>the object on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> for the activated item</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView-move-cursor"></a><h3>The <code class="literal">“move-cursor”</code> signal</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
user_function (<a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *iconview,
<a class="link" href="gtk3-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a> step,
<a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> count,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>The ::move-cursor signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted when the user initiates a cursor movement.</p>
<p>Applications should not connect to it, but may emit it with
<a href="../gobject/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control the cursor
programmatically.</p>
<p>The default bindings for this signal include</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>Arrow keys which move by individual steps</p></li>
<li class="listitem"><p>Home/End keys which move to the first/last item</p></li>
<li class="listitem"><p>PageUp/PageDown which move by "pages"
All of these will extend the selection when combined with
the Shift modifier.</p></li>
</ul></div>
<div class="refsect3">
<a name="GtkIconView-move-cursor.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iconview</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>step</p></td>
<td class="parameter_description"><p>the granularity of the move, as a <a class="link" href="gtk3-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>count</p></td>
<td class="parameter_description"><p>the number of <em class="parameter"><code>step</code></em>
units to move</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView-select-all"></a><h3>The <code class="literal">“select-all”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *iconview,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>A <a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted when the user selects all items.</p>
<p>Applications should not connect to it, but may emit it with
<a href="../gobject/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control selection
programmatically.</p>
<p>The default binding for this signal is Ctrl-a.</p>
<div class="refsect3">
<a name="GtkIconView-select-all.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iconview</p></td>
<td class="parameter_description"><p>the object on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView-select-cursor-item"></a><h3>The <code class="literal">“select-cursor-item”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *iconview,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>A <a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted when the user selects the item that is currently
focused.</p>
<p>Applications should not connect to it, but may emit it with
<a href="../gobject/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control selection
programmatically.</p>
<p>There is no default binding for this signal.</p>
<div class="refsect3">
<a name="GtkIconView-select-cursor-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iconview</p></td>
<td class="parameter_description"><p>the object on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView-selection-changed"></a><h3>The <code class="literal">“selection-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *iconview,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>The ::selection-changed signal is emitted when the selection
(i.e. the set of selected items) changes.</p>
<div class="refsect3">
<a name="GtkIconView-selection-changed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iconview</p></td>
<td class="parameter_description"><p>the object on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView-toggle-cursor-item"></a><h3>The <code class="literal">“toggle-cursor-item”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *iconview,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>A <a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
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.</p>
<p>Applications should not connect to it, but may emit it with
<a href="../gobject/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control selection
programmatically.</p>
<p>There is no default binding for this signal is Ctrl-Space.</p>
<div class="refsect3">
<a name="GtkIconView-toggle-cursor-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iconview</p></td>
<td class="parameter_description"><p>the object on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkIconView-unselect-all"></a><h3>The <code class="literal">“unselect-all”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkIconView.html" title="GtkIconView"><span class="type">GtkIconView</span></a> *iconview,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>A <a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted when the user unselects all items.</p>
<p>Applications should not connect to it, but may emit it with
<a href="../gobject/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control selection
programmatically.</p>
<p>The default binding for this signal is Ctrl-Shift-a.</p>
<div class="refsect3">
<a name="GtkIconView-unselect-all.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>iconview</p></td>
<td class="parameter_description"><p>the object on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-ACTION:CAPS">Action</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
</body>
</html>