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

New upstream version 3.24.8

Browse Source
This commit is contained in:
Iain Lane
2019-04-11 09:41:47 +01:00
parent 1f6000bb1a 5428379fad
commit 2c2e749fa0
549 changed files with 776552 additions and 386298 deletions
Download Patch File Download Diff File Expand all files Collapse all files

122
docs/reference/gtk/html/GtkTreeStore.html
View File

@ -99,7 +99,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkTreeStore.html#gtk-tree-store-remove" title="gtk_tree_store_remove ()">gtk_tree_store_remove</a> <span class="c_punctuation">()</span>
@ -163,7 +163,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkTreeStore.html#gtk-tree-store-is-ancestor" title="gtk_tree_store_is_ancestor ()">gtk_tree_store_is_ancestor</a> <span class="c_punctuation">()</span>
@ -171,7 +171,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkTreeStore.html#gtk-tree-store-iter-depth" title="gtk_tree_store_iter_depth ()">gtk_tree_store_iter_depth</a> <span class="c_punctuation">()</span>
@ -187,7 +187,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkTreeStore.html#gtk-tree-store-iter-is-valid" title="gtk_tree_store_iter_is_valid ()">gtk_tree_store_iter_is_valid</a> <span class="c_punctuation">()</span>
@ -243,7 +243,7 @@
</div>
<div class="refsect1">
<a name="GtkTreeStore.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GtkTreeStore
</pre>
</div>
@ -305,7 +305,7 @@ attribute specifies the data type for the column.</p>
<div class="refsect2">
<a name="gtk-tree-store-new"></a><h3>gtk_tree_store_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="returnvalue">GtkTreeStore</span></a> *
gtk_tree_store_new (<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_columns</code></em>,
gtk_tree_store_new (<em class="parameter"><code><span class="type">gint</span> n_columns</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Creates a new tree store as with <em class="parameter"><code>n_columns</code></em>
columns each of the types passed
@ -313,7 +313,7 @@ in. Note that only types derived from standard GObject fundamental types
are supported.</p>
<p>As an example, <code class="literal">gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING,
GDK_TYPE_PIXBUF);</code> will create a new <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> with three columns, of type
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>, <a href="https://developer.gnome.org/gobject/unstable/gobject-Standard-Parameter-and-Value-Types.html#gchararray"><span class="type">gchararray</span></a>, and <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> respectively.</p>
<span class="type">gint</span>, <span class="type">gchararray</span>, and <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> respectively.</p>
<div class="refsect3">
<a name="gtk-tree-store-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -330,7 +330,7 @@ GDK_TYPE_PIXBUF);</code> will create a new <a class="link" href="GtkTreeStore.ht
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>all <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> types for the columns, from first to last</p></td>
<td class="parameter_description"><p>all <span class="type">GType</span> types for the columns, from first to last</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -345,8 +345,8 @@ GDK_TYPE_PIXBUF);</code> will create a new <a class="link" href="GtkTreeStore.ht
<div class="refsect2">
<a name="gtk-tree-store-newv"></a><h3>gtk_tree_store_newv ()</h3>
<pre class="programlisting"><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="returnvalue">GtkTreeStore</span></a> *
gtk_tree_store_newv (<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_columns</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>);</pre>
gtk_tree_store_newv (<em class="parameter"><code><span class="type">gint</span> n_columns</code></em>,
<em class="parameter"><code><span class="type">GType</span> *types</code></em>);</pre>
<p>Non vararg creation function. Used primarily by language bindings.</p>
<p><span class="annotation">[<acronym title="Rename the original symbol's name to SYMBOL."><span class="acronym">rename-to</span></acronym> gtk_tree_store_new]</span></p>
<div class="refsect3">
@ -365,7 +365,7 @@ gtk_tree_store_newv (<em class="parameter"><code><a href="https://developer.gnom
</tr>
<tr>
<td class="parameter_name"><p>types</p></td>
<td class="parameter_description"><p>an array of <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> types for the columns, from first to last. </p></td>
<td class="parameter_description"><p>an array of <span class="type">GType</span> types for the columns, from first to last. </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_columns]</span></td>
</tr>
</tbody>
@ -382,9 +382,9 @@ gtk_tree_store_newv (<em class="parameter"><code><a href="https://developer.gnom
<a name="gtk-tree-store-set-column-types"></a><h3>gtk_tree_store_set_column_types ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_tree_store_set_column_types (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_columns</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>);</pre>
<p>This function is meant primarily for <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObjects</span></a> that inherit from
<em class="parameter"><code><span class="type">gint</span> n_columns</code></em>,
<em class="parameter"><code><span class="type">GType</span> *types</code></em>);</pre>
<p>This function is meant primarily for <span class="type">GObjects</span> that inherit from
<a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>, and should only be used when constructing a new
<a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>. It will not function after a row has been added,
or a method on the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> interface is called.</p>
@ -409,7 +409,7 @@ or a method on the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"
</tr>
<tr>
<td class="parameter_name"><p>types</p></td>
<td class="parameter_description"><p>An array of <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> types, one for each column. </p></td>
<td class="parameter_description"><p>An array of <span class="type">GType</span> types, one for each column. </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_columns]</span></td>
</tr>
</tbody>
@ -422,8 +422,8 @@ or a method on the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_tree_store_set_value (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *value</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> column</code></em>,
<em class="parameter"><code><span class="type">GValue</span> *value</code></em>);</pre>
<p>Sets the data in the cell specified by <em class="parameter"><code>iter</code></em>
and <em class="parameter"><code>column</code></em>
.
@ -475,10 +475,10 @@ gtk_tree_store_set (<em class="parameter"><code><a class="link" href="GtkTreeSto
The variable argument list should contain integer column numbers,
each column number followed by the value to be set.
The list is terminated by a -1. For example, to set column 0 with type
<a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a> to “Foo”, you would write
<code class="literal">G_TYPE_STRING</code> to “Foo”, you would write
<code class="literal">gtk_tree_store_set (store, iter, 0, "Foo", -1)</code>.</p>
<p>The value will be referenced by the store if it is a <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a>, and it
will be copied if it is a <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a> or <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a>.</p>
<p>The value will be referenced by the store if it is a <code class="literal">G_TYPE_OBJECT</code>, and it
will be copied if it is a <code class="literal">G_TYPE_STRING</code> or <code class="literal">G_TYPE_BOXED</code>.</p>
<div class="refsect3">
<a name="gtk-tree-store-set.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -550,9 +550,9 @@ use by language bindings.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_tree_store_set_valuesv (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *columns</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *values</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_values</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> *columns</code></em>,
<em class="parameter"><code><span class="type">GValue</span> *values</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_values</code></em>);</pre>
<p>A variant of <a class="link" href="GtkTreeStore.html#gtk-tree-store-set-valist" title="gtk_tree_store_set_valist ()"><code class="function">gtk_tree_store_set_valist()</code></a> which takes
the columns and values as two arrays, instead of varargs. This
function is mainly intended for language bindings or in case
@ -602,7 +602,7 @@ arrays</p></td>
<hr>
<div class="refsect2">
<a name="gtk-tree-store-remove"></a><h3>gtk_tree_store_remove ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_tree_store_remove (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
<p>Removes <em class="parameter"><code>iter</code></em>
@ -635,8 +635,8 @@ last one.</p>
</div>
<div class="refsect3">
<a name="gtk-tree-store-remove.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>iter</code></em>
is still valid, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not.</p>
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
is still valid, <code class="literal">FALSE</code> if not.</p>
</div>
</div>
<hr>
@ -646,9 +646,9 @@ is still valid, <a href="https://developer.gnome.org/glib/unstable/glib-Standard
gtk_tree_store_insert (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *parent</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
<p>Creates a new row at <em class="parameter"><code>position</code></em>
. If parent is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the row will be
. If parent is non-<code class="literal">NULL</code>, then the row will be
made a child of <em class="parameter"><code>parent</code></em>
. Otherwise, the row will be created at the toplevel.
If <em class="parameter"><code>position</code></em>
@ -679,7 +679,7 @@ called. To fill in values, you need to call <a class="link" href="GtkTreeStore.
</tr>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>A valid <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="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
@ -701,11 +701,11 @@ gtk_tree_store_insert_before (<em class="parameter"><code><a class="link" href="
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *sibling</code></em>);</pre>
<p>Inserts a new row before <em class="parameter"><code>sibling</code></em>
. If <em class="parameter"><code>sibling</code></em>
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the row will
is <code class="literal">NULL</code>, then the row will
be appended to <em class="parameter"><code>parent</code></em>
’s children. If <em class="parameter"><code>parent</code></em>
and <em class="parameter"><code>sibling</code></em>
are <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
are <code class="literal">NULL</code>, then
the row will be appended to the toplevel. If both <em class="parameter"><code>sibling</code></em>
and <em class="parameter"><code>parent</code></em>
are
@ -740,12 +740,12 @@ this function is called. To fill in values, you need to call
</tr>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>A valid <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="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>sibling</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>A valid <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="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -762,11 +762,11 @@ gtk_tree_store_insert_after (<em class="parameter"><code><a class="link" href="G
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *sibling</code></em>);</pre>
<p>Inserts a new row after <em class="parameter"><code>sibling</code></em>
. If <em class="parameter"><code>sibling</code></em>
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the row will be
is <code class="literal">NULL</code>, then the row will be
prepended to <em class="parameter"><code>parent</code></em>
’s children. If <em class="parameter"><code>parent</code></em>
and <em class="parameter"><code>sibling</code></em>
are <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then
are <code class="literal">NULL</code>, then
the row will be prepended to the toplevel. If both <em class="parameter"><code>sibling</code></em>
and <em class="parameter"><code>parent</code></em>
are
@ -801,12 +801,12 @@ this function is called. To fill in values, you need to call
</tr>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>A valid <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="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>sibling</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>A valid <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="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -820,7 +820,7 @@ this function is called. To fill in values, you need to call
gtk_tree_store_insert_with_values (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *parent</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
<em class="parameter"><code><span class="type">gint</span> position</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Creates a new row at <em class="parameter"><code>position</code></em>
. <em class="parameter"><code>iter</code></em>
@ -868,12 +868,12 @@ inserting rows in a sorted tree store.</p>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p>An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set the new row, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set the new row, 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>parent</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>A valid <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="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
@ -898,10 +898,10 @@ inserting rows in a sorted tree store.</p>
gtk_tree_store_insert_with_valuesv (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *parent</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *columns</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *values</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_values</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> position</code></em>,
<em class="parameter"><code><span class="type">gint</span> *columns</code></em>,
<em class="parameter"><code><span class="type">GValue</span> *values</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_values</code></em>);</pre>
<p>A variant of <a class="link" href="GtkTreeStore.html#gtk-tree-store-insert-with-values" title="gtk_tree_store_insert_with_values ()"><code class="function">gtk_tree_store_insert_with_values()</code></a> which takes
the columns and values as two arrays, instead of varargs. This
function is mainly intended for language bindings.</p>
@ -922,12 +922,12 @@ function is mainly intended for language bindings.</p>
</tr>
<tr>
<td class="parameter_name"><p>iter</p></td>
<td class="parameter_description"><p>An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set the new row, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set the new row, 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>parent</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>A valid <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="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
@ -966,7 +966,7 @@ gtk_tree_store_prepend (<em class="parameter"><code><a class="link" href="GtkTre
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *parent</code></em>);</pre>
<p>Prepends a new row to <em class="parameter"><code>tree_store</code></em>
. If <em class="parameter"><code>parent</code></em>
is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then it will prepend
is non-<code class="literal">NULL</code>, then it will prepend
the new row before the first child of <em class="parameter"><code>parent</code></em>
, otherwise it will prepend a row
to the top level. <em class="parameter"><code>iter</code></em>
@ -994,7 +994,7 @@ call <a class="link" href="GtkTreeStore.html#gtk-tree-store-set" title="gtk_tree
</tr>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>A valid <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="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -1010,7 +1010,7 @@ gtk_tree_store_append (<em class="parameter"><code><a class="link" href="GtkTree
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *parent</code></em>);</pre>
<p>Appends a new row to <em class="parameter"><code>tree_store</code></em>
. If <em class="parameter"><code>parent</code></em>
is non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then it will append the
is non-<code class="literal">NULL</code>, then it will append the
new row after the last child of <em class="parameter"><code>parent</code></em>
, otherwise it will append a row to
the top level. <em class="parameter"><code>iter</code></em>
@ -1038,7 +1038,7 @@ be empty after this function is called. To fill in values, you need to call
</tr>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>A valid <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="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -1048,11 +1048,11 @@ be empty after this function is called. To fill in values, you need to call
<hr>
<div class="refsect2">
<a name="gtk-tree-store-is-ancestor"></a><h3>gtk_tree_store_is_ancestor ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_tree_store_is_ancestor (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *descendant</code></em>);</pre>
<p>Returns <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>iter</code></em>
<p>Returns <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
is an ancestor of <em class="parameter"><code>descendant</code></em>
. That is, <em class="parameter"><code>iter</code></em>
is the
@ -1087,7 +1087,7 @@ parent (or grandparent or great-grandparent) of <em class="parameter"><code>desc
</div>
<div class="refsect3">
<a name="gtk-tree-store-is-ancestor.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if <em class="parameter"><code>iter</code></em>
<p> <code class="literal">TRUE</code>, if <em class="parameter"><code>iter</code></em>
is an ancestor of <em class="parameter"><code>descendant</code></em>
</p>
</div>
@ -1095,7 +1095,7 @@ is an ancestor of <em class="parameter"><code>descendant</code></em>
<hr>
<div class="refsect2">
<a name="gtk-tree-store-iter-depth"></a><h3>gtk_tree_store_iter_depth ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_tree_store_iter_depth (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
<p>Returns the depth of <em class="parameter"><code>iter</code></em>
@ -1155,7 +1155,7 @@ gtk_tree_store_clear (<em class="parameter"><code><a class="link" href="GtkTreeS
<hr>
<div class="refsect2">
<a name="gtk-tree-store-iter-is-valid"></a><h3>gtk_tree_store_iter_is_valid ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_tree_store_iter_is_valid (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
<p>WARNING: This function is slow. Only use it for debugging and/or testing
@ -1185,7 +1185,7 @@ purposes.</p>
</div>
<div class="refsect3">
<a name="gtk-tree-store-iter-is-valid.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the iter is valid, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the iter is invalid.</p>
<p> <code class="literal">TRUE</code> if the iter is valid, <code class="literal">FALSE</code> if the iter is invalid.</p>
</div>
<p class="since">Since: 2.2</p>
</div>
@ -1195,7 +1195,7 @@ purposes.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_tree_store_reorder (<em class="parameter"><code><a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a> *tree_store</code></em>,
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *parent</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *new_order</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> *new_order</code></em>);</pre>
<p>Reorders the children of <em class="parameter"><code>parent</code></em>
in <em class="parameter"><code>tree_store</code></em>
to follow the order
@ -1219,7 +1219,7 @@ unsorted stores.</p>
</tr>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>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="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
@ -1291,7 +1291,7 @@ gtk_tree_store_move_before (<em class="parameter"><code><a class="link" href="Gt
<em class="parameter"><code>position</code></em>
should be in the same level. Note that this function only
works with unsorted stores. If <em class="parameter"><code>position</code></em>
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>iter</code></em>
is <code class="literal">NULL</code>, <em class="parameter"><code>iter</code></em>
will be
moved to the end of the level.</p>
<div class="refsect3">
@ -1315,7 +1315,7 @@ moved to the end of the level.</p>
</tr>
<tr>
<td class="parameter_name"><p>position</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>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="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -1338,7 +1338,7 @@ gtk_tree_store_move_after (<em class="parameter"><code><a class="link" href="Gtk
<em class="parameter"><code>position</code></em>
should be in the same level. Note that this function only
works with unsorted stores. If <em class="parameter"><code>position</code></em>
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>iter</code></em>
is <code class="literal">NULL</code>, <em class="parameter"><code>iter</code></em>
will be moved
to the start of the level.</p>
<div class="refsect3">