<refentry id="GtkTreeItem">
<refmeta>
<refentrytitle>GtkTreeItem</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkTreeItem</refname><refpurpose>The widget used for items in a <link linkend="GtkTree">GtkTree</link>.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

#include &lt;gtk/gtk.h&gt;


struct      <link linkend="GtkTreeItem-struct">GtkTreeItem</link>;
#define     <link linkend="GTK-TREE-ITEM-SUBTREE-CAPS">GTK_TREE_ITEM_SUBTREE</link>           (obj)
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-tree-item-new">gtk_tree_item_new</link>               (void);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-tree-item-new-with-label">gtk_tree_item_new_with_label</link>    (const <link linkend="gchar">gchar</link> *label);
void        <link linkend="gtk-tree-item-set-subtree">gtk_tree_item_set_subtree</link>       (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item,
                                             <link linkend="GtkWidget">GtkWidget</link> *subtree);
void        <link linkend="gtk-tree-item-remove-subtree">gtk_tree_item_remove_subtree</link>    (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);
void        <link linkend="gtk-tree-item-select">gtk_tree_item_select</link>            (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);
void        <link linkend="gtk-tree-item-deselect">gtk_tree_item_deselect</link>          (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);
void        <link linkend="gtk-tree-item-expand">gtk_tree_item_expand</link>            (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);
void        <link linkend="gtk-tree-item-collapse">gtk_tree_item_collapse</link>          (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);


</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----<link linkend="GtkObject">GtkObject</link>
         +----<link linkend="GtkWidget">GtkWidget</link>
               +----<link linkend="GtkContainer">GtkContainer</link>
                     +----<link linkend="GtkBin">GtkBin</link>
                           +----<link linkend="GtkItem">GtkItem</link>
                                 +----GtkTreeItem
</synopsis>

</refsect1>


<refsect1>
<title>Signal Prototypes</title>
<synopsis>

&quot;<link linkend="GtkTreeItem-collapse">collapse</link>&quot;  void        user_function      (<link linkend="GtkTreeItem">GtkTreeItem</link> *treeitem,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkTreeItem-expand">expand</link>&quot;    void        user_function      (<link linkend="GtkTreeItem">GtkTreeItem</link> *treeitem,
                                            <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsect1>


<refsect1>
<title>Description</title>
<para>
<warning>
<para>
<link linkend="GtkTree">GtkTree</link> is deprecated and unsupported. It is known to be
buggy. To use it, you must define the symbol <literal>GTK_ENABLE_BROKEN</literal>
prior to including the GTK+ header files. Use <link linkend="GtkTreeView">GtkTreeView</link> instead.
</para>
</warning>
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GtkTreeItem-struct">struct GtkTreeItem</title>
<programlisting>struct GtkTreeItem;</programlisting>
<warning>
<para>
<literal>GtkTreeItem</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GTK-TREE-ITEM-SUBTREE-CAPS">GTK_TREE_ITEM_SUBTREE()</title>
<programlisting>#define GTK_TREE_ITEM_SUBTREE(obj)      (GTK_TREE_ITEM(obj)-&gt;subtree)
</programlisting>
<warning>
<para>
<literal>GTK_TREE_ITEM_SUBTREE</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>obj</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-item-new">gtk_tree_item_new ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_tree_item_new               (void);</programlisting>
<warning>
<para>
<literal>gtk_tree_item_new</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-item-new-with-label">gtk_tree_item_new_with_label ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_tree_item_new_with_label    (const <link linkend="gchar">gchar</link> *label);</programlisting>
<warning>
<para>
<literal>gtk_tree_item_new_with_label</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>label</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-item-set-subtree">gtk_tree_item_set_subtree ()</title>
<programlisting>void        gtk_tree_item_set_subtree       (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item,
                                             <link linkend="GtkWidget">GtkWidget</link> *subtree);</programlisting>
<warning>
<para>
<literal>gtk_tree_item_set_subtree</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_item</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>subtree</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-item-remove-subtree">gtk_tree_item_remove_subtree ()</title>
<programlisting>void        gtk_tree_item_remove_subtree    (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);</programlisting>
<warning>
<para>
<literal>gtk_tree_item_remove_subtree</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_item</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-item-select">gtk_tree_item_select ()</title>
<programlisting>void        gtk_tree_item_select            (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);</programlisting>
<warning>
<para>
<literal>gtk_tree_item_select</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_item</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-item-deselect">gtk_tree_item_deselect ()</title>
<programlisting>void        gtk_tree_item_deselect          (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);</programlisting>
<warning>
<para>
<literal>gtk_tree_item_deselect</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_item</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-item-expand">gtk_tree_item_expand ()</title>
<programlisting>void        gtk_tree_item_expand            (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);</programlisting>
<warning>
<para>
<literal>gtk_tree_item_expand</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_item</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-tree-item-collapse">gtk_tree_item_collapse ()</title>
<programlisting>void        gtk_tree_item_collapse          (<link linkend="GtkTreeItem">GtkTreeItem</link> *tree_item);</programlisting>
<warning>
<para>
<literal>gtk_tree_item_collapse</literal> is deprecated and should not be used in newly-written code.
</para>
</warning>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>tree_item</parameter>&nbsp;:</entry>
<entry>


</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>

<refsect1>
<title>Signals</title>
<refsect2><title><anchor id="GtkTreeItem-collapse">The &quot;collapse&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkTreeItem">GtkTreeItem</link> *treeitem,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>treeitem</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkTreeItem-expand">The &quot;expand&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkTreeItem">GtkTreeItem</link> *treeitem,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>treeitem</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2>
</refsect1>



</refentry>
