New upstream version 3.24.10
This commit is contained in:
Simon McVittie
@ -8,7 +8,7 @@
|
||||
<link rel="up" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
|
||||
<link rel="prev" href="TreeWidget.html" title="Tree and List Widget Overview">
|
||||
<link rel="next" href="GtkTreeSelection.html" title="GtkTreeSelection">
|
||||
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
|
||||
<meta name="generator" content="GTK-Doc V1.30.1 (XML mode)">
|
||||
<link rel="stylesheet" href="style.css" type="text/css">
|
||||
</head>
|
||||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||||
@ -733,30 +733,30 @@ callbacks.</p>
|
||||
22
|
||||
23
|
||||
24</pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="comment">// Three ways of getting the iter pointing to the location</span>
|
||||
<span class="usertype">GtkTreePath</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">path</span><span class="symbol">;</span>
|
||||
<span class="usertype">GtkTreeIter</span><span class="normal"> iter</span><span class="symbol">;</span>
|
||||
<span class="usertype">GtkTreeIter</span><span class="normal"> parent_iter</span><span class="symbol">;</span>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="c1">// Three ways of getting the iter pointing to the location</span>
|
||||
<span class="n">GtkTreePath</span> <span class="o">*</span><span class="n">path</span><span class="p">;</span>
|
||||
<span class="n">GtkTreeIter</span> <span class="n">iter</span><span class="p">;</span>
|
||||
<span class="n">GtkTreeIter</span> <span class="n">parent_iter</span><span class="p">;</span>
|
||||
|
||||
<span class="comment">// get the iterator from a string</span>
|
||||
<span class="function"><a href="GtkTreeModel.html#gtk-tree-model-get-iter-from-string">gtk_tree_model_get_iter_from_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="string">"3:2:5"</span><span class="symbol">);</span>
|
||||
<span class="c1">// get the iterator from a string</span>
|
||||
<span class="n">gtk_tree_model_get_iter_from_string</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span>
|
||||
<span class="o">&</span><span class="n">iter</span><span class="p">,</span>
|
||||
<span class="s">"3:2:5"</span><span class="p">);</span>
|
||||
|
||||
<span class="comment">// get the iterator from a path</span>
|
||||
<span class="normal">path </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-path-new-from-string">gtk_tree_path_new_from_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"3:2:5"</span><span class="symbol">);</span>
|
||||
<span class="function"><a href="GtkTreeModel.html#gtk-tree-model-get-iter">gtk_tree_model_get_iter</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> path</span><span class="symbol">);</span>
|
||||
<span class="function"><a href="GtkTreeModel.html#gtk-tree-path-free">gtk_tree_path_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">path</span><span class="symbol">);</span>
|
||||
<span class="c1">// get the iterator from a path</span>
|
||||
<span class="n">path</span> <span class="o">=</span> <span class="n">gtk_tree_path_new_from_string</span> <span class="p">(</span><span class="s">"3:2:5"</span><span class="p">);</span>
|
||||
<span class="n">gtk_tree_model_get_iter</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span> <span class="n">path</span><span class="p">);</span>
|
||||
<span class="n">gtk_tree_path_free</span> <span class="p">(</span><span class="n">path</span><span class="p">);</span>
|
||||
|
||||
<span class="comment">// walk the tree to find the iterator</span>
|
||||
<span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-nth-child">gtk_tree_model_iter_nth_child</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span>
|
||||
<span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> </span><span class="number">3</span><span class="symbol">);</span>
|
||||
<span class="normal">parent_iter </span><span class="symbol">=</span><span class="normal"> iter</span><span class="symbol">;</span>
|
||||
<span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-nth-child">gtk_tree_model_iter_nth_child</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="symbol">&</span><span class="normal">parent_iter</span><span class="symbol">,</span><span class="normal"> </span><span class="number">2</span><span class="symbol">);</span>
|
||||
<span class="normal">parent_iter </span><span class="symbol">=</span><span class="normal"> iter</span><span class="symbol">;</span>
|
||||
<span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-nth-child">gtk_tree_model_iter_nth_child</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">model</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="symbol">&</span><span class="normal">parent_iter</span><span class="symbol">,</span><span class="normal"> </span><span class="number">5</span><span class="symbol">);</span></pre></td>
|
||||
<span class="c1">// walk the tree to find the iterator</span>
|
||||
<span class="n">gtk_tree_model_iter_nth_child</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span>
|
||||
<span class="nb">NULL</span><span class="p">,</span> <span class="mi">3</span><span class="p">);</span>
|
||||
<span class="n">parent_iter</span> <span class="o">=</span> <span class="n">iter</span><span class="p">;</span>
|
||||
<span class="n">gtk_tree_model_iter_nth_child</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span>
|
||||
<span class="o">&</span><span class="n">parent_iter</span><span class="p">,</span> <span class="mi">2</span><span class="p">);</span>
|
||||
<span class="n">parent_iter</span> <span class="o">=</span> <span class="n">iter</span><span class="p">;</span>
|
||||
<span class="n">gtk_tree_model_iter_nth_child</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span>
|
||||
<span class="o">&</span><span class="n">parent_iter</span><span class="p">,</span> <span class="mi">5</span><span class="p">);</span></pre></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -823,53 +823,53 @@ how to write such a function, see the <a class="link" href="GtkListStore.html" t
|
||||
45
|
||||
46
|
||||
47</pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="keyword">enum</span>
|
||||
<span class="cbracket">{</span>
|
||||
<span class="normal"> STRING_COLUMN</span><span class="symbol">,</span>
|
||||
<span class="normal"> INT_COLUMN</span><span class="symbol">,</span>
|
||||
<span class="normal"> N_COLUMNS</span>
|
||||
<span class="cbracket">}</span><span class="symbol">;</span>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="k">enum</span>
|
||||
<span class="p">{</span>
|
||||
<span class="n">STRING_COLUMN</span><span class="p">,</span>
|
||||
<span class="n">INT_COLUMN</span><span class="p">,</span>
|
||||
<span class="n">N_COLUMNS</span>
|
||||
<span class="p">};</span>
|
||||
|
||||
<span class="symbol">...</span>
|
||||
<span class="p">...</span>
|
||||
|
||||
<span class="usertype">GtkTreeModel</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">list_store</span><span class="symbol">;</span>
|
||||
<span class="usertype">GtkTreeIter</span><span class="normal"> iter</span><span class="symbol">;</span>
|
||||
<span class="usertype">gboolean</span><span class="normal"> valid</span><span class="symbol">;</span>
|
||||
<span class="usertype">gint</span><span class="normal"> row_count </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
|
||||
<span class="n">GtkTreeModel</span> <span class="o">*</span><span class="n">list_store</span><span class="p">;</span>
|
||||
<span class="n">GtkTreeIter</span> <span class="n">iter</span><span class="p">;</span>
|
||||
<span class="n">gboolean</span> <span class="n">valid</span><span class="p">;</span>
|
||||
<span class="n">gint</span> <span class="n">row_count</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span>
|
||||
|
||||
<span class="comment">// make a new list_store</span>
|
||||
<span class="normal">list_store </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkListStore.html#gtk-list-store-new">gtk_list_store_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">N_COLUMNS</span><span class="symbol">,</span>
|
||||
<span class="normal"> G_TYPE_STRING</span><span class="symbol">,</span>
|
||||
<span class="normal"> G_TYPE_INT</span><span class="symbol">);</span>
|
||||
<span class="c1">// make a new list_store</span>
|
||||
<span class="n">list_store</span> <span class="o">=</span> <span class="n">gtk_list_store_new</span> <span class="p">(</span><span class="n">N_COLUMNS</span><span class="p">,</span>
|
||||
<span class="n">G_TYPE_STRING</span><span class="p">,</span>
|
||||
<span class="n">G_TYPE_INT</span><span class="p">);</span>
|
||||
|
||||
<span class="comment">// Fill the list store with data</span>
|
||||
<span class="function">populate_model</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list_store</span><span class="symbol">);</span>
|
||||
<span class="c1">// Fill the list store with data</span>
|
||||
<span class="n">populate_model</span> <span class="p">(</span><span class="n">list_store</span><span class="p">);</span>
|
||||
|
||||
<span class="comment">// Get the first iter in the list, check it is valid and walk</span>
|
||||
<span class="comment">// through the list, reading each row.</span>
|
||||
<span class="c1">// Get the first iter in the list, check it is valid and walk</span>
|
||||
<span class="c1">// through the list, reading each row.</span>
|
||||
|
||||
<span class="normal">valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-get-iter-first">gtk_tree_model_get_iter_first</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list_store</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">);</span>
|
||||
<span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">valid</span><span class="symbol">)</span>
|
||||
<span class="normal"> </span><span class="cbracket">{</span>
|
||||
<span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">str_data</span><span class="symbol">;</span>
|
||||
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> int_data</span><span class="symbol">;</span>
|
||||
<span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_get_iter_first</span> <span class="p">(</span><span class="n">list_store</span><span class="p">,</span>
|
||||
<span class="o">&</span><span class="n">iter</span><span class="p">);</span>
|
||||
<span class="k">while</span> <span class="p">(</span><span class="n">valid</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="n">gchar</span> <span class="o">*</span><span class="n">str_data</span><span class="p">;</span>
|
||||
<span class="n">gint</span> <span class="n">int_data</span><span class="p">;</span>
|
||||
|
||||
<span class="normal"> </span><span class="comment">// Make sure you terminate calls to gtk_tree_model_get() with a “-1” value</span>
|
||||
<span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-get">gtk_tree_model_get</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list_store</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">,</span>
|
||||
<span class="normal"> STRING_COLUMN</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">str_data</span><span class="symbol">,</span>
|
||||
<span class="normal"> INT_COLUMN</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">int_data</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">);</span>
|
||||
<span class="c1">// Make sure you terminate calls to gtk_tree_model_get() with a “-1” value</span>
|
||||
<span class="n">gtk_tree_model_get</span> <span class="p">(</span><span class="n">list_store</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span>
|
||||
<span class="n">STRING_COLUMN</span><span class="p">,</span> <span class="o">&</span><span class="n">str_data</span><span class="p">,</span>
|
||||
<span class="n">INT_COLUMN</span><span class="p">,</span> <span class="o">&</span><span class="n">int_data</span><span class="p">,</span>
|
||||
<span class="o">-</span><span class="mi">1</span><span class="p">);</span>
|
||||
|
||||
<span class="normal"> </span><span class="comment">// Do something with the data</span>
|
||||
<span class="normal"> </span><span class="function">g_print</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Row %d: (%s,%d)</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span>
|
||||
<span class="normal"> row_count</span><span class="symbol">,</span><span class="normal"> str_data</span><span class="symbol">,</span><span class="normal"> int_data</span><span class="symbol">);</span>
|
||||
<span class="normal"> </span><span class="function">g_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">str_data</span><span class="symbol">);</span>
|
||||
<span class="c1">// Do something with the data</span>
|
||||
<span class="n">g_print</span> <span class="p">(</span><span class="s">"Row %d: (%s,%d)</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span>
|
||||
<span class="n">row_count</span><span class="p">,</span> <span class="n">str_data</span><span class="p">,</span> <span class="n">int_data</span><span class="p">);</span>
|
||||
<span class="n">g_free</span> <span class="p">(</span><span class="n">str_data</span><span class="p">);</span>
|
||||
|
||||
<span class="normal"> valid </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTreeModel.html#gtk-tree-model-iter-next">gtk_tree_model_iter_next</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list_store</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="symbol">&</span><span class="normal">iter</span><span class="symbol">);</span>
|
||||
<span class="normal"> row_count</span><span class="symbol">++;</span>
|
||||
<span class="normal"> </span><span class="cbracket">}</span></pre></td>
|
||||
<span class="n">valid</span> <span class="o">=</span> <span class="n">gtk_tree_model_iter_next</span> <span class="p">(</span><span class="n">list_store</span><span class="p">,</span>
|
||||
<span class="o">&</span><span class="n">iter</span><span class="p">);</span>
|
||||
<span class="n">row_count</span><span class="o">++</span><span class="p">;</span>
|
||||
<span class="p">}</span></pre></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -3371,7 +3371,7 @@ this section.</p>
|
||||
<td class="enum_member_name"><p><a name="GTK-TREE-MODEL-ITERS-PERSIST:CAPS"></a>GTK_TREE_MODEL_ITERS_PERSIST</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>iterators survive all signals
|
||||
emitted by the tree</p>
|
||||
emitted by the tree</p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
@ -3379,7 +3379,7 @@ this section.</p>
|
||||
<td class="enum_member_name"><p><a name="GTK-TREE-MODEL-LIST-ONLY:CAPS"></a>GTK_TREE_MODEL_LIST_ONLY</p></td>
|
||||
<td class="enum_member_description">
|
||||
<p>the model is a list only, and never
|
||||
has children</p>
|
||||
has children</p>
|
||||
</td>
|
||||
<td class="enum_member_annotations"> </td>
|
||||
</tr>
|
||||
@ -3630,11 +3630,11 @@ i.e. <em class="parameter"><code>new_order</code></em>
|
||||
<div class="refsect1">
|
||||
<a name="GtkTreeModel.see-also"></a><h2>See Also</h2>
|
||||
<p><a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>, <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>, <a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</span></a>,
|
||||
<a class="link" href="gtk3-GtkTreeView-drag-and-drop.html" title="GtkTreeView drag-and-drop">GtkTreeView drag-and-drop</a>
|
||||
<a class="link" href="GtkTreeSortable.html" title="GtkTreeSortable"><span class="type">GtkTreeSortable</span></a></p>
|
||||
<a class="link" href="gtk3-GtkTreeView-drag-and-drop.html" title="GtkTreeView drag-and-drop">GtkTreeView drag-and-drop</a>
|
||||
<a class="link" href="GtkTreeSortable.html" title="GtkTreeSortable"><span class="type">GtkTreeSortable</span></a></p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="footer">
|
||||
<hr>Generated by GTK-Doc V1.29</div>
|
||||
<hr>Generated by GTK-Doc V1.30.1</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user