gtktree.html

最新gtk中文资料集

                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> end);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tree_clear_items</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Removes the items at positions between <em class="parameter"><code>start</code></em> and <em class="parameter"><code>end</code></em> from the <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a> <em class="parameter"><code>tree</code></em>.
</p>
<p>
Removing an item from a <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a> dereferences the item, and thus usually destroys the item and any subtrees it may contain. If the item is not to be destroyed, use <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"
><code class="function">g_object_ref()</code></a> before removing it.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree</code></em>&#160;:</span></p></td>
<td>A pointer to a <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>start</code></em>&#160;:</span></p></td>
<td>A <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
><span class="type">gint</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>end</code></em>&#160;:</span></p></td>
<td>A <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
><span class="type">gint</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4595946"></a><h3>
<a name="gtk-tree-select-item"></a>gtk_tree_select_item ()</h3>
<a class="indexterm" name="id4595961"></a><pre class="programlisting">void                gtk_tree_select_item                (<a class="link" href="GtkTree.html" title="GtkTree">GtkTree</a> *tree,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> item);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tree_select_item</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Emits the <span class="type">select_item</span> signal for the child at position <em class="parameter"><code>item</code></em>, and thus selects it (unless it is unselected in a signal handler).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree</code></em>&#160;:</span></p></td>
<td>A pointer to a <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>item</code></em>&#160;:</span></p></td>
<td>A <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
><span class="type">gint</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4596075"></a><h3>
<a name="gtk-tree-unselect-item"></a>gtk_tree_unselect_item ()</h3>
<a class="indexterm" name="id4596090"></a><pre class="programlisting">void                gtk_tree_unselect_item              (<a class="link" href="GtkTree.html" title="GtkTree">GtkTree</a> *tree,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> item);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tree_unselect_item</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Emits the <span class="type">unselect_item</span> for the child at position <em class="parameter"><code>item</code></em>, and thus unselects it.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree</code></em>&#160;:</span></p></td>
<td>A pointer to a <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>item</code></em>&#160;:</span></p></td>
<td>A <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
><span class="type">gint</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4596203"></a><h3>
<a name="gtk-tree-select-child"></a>gtk_tree_select_child ()</h3>
<a class="indexterm" name="id4596219"></a><pre class="programlisting">void                gtk_tree_select_child               (<a class="link" href="GtkTree.html" title="GtkTree">GtkTree</a> *tree,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tree_item);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tree_select_child</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Emits the <span class="type">select_item</span> signal for the child <em class="parameter"><code>tree_item</code></em>, and thus selects it (unless it is unselected in a signal handler).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree</code></em>&#160;:</span></p></td>
<td>A pointer to a <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree_item</code></em>&#160;:</span></p></td>
<td>A pointer to the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that is to be selected.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4596332"></a><h3>
<a name="gtk-tree-unselect-child"></a>gtk_tree_unselect_child ()</h3>
<a class="indexterm" name="id4596347"></a><pre class="programlisting">void                gtk_tree_unselect_child             (<a class="link" href="GtkTree.html" title="GtkTree">GtkTree</a> *tree,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *tree_item);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tree_unselect_child</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Emits the <span class="type">unselect_item</span> signal for the child <em class="parameter"><code>tree_item</code></em>, and thus unselects it.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree</code></em>&#160;:</span></p></td>
<td>A pointer to a <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree_item</code></em>&#160;:</span></p></td>
<td>A pointer to the <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that is to be selected.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4596460"></a><h3>
<a name="gtk-tree-child-position"></a>gtk_tree_child_position ()</h3>
<a class="indexterm" name="id4596475"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_tree_child_position             (<a class="link" href="GtkTree.html" title="GtkTree">GtkTree</a> *tree,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tree_child_position</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the position of <em class="parameter"><code>child</code></em> in the <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a> <em class="parameter"><code>tree</code></em>.
</p>
<p>
If <em class="parameter"><code>child</code></em> is not a child of <em class="parameter"><code>tree</code></em>, then -1 is returned.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tree</code></em>&#160;:</span></p></td>
<td>A pointer to a <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em>&#160;:</span></p></td>
<td>A pointer to a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>A <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
><span class="type">gint</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4596626"></a><h3>
<a name="gtk-tree-set-selection-mode"></a>gtk_tree_set_selection_mode ()</h3>
<a class="indexterm" name="id4596642"></a><pre class="programlisting">void                gtk_tree_set_selection_mode         (<a class="link" href="GtkTree.html" title="GtkTree">GtkTree</a> *tree,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkSelectionMode">GtkSelectionMode</a> mode);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tree_set_selection_mode</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the selection mode for the <a class="link" href="GtkTree.html" title="GtkTree"><span class="type">GtkTree</span></a> <em class="parameter"><code>tree</code></em>.
</p>
<p>
<em class="parameter"><code>mode</code></em> can be one of
</p>
<div class="itemizedlist"><ul type="disc">
<li><p>
<a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-SINGLE:CAPS"><code class="literal">GTK_SELECTION_SINGLE</code></a> for when only one item can be selected at a time.
</p></li>
<li><p>
<a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-BROWSE:CAPS"><code class="literal">GTK_SELECTION_BROWSE</code></a> for when one item must be selected.
</p></li>
<li><p>
<a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-MULTIPLE:CAPS"><code class="literal">GTK_SELECTION_MULTIPLE</code></a> for when many items can be selected at once.
</p></li>
<li><p>
<a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-EXTENDED:CAPS"><code class="literal">GTK_SELECTION_EXTENDED</code></a> Reserved for later use.
</p></li>
</ul></div>
<p>
The selection mode is only defined for a root tree, as the root tree "owns" the selection.
</p>
<p>