gtktreemodel.html

最新gtk中文资料集

</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></p></td>
<td>The current <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td>The current <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>data</code></em>&#160;:</span></p></td>
<td>The user data passed to <a class="link" href="GtkTreeModel.html#gtk-tree-model-foreach"><code class="function">gtk_tree_model_foreach()</code></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> to stop iterating, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> to continue.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3674797"></a><h3>
<a name="GtkTreeModelFlags"></a>enum GtkTreeModelFlags</h3>
<a class="indexterm" name="id3674810"></a><pre class="programlisting">typedef enum
{
  GTK_TREE_MODEL_ITERS_PERSIST = 1 &lt;&lt; 0,
  GTK_TREE_MODEL_LIST_ONLY = 1 &lt;&lt; 1
} GtkTreeModelFlags;
</pre>
<p>
These flags indicate various properties of a <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>.  They are
returned by <a class="link" href="GtkTreeModel.html#gtk-tree-model-get-flags"><code class="function">gtk_tree_model_get_flags()</code></a>, and must be static for the
lifetime of the object.  A more complete description of
<a class="link" href="GtkTreeModel.html#GTK-TREE-MODEL-ITERS-PERSIST:CAPS"><span class="type">GTK_TREE_MODEL_ITERS_PERSIST</span></a> can be found in the overview of this
section.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GTK-TREE-MODEL-ITERS-PERSIST:CAPS"></a><code class="literal">GTK_TREE_MODEL_ITERS_PERSIST</code></span></p></td>
<td>Iterators survive all signals emitted by the tree.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-TREE-MODEL-LIST-ONLY:CAPS"></a><code class="literal">GTK_TREE_MODEL_LIST_ONLY</code></span></p></td>
<td>The model is a list only, and never has children

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3674913"></a><h3>
<a name="gtk-tree-path-new"></a>gtk_tree_path_new ()</h3>
<a class="indexterm" name="id3674926"></a><pre class="programlisting"><a class="link" href="GtkTreeModel.html#GtkTreePath">GtkTreePath</a>*        gtk_tree_path_new                   (void);</pre>
<p>
Creates a new <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a>.  This structure refers to a row.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A newly created <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3674981"></a><h3>
<a name="gtk-tree-path-new-from-string"></a>gtk_tree_path_new_from_string ()</h3>
<a class="indexterm" name="id3674994"></a><pre class="programlisting"><a class="link" href="GtkTreeModel.html#GtkTreePath">GtkTreePath</a>*        gtk_tree_path_new_from_string       (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<p>
Creates a new <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> initialized to <em class="parameter"><code>path</code></em>.  <em class="parameter"><code>path</code></em> is expected to be a
colon separated list of numbers.  For example, the string "10:4:0" would
create a path of depth 3 pointing to the 11th child of the root node, the 5th
child of that 11th child, and the 1st child of that 5th child.  If an invalid
path string is passed in, <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> is returned.</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>path</code></em>&#160;:</span></p></td>
<td> The string representation of a path.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A newly-created <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</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="id3675109"></a><h3>
<a name="gtk-tree-path-new-from-indices"></a>gtk_tree_path_new_from_indices ()</h3>
<a class="indexterm" name="id3675124"></a><pre class="programlisting"><a class="link" href="GtkTreeModel.html#GtkTreePath">GtkTreePath</a>*        gtk_tree_path_new_from_indices      (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> first_index,
                                                         ...);</pre>
<p>
Creates a new path with <em class="parameter"><code>first_index</code></em> and <em class="parameter"><code>varargs</code></em> as indices.</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>first_index</code></em>&#160;:</span></p></td>
<td> first integer
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td> list of integers terminated by -1
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A newly created <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3675227"></a><h3>
<a name="gtk-tree-path-to-string"></a>gtk_tree_path_to_string ()</h3>
<a class="indexterm" name="id3675240"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*              gtk_tree_path_to_string             (<a class="link" href="GtkTreeModel.html#GtkTreePath">GtkTreePath</a> *path);</pre>
<p>
Generates a string representation of the path.  This string is a ':'
separated list of numbers.  For example, "4:10:0:3" would be an acceptable return value for this string.</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>path</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A newly-allocated string.  Must be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3675321"></a><h3>
<a name="gtk-tree-path-new-first"></a>gtk_tree_path_new_first ()</h3>
<a class="indexterm" name="id3675334"></a><pre class="programlisting"><a class="link" href="GtkTreeModel.html#GtkTreePath">GtkTreePath</a>*        gtk_tree_path_new_first             (void);</pre>
<p>
Creates a new <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a>.  The string representation of this path is "0"</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A new <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3675390"></a><h3>
<a name="gtk-tree-path-new-root"></a>gtk_tree_path_new_root()</h3>
<a class="indexterm" name="id3675407"></a><pre class="programlisting">#define gtk_tree_path_new_root() gtk_tree_path_new_first()
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tree_path_new_root</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="GtkTreeModel.html#gtk-tree-path-new-first"><code class="function">gtk_tree_path_new_first()</code></a> instead.</p>
</div>
<p>
An alternate name for <a class="link" href="GtkTreeModel.html#gtk-tree-path-new-first"><code class="function">gtk_tree_path_new_first()</code></a> provided for
compatibility reasons.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>A new <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a>.
</td>
</tr></tbody>
</table></div>