gtkliststore.html

最新gtk中文资料集

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</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>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="id3850237"></a><h3>
<a name="gtk-list-store-insert-before"></a>gtk_list_store_insert_before ()</h3>
<a class="indexterm" name="id3850251"></a><pre class="programlisting">void                gtk_list_store_insert_before        (<a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter,
                                                         <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 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="GtkListStore.html#gtk-list-store-set"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="GtkListStore.html#gtk-list-store-set-value"><code class="function">gtk_list_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>list_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</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>sibling</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="id3850432"></a><h3>
<a name="gtk-list-store-insert-after"></a>gtk_list_store_insert_after ()</h3>
<a class="indexterm" name="id3850446"></a><pre class="programlisting">void                gtk_list_store_insert_after         (<a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *sibling);</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="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, then the row will be
prepended to the beginning 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="GtkListStore.html#gtk-list-store-set"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="GtkListStore.html#gtk-list-store-set-value"><code class="function">gtk_list_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>list_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</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>sibling</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="id3850627"></a><h3>
<a name="gtk-list-store-insert-with-values"></a>gtk_list_store_insert_with_values ()</h3>
<a class="indexterm" name="id3850643"></a><pre class="programlisting">void                gtk_list_store_insert_with_values   (<a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_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> position,
                                                         ...);</pre>
<p>
Creates a new row at <em class="parameter"><code>position</code></em>.  <em class="parameter"><code>iter</code></em> will be changed to point to this new
row.  If <em class="parameter"><code>position</code></em> is larger than the number of rows on the list, then the
new row will be appended to the list. The row will be filled with the 
values given to this function. 
</p>
<p>
Calling
<code class="literal">gtk_list_store_insert_with_values(list_store, iter, position...)</code> 
has the same effect as calling 
</p>
<div class="informalexample"><pre class="programlisting">
gtk_list_store_insert (list_store, iter, position);
gtk_list_store_set (list_store, iter, ...);
</pre></div>
<p>
with the difference that the former will only emit a row_inserted signal,
while the latter will emit row_inserted, row_changed and, if the list store
is sorted, rows_reordered. Since emitting the rows_reordered signal
repeatedly can affect the performance of the program, 
<a class="link" href="GtkListStore.html#gtk-list-store-insert-with-values"><code class="function">gtk_list_store_insert_with_values()</code></a> should generally be preferred when
inserting rows in a sorted list store.</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>list_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</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, 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>
<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>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3850843"></a><h3>
<a name="gtk-list-store-insert-with-valuesv"></a>gtk_list_store_insert_with_valuesv ()</h3>
<a class="indexterm" name="id3850860"></a><pre class="programlisting">void                gtk_list_store_insert_with_valuesv  (<a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_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> position,
                                                         <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="GtkListStore.html#gtk-list-store-insert-with-values"><code class="function">gtk_list_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>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</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, 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>
<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.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3851077"></a><h3>
<a name="gtk-list-store-prepend"></a>gtk_list_store_prepend ()</h3>
<a class="indexterm" name="id3851090"></a><pre class="programlisting">void                gtk_list_store_prepend              (<a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store,
                                                         <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter);</pre>
<p>
Prepends a new row to <em class="parameter"><code>list_store</code></em>. <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="GtkListStore.html#gtk-list-store-set"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="GtkListStore.html#gtk-list-store-set-value"><code class="function">gtk_list_store_set_value()</code></a>.</p>
<p>