gtktreestore.html

最新gtk中文资料集

</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> for the row being modified
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td> pairs of column number and value, terminated with -1
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3858738"></a><h3>
<a name="gtk-tree-store-set-valist"></a>gtk_tree_store_set_valist ()</h3>
<a class="indexterm" name="id3858752"></a><pre class="programlisting">void                gtk_tree_store_set_valist           (<a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a> *tree_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter,
                                                         va_list var_args);</pre>
<p>
See <a class="link" href="GtkTreeStore.html#gtk-tree-store-set"><code class="function">gtk_tree_store_set()</code></a>; this version takes a <span class="type">va_list</span> for
use by language bindings.</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> for the row being modified
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>var_args</code></em>&#160;:</span></p></td>
<td> <span class="type">va_list</span> of column/value pairs
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3858880"></a><h3>
<a name="gtk-tree-store-set-valuesv"></a>gtk_tree_store_set_valuesv ()</h3>
<a class="indexterm" name="id3858896"></a><pre class="programlisting">void                gtk_tree_store_set_valuesv          (<a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a> *tree_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *columns,
                                                         <a
href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue"
>GValue</a> *values,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_values);</pre>
<p>
A variant of <a class="link" href="GtkTreeStore.html#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
the number of columns to change is not known until run-time.</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> for the row being modified
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>columns</code></em>&#160;:</span></p></td>
<td> an array of column numbers
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>values</code></em>&#160;:</span></p></td>
<td> an array of GValues
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_values</code></em>&#160;:</span></p></td>
<td> the length of the <em class="parameter"><code>columns</code></em> and <em class="parameter"><code>values</code></em> arrays
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3859083"></a><h3>
<a name="gtk-tree-store-remove"></a>gtk_tree_store_remove ()</h3>
<a class="indexterm" name="id3859097"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_tree_store_remove               (<a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a> *tree_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter);</pre>
<p>
Removes <em class="parameter"><code>iter</code></em> from <em class="parameter"><code>tree_store</code></em>.  After being removed, <em class="parameter"><code>iter</code></em> is set to the
next valid row at that level, or invalidated if it previously pointed to the
last one.</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> <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 still valid, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if not.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3859241"></a><h3>
<a name="gtk-tree-store-insert"></a>gtk_tree_store_insert ()</h3>
<a class="indexterm" name="id3859254"></a><pre class="programlisting">void                gtk_tree_store_insert               (<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,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> position);</pre>
<p>
Creates a new row at <em class="parameter"><code>position</code></em>.  If parent is non-<a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, 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> is larger than the number of rows at that level, then the new
row will be inserted to the end of the list.  <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 new 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>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em>&#160;:</span></p></td>
<td> position to insert the new row
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3859466"></a><h3>
<a name="gtk-tree-store-insert-before"></a>gtk_tree_store_insert_before ()</h3>
<a class="indexterm" name="id3859479"></a><pre class="programlisting">void                gtk_tree_store_insert_before        (<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,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *sibling);</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="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, 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="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, 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
set, then <em class="parameter"><code>parent</code></em> must be the parent of <em class="parameter"><code>sibling</code></em>.  When <em class="parameter"><code>sibling</code></em> is set,
<em class="parameter"><code>parent</code></em> is optional.
</p>
<p>
<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 new row
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>parent</code></em>&#160;:</span></p></td>