CtkTreeIterCompareFunc ()

gint
(*CtkTreeIterCompareFunc) (CtkTreeModel *model,
                           CtkTreeIter *a,
                           CtkTreeIter *b,
                           gpointer user_data);

A CtkTreeIterCompareFunc should return a negative integer, zero, or a positive integer if a sorts before b , a sorts with b , or a sorts after b respectively. If two iters compare as equal, their order in the sorted model is undefined. In order to ensure that the CtkTreeSortable behaves as expected, the CtkTreeIterCompareFunc must define a partial order on the model, i.e. it must be reflexive, antisymmetric and transitive.

For example, if model is a product catalogue, then a compare function for the “price” column could be one which returns price_of(@a) - price_of(@b).

ctk_tree_sortable_sort_column_changed ()

void
ctk_tree_sortable_sort_column_changed (CtkTreeSortable *sortable);

Emits a “sort-column-changed” signal on sortable .

ctk_tree_sortable_get_sort_column_id ()

gboolean
ctk_tree_sortable_get_sort_column_id (CtkTreeSortable *sortable,
                                      gint *sort_column_id,
                                      CtkSortType *order);

Fills in sort_column_id and order with the current sort column and the order. It returns TRUE unless the sort_column_id is CTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID or CTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID.

ctk_tree_sortable_set_sort_column_id ()

void
ctk_tree_sortable_set_sort_column_id (CtkTreeSortable *sortable,
                                      gint sort_column_id,
                                      CtkSortType order);

Sets the current sort column to be sort_column_id . The sortable will resort itself to reflect this change, after emitting a “sort-column-changed” signal. sort_column_id may either be a regular column id, or one of the following special values:

ctk_tree_sortable_set_sort_func ()

void
ctk_tree_sortable_set_sort_func (CtkTreeSortable *sortable,
                                 gint sort_column_id,
                                 CtkTreeIterCompareFunc sort_func,
                                 gpointer user_data,
                                 GDestroyNotify destroy);

Sets the comparison function used when sorting to be sort_func . If the current sort column id of sortable is the same as sort_column_id , then the model will sort using this function.

ctk_tree_sortable_set_default_sort_func ()

void
ctk_tree_sortable_set_default_sort_func
                               (CtkTreeSortable *sortable,
                                CtkTreeIterCompareFunc sort_func,
                                gpointer user_data,
                                GDestroyNotify destroy);

Sets the default comparison function used when sorting to be sort_func . If the current sort column id of sortable is CTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the model will sort using this function.

If sort_func is NULL, then there will be no default comparison function. This means that once the model has been sorted, it can’t go back to the default state. In this case, when the current sort column id of sortable is CTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted.

ctk_tree_sortable_has_default_sort_func ()

gboolean
ctk_tree_sortable_has_default_sort_func
                               (CtkTreeSortable *sortable);

Returns TRUE if the model has a default sort function. This is used primarily by CtkTreeViewColumns in order to determine if a model can go back to the default state, or not.

CtkTreeSortable

typedef struct _CtkTreeSortable CtkTreeSortable;

struct CtkTreeSortableIface

struct CtkTreeSortableIface {
  /* signals */
  void     (* sort_column_changed)   (CtkTreeSortable        *sortable);

  /* virtual table */
  gboolean (* get_sort_column_id)    (CtkTreeSortable        *sortable,
				      gint                   *sort_column_id,
				      CtkSortType            *order);
  void     (* set_sort_column_id)    (CtkTreeSortable        *sortable,
				      gint                    sort_column_id,
				      CtkSortType             order);
  void     (* set_sort_func)         (CtkTreeSortable        *sortable,
				      gint                    sort_column_id,
				      CtkTreeIterCompareFunc  sort_func,
				      gpointer                user_data,
				      GDestroyNotify          destroy);
  void     (* set_default_sort_func) (CtkTreeSortable        *sortable,
				      CtkTreeIterCompareFunc  sort_func,
				      gpointer                user_data,
				      GDestroyNotify          destroy);
  gboolean (* has_default_sort_func) (CtkTreeSortable        *sortable);
};

CTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID

#define CTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID (-1)

The CTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID can be used to make a CtkTreeSortable use the default sort function.

See also ctk_tree_sortable_set_sort_column_id()

CTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID

#define CTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID (-2)

The CTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID can be used to make a CtkTreeSortable use no sorting.

See also ctk_tree_sortable_set_sort_column_id()

The “sort-column-changed” signal

void
user_function (CtkTreeSortable *sortable,
               gpointer         user_data)

The ::sort-column-changed signal is emitted when the sort column or sort order of sortable is changed. The signal is emitted before the contents of sortable are resorted.

Flags: Run Last