gtktreestore.html

最新gtk中文资料集

<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the prepended row
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></p></td>
<td> A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3860803"></a><h3>
<a name="gtk-tree-store-append"></a>gtk_tree_store_append ()</h3>
<a class="indexterm" name="id3860816"></a><pre class="programlisting">void                gtk_tree_store_append               (<a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a> *tree_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *parent);</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="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, 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> will be changed to point to this new row.  The row will
be empty after this function is called.  To fill in values, you need to call
<a class="link" href="GtkTreeStore.html#gtk-tree-store-set"><code class="function">gtk_tree_store_set()</code></a> or <a class="link" href="GtkTreeStore.html#gtk-tree-store-set-value"><code class="function">gtk_tree_store_set_value()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the appended row
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></p></td>
<td> A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3861004"></a><h3>
<a name="gtk-tree-store-is-ancestor"></a>gtk_tree_store_is_ancestor ()</h3>
<a class="indexterm" name="id3861018"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_tree_store_is_ancestor          (<a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a> *tree_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *descendant);</pre>
<p>
Returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> 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
parent (or grandparent or great-grandparent) of <em class="parameter"><code>descendant</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>descendant</code></em>&#160;:</span></p></td>
<td> A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, if <em class="parameter"><code>iter</code></em> is an ancestor of <em class="parameter"><code>descendant</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3861201"></a><h3>
<a name="gtk-tree-store-iter-depth"></a>gtk_tree_store_iter_depth ()</h3>
<a class="indexterm" name="id3861215"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_tree_store_iter_depth           (<a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a> *tree_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter);</pre>
<p>
Returns the depth of <em class="parameter"><code>iter</code></em>.  This will be 0 for anything on the root level, 1
for anything down a level, etc.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The depth of <em class="parameter"><code>iter</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3861326"></a><h3>
<a name="gtk-tree-store-clear"></a>gtk_tree_store_clear ()</h3>
<a class="indexterm" name="id3861339"></a><pre class="programlisting">void                gtk_tree_store_clear                (<a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a> *tree_store);</pre>
<p>
Removes all rows from <em class="parameter"><code>tree_store</code></em></p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>tree_store</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3861402"></a><h3>
<a name="gtk-tree-store-iter-is-valid"></a>gtk_tree_store_iter_is_valid ()</h3>
<a class="indexterm" name="id3861418"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_tree_store_iter_is_valid        (<a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a> *tree_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter);</pre>
<p>
WARNING: This function is slow. Only use it for debugging and/or testing
purposes.
</p>
<p>
Checks if the given iter is a valid iter for this <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the iter is valid, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if the iter is invalid.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3861557"></a><h3>
<a name="gtk-tree-store-reorder"></a>gtk_tree_store_reorder ()</h3>
<a class="indexterm" name="id3861573"></a><pre class="programlisting">void                gtk_tree_store_reorder              (<a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a> *tree_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *parent,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *new_order);</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
indicated by <em class="parameter"><code>new_order</code></em>. Note that this function only works with
unsorted stores.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>p