GtkTreeStore

Name

GtkTreeStore -- 

Synopsis


#include <gtk/gtk.h>


struct      GtkTreeStore;
GtkTreeStore* gtk_tree_store_new            (gint n_columns,
                                             ...);
GtkTreeStore* gtk_tree_store_newv           (gint n_columns,
                                             GType *types);
void        gtk_tree_store_set_column_types (GtkTreeStore *tree_store,
                                             gint n_columns,
                                             GType *types);
void        gtk_tree_store_set_value        (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             gint column,
                                             GValue *value);
void        gtk_tree_store_set              (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             ...);
void        gtk_tree_store_set_valist       (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             va_list var_args);
void        gtk_tree_store_remove           (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter);
void        gtk_tree_store_insert           (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent,
                                             gint position);
void        gtk_tree_store_insert_before    (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent,
                                             GtkTreeIter *sibling);
void        gtk_tree_store_insert_after     (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent,
                                             GtkTreeIter *sibling);
void        gtk_tree_store_prepend          (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent);
void        gtk_tree_store_append           (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent);
gboolean    gtk_tree_store_is_ancestor      (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *descendant);
gint        gtk_tree_store_iter_depth       (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter);
void        gtk_tree_store_clear            (GtkTreeStore *tree_store);


Object Hierarchy


  GObject
   +----GtkTreeStore

Description

Details

struct GtkTreeStore

struct GtkTreeStore;


gtk_tree_store_new ()

GtkTreeStore* gtk_tree_store_new            (gint n_columns,
                                             ...);

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_newv ()

GtkTreeStore* gtk_tree_store_newv           (gint n_columns,
                                             GType *types);

Non vararg creation function. Used primarily by language bindings.


gtk_tree_store_set_column_types ()

void        gtk_tree_store_set_column_types (GtkTreeStore *tree_store,
                                             gint n_columns,
                                             GType *types);

This function is meant primarily for GObjects that inherit from GtkTreeStore, and should only be used when constructing a new GtkTreeStore. It will not function after a row has been added, or a method on the GtkTreeModel interface is called.


gtk_tree_store_set_value ()

void        gtk_tree_store_set_value        (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             gint column,
                                             GValue *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 ()

void        gtk_tree_store_set              (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             ...);

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. 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_set_valist ()

void        gtk_tree_store_set_valist       (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             va_list var_args);

See gtk_tree_store_set(); this version takes a va_list for use by language bindings.


gtk_tree_store_remove ()

void        gtk_tree_store_remove           (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter);

Removes iter from tree_store. After being removed, iter is set to the next valid row at that level, or invalidated if it previously pointed to the last one.


gtk_tree_store_insert ()

void        gtk_tree_store_insert           (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent,
                                             gint position);

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 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_before ()

void        gtk_tree_store_insert_before    (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent,
                                             GtkTreeIter *sibling);

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 ()

void        gtk_tree_store_insert_after     (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent,
                                             GtkTreeIter *sibling);

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 ()

void        gtk_tree_store_prepend          (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent);

Prepends a new row to tree_store. If parent is non-NULL, then it will prepend the new row before the first 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 ()

void        gtk_tree_store_append           (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *parent);

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 ()

gboolean    gtk_tree_store_is_ancestor      (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter,
                                             GtkTreeIter *descendant);

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 ()

gint        gtk_tree_store_iter_depth       (GtkTreeStore *tree_store,
                                             GtkTreeIter *iter);

Returns the depth of iter. This will be 0 for anything on the root level, 1 for anything down a level, etc.


gtk_tree_store_clear ()

void        gtk_tree_store_clear            (GtkTreeStore *tree_store);

Removes all rows from tree_store