2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkTreeStore
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2007-06-11 03:41:27 +00:00
|
|
|
A tree-like data structure that can be used with the GtkTreeView
|
2000-10-30 23:21:38 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2002-11-02 13:43:01 +00:00
|
|
|
The #GtkTreeStore object is a list model for use with a #GtkTreeView
|
|
|
|
widget. It implements the #GtkTreeModel interface, and consequentialy,
|
|
|
|
can use all of the methods available there. It also implements the
|
|
|
|
#GtkTreeSortable interface so it can be sorted by the view. Finally,
|
|
|
|
it also implements the tree <link linkend="gtktreednd">drag and
|
|
|
|
drop</link> interfaces.
|
2007-07-01 23:38:07 +00:00
|
|
|
</para>
|
2000-10-30 23:21:38 +00:00
|
|
|
|
2007-07-01 23:38:07 +00:00
|
|
|
<refsect2 id="GtkTreeStore-BUILDER-UI">
|
|
|
|
<title>GtkTreeStore as GtkBuildable</title>
|
|
|
|
<para>
|
|
|
|
The GtkTreeStore implementation of the GtkBuildable interface allows
|
|
|
|
to specify the model columns with a <columns> element that may
|
|
|
|
contain multiple <column> elements, each specifying one model
|
|
|
|
column. The "type" attribute specifies the data type for the column.
|
2000-10-30 23:21:38 +00:00
|
|
|
</para>
|
2007-07-01 23:38:07 +00:00
|
|
|
<example>
|
|
|
|
<title>A UI Definition fragment for a tree store</title>
|
|
|
|
<programlisting><![CDATA[
|
|
|
|
<object class="GtkTreeStore">
|
|
|
|
<columns>
|
|
|
|
<column type="gchararray"/>
|
|
|
|
<column type="gchararray"/>
|
|
|
|
<column type="gint"/>
|
|
|
|
</columns>
|
|
|
|
</object>
|
|
|
|
]]></programlisting>
|
|
|
|
</example>
|
|
|
|
</refsect2>
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
2002-11-17 21:23:58 +00:00
|
|
|
#GtkTreeModel, #GtkTreeStore
|
2000-10-30 23:21:38 +00:00
|
|
|
</para>
|
|
|
|
|
2005-06-20 22:06:27 +00:00
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### STRUCT GtkTreeStore ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@n_columns:
|
|
|
|
@Varargs:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-09-27 00:09:41 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_newv ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@n_columns:
|
|
|
|
@types:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-11-21 21:43:47 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_set_column_types ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@n_columns:
|
|
|
|
@types:
|
|
|
|
|
|
|
|
|
2001-03-23 22:21:06 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_set_value ##### -->
|
2000-10-30 23:21:38 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@column:
|
|
|
|
@value:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_set ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@Varargs:
|
|
|
|
|
|
|
|
|
2001-09-27 00:09:41 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_set_valist ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@var_args:
|
|
|
|
|
|
|
|
|
2007-06-11 03:41:27 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_set_valuesv ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@columns:
|
|
|
|
@values:
|
|
|
|
@n_values:
|
|
|
|
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_remove ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
2002-06-08 06:48:27 +00:00
|
|
|
@Returns:
|
2000-10-30 23:21:38 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_insert ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@parent:
|
|
|
|
@position:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_insert_before ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@parent:
|
|
|
|
@sibling:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_insert_after ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@parent:
|
|
|
|
@sibling:
|
|
|
|
|
|
|
|
|
2006-05-05 16:21:19 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_insert_with_values ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@parent:
|
|
|
|
@position:
|
|
|
|
@Varargs:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_insert_with_valuesv ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@parent:
|
|
|
|
@position:
|
|
|
|
@columns:
|
|
|
|
@values:
|
|
|
|
@n_values:
|
|
|
|
|
|
|
|
|
2000-10-30 23:21:38 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_prepend ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@parent:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_append ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@parent:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_is_ancestor ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@descendant:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_iter_depth ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-09-27 00:09:41 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_clear ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
|
|
|
|
|
Documentation fixes.
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
2002-10-13 17:17:14 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_iter_is_valid ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_reorder ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@parent:
|
|
|
|
@new_order:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_swap ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@a:
|
|
|
|
@b:
|
|
|
|
|
|
|
|
|
2002-11-28 00:33:17 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tree_store_move_before ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@position:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tree_store_move_after ##### -->
|
Documentation fixes.
Sun Oct 13 18:50:14 2002 Soeren Sandmann <sandmann@daimi.au.dk>
* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
gtktreemodel.sgml,gtktable.sgml, gtktable.c:
Documentation fixes.
#85719, #90759, #95169, Owen Taylor;
#89221, Yao Zhang, Matthias Clasen;
#95592, Joost Faassen;
#92637, Vitaly Tishkov;
#94616, Ben Martin;
#94772, sbaillie@bigpond.net.au;
2002-10-13 17:17:14 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tree_store:
|
|
|
|
@iter:
|
|
|
|
@position:
|
|
|
|
|
|
|
|
|