Details
struct GtkTreeStore
struct GtkTreeStore
{
GObject parent;
gint stamp;
gpointer root;
gpointer last;
gint n_columns;
gint sort_column_id;
GList *sort_list;
GtkSortType order;
GType *column_headers;
GtkTreeIterCompareFunc default_sort_func;
gpointer default_sort_data;
GtkDestroyNotify default_sort_destroy;
}; |
gtk_tree_store_new ()
Creates a new tree store as with n_columns columns each of the types passed
in. As an example, gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING,
GDK_TYPE_PIXBUF); will create a new GtkTreeStore with three columns, of type
int, string and GDkPixbuf respectively.
gtk_tree_store_set_value ()
Sets the data in the cell specified by iter and column.
The type of value must be convertible to the type of the
column.
gtk_tree_store_set ()
Sets the value of one or more cells in the row referenced by iter.
The variable argument list should contain integer column numbers,
each column number followed by the value to be set. For example,
The list is terminated by a -1. For example, to set column 0 with type
G_TYPE_STRING to "Foo", you would write gtk_tree_store_set (store, iter,
0, "Foo", -1).
gtk_tree_store_remove ()
Removes iter from tree_store. After being removed, iter is set to the
next valid row at that level, or invalidated if it previeously pointed to the last one.
gtk_tree_store_insert ()
Creates a new row at position. If parent is non-NULL, then the row will be
made a child of parent. Otherwise, the row will be created at the toplevel.
If position is larger than the number of rows at that level, then the new
row will be inserted to the end of the list. iter will be changed to point
to this new row. The row will be empty before this function is called. To
fill in values, you need to call gtk_list_store_set or
gtk_list_store_set_value.
gtk_tree_store_insert_before ()
Inserts a new row before sibling. If sibling is NULL, then the row will
be appended to the beginning of the parent 's children. If parent and
sibling are NULL, then the row will be appended to the toplevel. If both
sibling and parent are set, then parent must be the parent of sibling.
When sibling is set, parent is optional.
iter will be changed to point to this new row. The row will be empty after
this function is called. To fill in values, you need to call
gtk_tree_store_set or gtk_tree_store_set_value.
gtk_tree_store_insert_after ()
Inserts a new row after sibling. If sibling is NULL, then the row will be
prepended to the beginning of the parent 's children. If parent and
sibling are NULL, then the row will be prepended to the toplevel. If both
sibling and parent are set, then parent must be the parent of sibling.
When sibling is set, parent is optional.
iter will be changed to point to this new row. The row will be empty after
this function is called. To fill in values, you need to call
gtk_tree_store_set or gtk_tree_store_set_value.
gtk_tree_store_prepend ()
Prepends a new row to tree_store. If parent is non-NULL, then it will prepend
the new row before the last child of parent, otherwise it will prepend a row
to the top level. iter will be changed to point to this new row. The row
will be empty after this function is called. To fill in values, you need to
call gtk_tree_store_set or gtk_tree_store_set_value.
gtk_tree_store_append ()
Appends a new row to tree_store. If parent is non-NULL, then it will append the
new row after the last child of parent, otherwise it will append a row to
the top level. iter will be changed to point to this new row. The row will
be empty after this function is called. To fill in values, you need to call
gtk_tree_store_set or gtk_tree_store_set_value.
gtk_tree_store_is_ancestor ()
Returns TRUE if iter is an ancestor of descendant. That is, iter is the
parent (or grandparent or great-grandparent) of descendant.
gtk_tree_store_iter_depth ()
Returns the depth of iter. This will be 0 for anything on the root level, 1
for anything down a level, etc.