GtkTreeModelSort

Name

GtkTreeModelSort -- 

Synopsis


#include <gtk/gtk.h>


struct      GtkTreeModelSort;
GtkTreeModel* gtk_tree_model_sort_new_with_model
                                            (GtkTreeModel *child_model);
GtkTreeModel* gtk_tree_model_sort_get_model (GtkTreeModelSort *tree_model);
GtkTreePath* gtk_tree_model_sort_convert_child_path_to_path
                                            (GtkTreeModelSort *tree_model_sort,
                                             GtkTreePath *child_path);
void        gtk_tree_model_sort_convert_child_iter_to_iter
                                            (GtkTreeModelSort *tree_model_sort,
                                             GtkTreeIter *sort_iter,
                                             GtkTreeIter *child_iter);
GtkTreePath* gtk_tree_model_sort_convert_path_to_child_path
                                            (GtkTreeModelSort *tree_model_sort,
                                             GtkTreePath *sorted_path);
void        gtk_tree_model_sort_convert_iter_to_child_iter
                                            (GtkTreeModelSort *tree_model_sort,
                                             GtkTreeIter *child_iter,
                                             GtkTreeIter *sorted_iter);
void        gtk_tree_model_sort_reset_default_sort_func
                                            (GtkTreeModelSort *tree_model_sort);
void        gtk_tree_model_sort_clear_cache (GtkTreeModelSort *tree_model_sort);


Object Hierarchy


  GObject
   +----GtkTreeModelSort

Properties


  "model"                GtkTreeModel         : Read / Write / Construct Only

Description

Details

struct GtkTreeModelSort

struct GtkTreeModelSort;


gtk_tree_model_sort_new_with_model ()

GtkTreeModel* gtk_tree_model_sort_new_with_model
                                            (GtkTreeModel *child_model);

Creates a new GtkTreeModel, with child_model as the child_model.


gtk_tree_model_sort_get_model ()

GtkTreeModel* gtk_tree_model_sort_get_model (GtkTreeModelSort *tree_model);

Returns the model the GtkTreeModelSort is sorting.


gtk_tree_model_sort_convert_child_path_to_path ()

GtkTreePath* gtk_tree_model_sort_convert_child_path_to_path
                                            (GtkTreeModelSort *tree_model_sort,
                                             GtkTreePath *child_path);

Converts child_path to a path relative to tree_model_sort. That is, child_path points to a path in the child model. The returned path will point to the same row in the sorted model. If child_path isn't a valid path on the child model, then NULL is returned.


gtk_tree_model_sort_convert_child_iter_to_iter ()

void        gtk_tree_model_sort_convert_child_iter_to_iter
                                            (GtkTreeModelSort *tree_model_sort,
                                             GtkTreeIter *sort_iter,
                                             GtkTreeIter *child_iter);

Sets sort_iter to point to the row in tree_model_sort that corresponds to the row pointed at by child_iter.


gtk_tree_model_sort_convert_path_to_child_path ()

GtkTreePath* gtk_tree_model_sort_convert_path_to_child_path
                                            (GtkTreeModelSort *tree_model_sort,
                                             GtkTreePath *sorted_path);

Converts sort_path to a path on the child model of tree_model_sort. That is, sort_path points ot a location in tree_model_sort. The returned path will point to the same location in the model not being sorted. If path does not point to a


gtk_tree_model_sort_convert_iter_to_child_iter ()

void        gtk_tree_model_sort_convert_iter_to_child_iter
                                            (GtkTreeModelSort *tree_model_sort,
                                             GtkTreeIter *child_iter,
                                             GtkTreeIter *sorted_iter);

Sets child_iter to point to the row pointed to by sorted_iter.


gtk_tree_model_sort_reset_default_sort_func ()

void        gtk_tree_model_sort_reset_default_sort_func
                                            (GtkTreeModelSort *tree_model_sort);

This resets the default sort function to be in the 'unsorted' state. That is, it is in the same order as the child model.


gtk_tree_model_sort_clear_cache ()

void        gtk_tree_model_sort_clear_cache (GtkTreeModelSort *tree_model_sort);

This function should almost never be called. It clears the tree_model_sort of any cached iterators that haven't been reffed with gtk_tree_model_ref_node(). This might be useful if the child model being sorted is static (and doesn't change often) and there has been a lot of unreffed access to nodes. As a side effect of this function, all unreffed iters will be invalid.

Properties

"model" (GtkTreeModel : Read / Write / Construct Only)