callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 3.23.0

Browse Source
This commit is contained in:
Iain Lane
2018-07-18 14:06:19 +01:00
parent 048c0e7f38 593edacb48
commit 609c36368b
731 changed files with 556100 additions and 542972 deletions
Download Patch File Download Diff File Expand all files Collapse all files

99
docs/reference/gtk/html/GtkIconView.html
View File

@ -3,12 +3,12 @@
<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">
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<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.27 (XML mode)">
<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -794,19 +794,10 @@ opposed to a flat list where the mapping to icons is obvious),
ignore the tree’s 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"><span class="normal">iconview</span><span class="symbol">.</span><span class="normal">view</span>
<span class="normal">╰── </span><span class="symbol">[</span><span class="normal">rubberband</span><span class="symbol">]</span></pre></td>
</tr>
</tbody>
</table>
</div>
<div class="informalexample"><pre class="programlisting">
iconview.view
╰── [rubberband]
</pre></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>
@ -843,7 +834,7 @@ selected rows. It will be called on every selected row in the view.</p>
</tr>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>user 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>
@ -947,7 +938,7 @@ it will unset the old model.</p>
</tr>
<tr>
<td class="parameter_name"><p>model</p></td>
<td class="parameter_description"><p>The 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>
@ -979,7 +970,7 @@ model is unset.</p>
</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 <code class="literal">NULL</code> if none is
<p> A <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>, or <code class="literal">NULL</code> 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>
@ -1216,7 +1207,7 @@ widget coordinates to bin_window coordinates.</p>
</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
<p> The <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> corresponding
to the icon or <code class="literal">NULL</code> 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>
@ -1265,12 +1256,12 @@ widget coordinates to bin_window coordinates.</p>
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>Return location for the path, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> Return location for the path, or <code class="literal">NULL</code>. </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
<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 <code class="literal">NULL</code>. </p></td>
@ -1323,12 +1314,12 @@ as expected by e.g. <a class="link" href="GtkIconView.html#gtk-icon-view-get-pat
</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_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_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>
@ -1376,7 +1367,7 @@ Please note that editing can only happen when the widget is realized.</p>
</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>
<td class="parameter_description"><p> One of the cell renderers of <em class="parameter"><code>icon_view</code></em>
, or <code class="literal">NULL</code>. </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>
@ -1421,13 +1412,13 @@ If no cell currently has focus, then *<em class="parameter"><code>cell</code></e
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>Return location for the current
<td class="parameter_description"><p> Return location for the current
cursor path, or <code class="literal">NULL</code>. </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
<td class="parameter_description"><p> Return location the current
focus cell, or <code class="literal">NULL</code>. </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>
@ -1465,7 +1456,7 @@ selection cannot be modified from within this function.</p>
</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_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>
@ -2114,12 +2105,12 @@ gtk_icon_view_get_cell_rect (<em class="parameter"><code><a class="link" href="G
</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 <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> or <code class="literal">NULL</code>. </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_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>
@ -2244,17 +2235,9 @@ 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">g_list_free_full</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GDestroyNotify</span><span class="symbol">)</span><span class="normal"> <a href="GtkTreeModel.html#gtk-tree-path-free">gtk_tree_path_free</a></span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
<div class="informalexample"><pre class="programlisting">
g_list_free_full (list, (GDestroyNotify) gtk_tree_path_free);
</pre></div>
<p></p>
<div class="refsect3">
<a name="gtk-icon-view-get-selected-items.parameters"></a><h4>Parameters</h4>
@ -2273,7 +2256,7 @@ To do this, you can use <a class="link" href="GtkTreeModel.html#gtk-tree-row-ref
</div>
<div class="refsect3">
<a name="gtk-icon-view-get-selected-items.returns"></a><h4>Returns</h4>
<p>A <span class="type">GList</span> containing a <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> for each selected row. </p>
<p> A <span class="type">GList</span> 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>
@ -2456,13 +2439,13 @@ Note that there may be invisible paths in between.</p>
</tr>
<tr>
<td class="parameter_name"><p>start_path</p></td>
<td class="parameter_description"><p>Return location for start of region,
<td class="parameter_description"><p> Return location for start of region,
or <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> Return location for end of region, or <code class="literal">NULL</code>. </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>
@ -2557,7 +2540,7 @@ the item pointed to by <em class="parameter"><code>path</code></em>
</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 <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> or <code class="literal">NULL</code>. </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>
@ -2612,12 +2595,12 @@ to be relative to <em class="parameter"><code>icon_view</code></em>
</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_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_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>
@ -2627,18 +2610,18 @@ to be relative to <em class="parameter"><code>icon_view</code></em>
</tr>
<tr>
<td class="parameter_name"><p>model</p></td>
<td class="parameter_description"><p>a pointer to receive a
<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 <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </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>
@ -2831,7 +2814,7 @@ method sets <a class="link" href="GtkIconView.html#GtkIconView--reorderable" tit
</tr>
<tr>
<td class="parameter_name"><p>targets</p></td>
<td class="parameter_description"><p>the table of targets that the drag will
<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>
@ -2879,7 +2862,7 @@ method sets <a class="link" href="GtkIconView.html#GtkIconView--reorderable" tit
</tr>
<tr>
<td class="parameter_name"><p>targets</p></td>
<td class="parameter_description"><p>the table of targets that the drag will
<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>
@ -3042,7 +3025,7 @@ gtk_icon_view_set_drag_dest_item (<em class="parameter"><code><a class="link" hr
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>The path of the item to highlight, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> The path of the item to highlight, or <code class="literal">NULL</code>. </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>
@ -3079,13 +3062,13 @@ gtk_icon_view_get_drag_dest_item (<em class="parameter"><code><a class="link" hr
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>Return location for the path of
<td class="parameter_description"><p> Return location for the path of
the highlighted item, or <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> Return location for the drop position, or <code class="literal">NULL</code>. </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>
@ -3129,13 +3112,13 @@ gtk_icon_view_get_dest_item_at_pos (<em class="parameter"><code><a class="link"
</tr>
<tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>Return location for the path of the item,
<td class="parameter_description"><p> Return location for the path of the item,
or <code class="literal">NULL</code>. </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 <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p> Return location for the drop position, or <code class="literal">NULL</code>. </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>
@ -3181,7 +3164,7 @@ This image is used for a drag icon.</p>
</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> 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>
@ -3799,6 +3782,6 @@ programmatically.</p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.27</div>
<hr>Generated by GTK-Doc V1.25</div>
</body>
</html>