Synopsis#include <gtk/gtk.h> 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_set_valuesv (GtkTreeStore *tree_store, GtkTreeIter *iter, gint *columns, GValue *values, gint n_values); gboolean 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_insert_with_values (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *parent, gint position, ...); void gtk_tree_store_insert_with_valuesv (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *parent, gint position, gint *columns, GValue *values, gint n_values); 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); gboolean gtk_tree_store_iter_is_valid (GtkTreeStore *tree_store, GtkTreeIter *iter); void gtk_tree_store_reorder (GtkTreeStore *tree_store, GtkTreeIter *parent, gint *new_order); void gtk_tree_store_swap (GtkTreeStore *tree_store, GtkTreeIter *a, GtkTreeIter *b); void gtk_tree_store_move_before (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *position); void gtk_tree_store_move_after (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *position); Implemented InterfacesGtkTreeStore implements GtkBuildable, GtkTreeModel, GtkTreeDragSource, GtkTreeDragDest and GtkTreeSortable. DescriptionThe 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 drag and drop interfaces. GtkTreeStore as GtkBuildableThe 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. Example 25. A UI Definition fragment for a tree store <object class="GtkTreeStore"> <columns> <column type="gchararray"/> <column type="gchararray"/> <column type="gint"/> </columns> </object> Detailsgtk_tree_store_new ()GtkTreeStore* gtk_tree_store_new (gint n_columns, ...);
Creates a new tree store as with
As an example,
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
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
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_valuesv ()void gtk_tree_store_set_valuesv (GtkTreeStore *tree_store, GtkTreeIter *iter, gint *columns, GValue *values, gint n_values);
A variant of
Since 2.12 gtk_tree_store_remove ()gboolean gtk_tree_store_remove (GtkTreeStore *tree_store, GtkTreeIter *iter);
Removes
gtk_tree_store_insert ()void gtk_tree_store_insert (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *parent, gint position);
Creates a new row at
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
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
gtk_tree_store_insert_with_values ()void gtk_tree_store_insert_with_values (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *parent, gint position, ...);
Creates a new row at
Calling
gtk_tree_store_insert (tree_store, iter, position); gtk_tree_store_set (tree_store, iter, ...);
with the different that the former will only emit a row_inserted signal,
while the latter will emit row_inserted, row_changed and if the tree store
is sorted, rows_reordered. Since emitting the rows_reordered signal
repeatedly can affect the performance of the program,
Since 2.10 gtk_tree_store_insert_with_valuesv ()void gtk_tree_store_insert_with_valuesv (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *parent, gint position, gint *columns, GValue *values, gint n_values);
A variant of
Since 2.10 gtk_tree_store_prepend ()void gtk_tree_store_prepend (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *parent);
Prepends a new row to
gtk_tree_store_append ()void gtk_tree_store_append (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *parent);
Appends a new row to
gtk_tree_store_is_ancestor ()gboolean gtk_tree_store_is_ancestor (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *descendant);
Returns
gtk_tree_store_iter_depth ()gint gtk_tree_store_iter_depth (GtkTreeStore *tree_store, GtkTreeIter *iter);
Returns the depth of
gtk_tree_store_clear ()void gtk_tree_store_clear (GtkTreeStore *tree_store);
Removes all rows from
gtk_tree_store_iter_is_valid ()gboolean gtk_tree_store_iter_is_valid (GtkTreeStore *tree_store, GtkTreeIter *iter); WARNING: This function is slow. Only use it for debugging and/or testing purposes. Checks if the given iter is a valid iter for this GtkTreeStore.
Since 2.2 gtk_tree_store_reorder ()void gtk_tree_store_reorder (GtkTreeStore *tree_store, GtkTreeIter *parent, gint *new_order);
Reorders the children of
Since 2.2 gtk_tree_store_swap ()void gtk_tree_store_swap (GtkTreeStore *tree_store, GtkTreeIter *a, GtkTreeIter *b);
Swaps
Since 2.2 gtk_tree_store_move_before ()void gtk_tree_store_move_before (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *position);
Moves
Since 2.2 gtk_tree_store_move_after ()void gtk_tree_store_move_after (GtkTreeStore *tree_store, GtkTreeIter *iter, GtkTreeIter *position);
Moves
Since 2.2 |