New upstream version 3.23.1

This commit is contained in:
Iain Lane
2018-07-19 14:28:25 +01:00
853 changed files with 501219 additions and 479431 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="prev" href="TreeWidget.html" title="Tree and List Widget Overview">
<link rel="next" href="GtkTreeSelection.html" title="GtkTreeSelection">
<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -601,10 +601,10 @@
</div>
<div class="refsect1">
<a name="GtkTreeModel.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> GBoxed
<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a>
<span class="lineart">├──</span> GtkTreeIter
<span class="lineart">╰──</span> GtkTreePath
GInterface
<a href="/usr/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
<span class="lineart">╰──</span> GtkTreeModel
</pre>
</div>
@ -857,7 +857,7 @@ iterate over the rows in a tree model.</p>
</tr>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p> The user data passed to <a class="link" href="GtkTreeModel.html#gtk-tree-model-foreach" title="gtk_tree_model_foreach ()"><code class="function">gtk_tree_model_foreach()</code></a>. </p></td>
<td class="parameter_description"><p>The user data passed to <a class="link" href="GtkTreeModel.html#gtk-tree-model-foreach" title="gtk_tree_model_foreach ()"><code class="function">gtk_tree_model_foreach()</code></a>. </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>
@ -971,7 +971,7 @@ gtk_tree_path_new_from_indicesv (<em class="parameter"><code><span class="type">
<tbody>
<tr>
<td class="parameter_name"><p>indices</p></td>
<td class="parameter_description"><p> array of indices. </p></td>
<td class="parameter_description"><p>array of indices. </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=length]</span></td>
</tr>
<tr>
@ -1180,7 +1180,7 @@ The array should not be freed.</p>
</tr>
<tr>
<td class="parameter_name"><p>depth</p></td>
<td class="parameter_description"><p> return location for number of elements
<td class="parameter_description"><p>return location for number of elements
returned in the integer array, 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>
@ -1189,7 +1189,7 @@ returned in the integer array, or <code class="literal">NULL</code>. </p></td>
</div>
<div class="refsect3">
<a name="gtk-tree-path-get-indices-with-depth.returns"></a><h4>Returns</h4>
<p> The current
<p>The current
indices, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=depth][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
@ -1213,7 +1213,7 @@ gtk_tree_path_free (<em class="parameter"><code><a class="link" href="GtkTreeMod
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkTreeModel.html#GtkTreePath-struct" title="GtkTreePath"><span class="type">GtkTreePath</span></a>. </p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkTreeModel.html#GtkTreePath-struct" title="GtkTreePath"><span class="type">GtkTreePath</span></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>
@ -1600,7 +1600,7 @@ gtk_tree_row_reference_get_model (<em class="parameter"><code><a class="link" hr
</div>
<div class="refsect3">
<a name="gtk-tree-row-reference-get-model.returns"></a><h4>Returns</h4>
<p> the model. </p>
<p>the model. </p>
<p><span class="annotation">[<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.8</p>
@ -1629,7 +1629,7 @@ or <code class="literal">NULL</code> if the path pointed to is no longer valid.<
</div>
<div class="refsect3">
<a name="gtk-tree-row-reference-get-path.returns"></a><h4>Returns</h4>
<p> a current path, or <code class="literal">NULL</code>. </p>
<p>a current path, or <code class="literal">NULL</code>. </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>
</div>
@ -1651,7 +1651,7 @@ a current valid path.</p>
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>reference</p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkTreeModel.html#GtkTreeRowReference" title="GtkTreeRowReference"><span class="type">GtkTreeRowReference</span></a>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkTreeModel.html#GtkTreeRowReference" title="GtkTreeRowReference"><span class="type">GtkTreeRowReference</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>
</table></div>
@ -1680,7 +1680,7 @@ gtk_tree_row_reference_free (<em class="parameter"><code><a class="link" href="G
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>reference</p></td>
<td class="parameter_description"><p> a <a class="link" href="GtkTreeModel.html#GtkTreeRowReference" title="GtkTreeRowReference"><span class="type">GtkTreeRowReference</span></a>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkTreeModel.html#GtkTreeRowReference" title="GtkTreeRowReference"><span class="type">GtkTreeRowReference</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>
</table></div>
@ -1816,7 +1816,7 @@ model emitted the <a class="link" href="GtkTreeModel.html#GtkTreeModel-rows-reor
</tr>
<tr>
<td class="parameter_name"><p>new_order</p></td>
<td class="parameter_description"><p> the new order of rows. </p></td>
<td class="parameter_description"><p>the new order of rows. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>]</span></td>
</tr>
</tbody>
@ -1998,7 +1998,7 @@ not exist, <em class="parameter"><code>iter</code></em>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> the uninitialized <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>. </p></td>
<td class="parameter_description"><p>the uninitialized <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></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>]</span></td>
</tr>
<tr>
@ -2043,7 +2043,7 @@ exists. Otherwise, <em class="parameter"><code>iter</code></em>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> an uninitialized <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>. </p></td>
<td class="parameter_description"><p>an uninitialized <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></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>]</span></td>
</tr>
<tr>
@ -2086,7 +2086,7 @@ gtk_tree_model_get_iter_first (<em class="parameter"><code><a class="link" href=
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> the uninitialized <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>. </p></td>
<td class="parameter_description"><p>the uninitialized <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></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>]</span></td>
</tr>
</tbody>
@ -2174,7 +2174,7 @@ to free any allocated memory.</p>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> an empty <span class="type">GValue</span> to set. </p></td>
<td class="parameter_description"><p>an empty <span class="type">GValue</span> to set. </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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
</tbody>
@ -2209,7 +2209,7 @@ to be invalid.</p>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>. </p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input. Default is transfer none."><span class="acronym">in</span></acronym>]</span></td>
</tr>
</tbody>
@ -2249,7 +2249,7 @@ set to be invalid.</p>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>. </p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input. Default is transfer none."><span class="acronym">in</span></acronym>]</span></td>
</tr>
</tbody>
@ -2297,12 +2297,12 @@ function has been called.</p>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> the new <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to be set to the child. </p></td>
<td class="parameter_description"><p>the new <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to be set to the child. </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>parent</p></td>
<td class="parameter_description"><p> the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</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>
@ -2377,7 +2377,7 @@ of toplevel nodes is returned.</p>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</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>
@ -2427,12 +2427,12 @@ is set.</p>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the nth child. </p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the nth child. </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>parent</p></td>
<td class="parameter_description"><p> the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to get the child from, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to get the child from, 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>
@ -2488,7 +2488,7 @@ and <em class="parameter"><code>iter</code></em>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> the new <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the parent. </p></td>
<td class="parameter_description"><p>the new <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the parent. </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>
@ -2636,7 +2636,7 @@ The variable argument list should contain integer column numbers,
each column number followed by a place to store the value being
retrieved. The list is terminated by a -1. For example, to get a
value from column 0 with type <code class="literal">G_TYPE_STRING</code>, you would
write: <code class="literal">gtk_tree_model_get (model, iter, 0, &amp;place_string_here, -1)</code>,
write: <code class="literal">gtk_tree_model_get (model, iter, 0, &amp;amp;place_string_here, -1)</code>,
where <code class="literal">place_string_here</code> is a <span class="type">gchararray</span>
to be filled with the string.</p>
<p>Returned values with type <code class="literal">G_TYPE_OBJECT</code> have to be unreferenced,
@ -2737,7 +2737,7 @@ and <a class="link" href="GtkTreeModel.html#gtk-tree-model-foreach" title="gtk_t
</tr>
<tr>
<td class="parameter_name"><p>func</p></td>
<td class="parameter_description"><p> a function to be called on each row. </p></td>
<td class="parameter_description"><p>a function to be called on each row. </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>
@ -2990,7 +2990,7 @@ have been reordered</p></td>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p> a valid <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> pointing to the node
<td class="parameter_description"><p>a valid <a class="link" href="GtkTreeModel.html#GtkTreeIter-struct" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> pointing to the node
whose children have been reordered, or <code class="literal">NULL</code> if the depth
of <em class="parameter"><code>path</code></em>
is 0. </p></td>
@ -2998,7 +2998,7 @@ is 0. </p></td>
</tr>
<tr>
<td class="parameter_name"><p>new_order</p></td>
<td class="parameter_description"><p> an array of integers
<td class="parameter_description"><p>an array of integers
mapping the current position of each child to its old
position before the re-ordering,
i.e. <em class="parameter"><code>new_order</code></em>
@ -3550,6 +3550,6 @@ i.e. <em class="parameter"><code>new_order</code></em>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25</div>
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>