GtkTreeSortable

GtkTreeIterCompareFunc ()

gint
(*GtkTreeIterCompareFunc) (GtkTreeModel *model,
                           GtkTreeIter *a,
                           GtkTreeIter *b,
                           gpointer user_data);

Функция GtkTreeIterCompareFunc должна возвращать отрицательное целое число, ноль или положительное целое число, если a сортируется перед b , a сортируется вместе с b , или a сортируется после b соответственно. Если два итератора сравниваются как равные, их порядок в отсортированной модели не определён. Чтобы гарантировать, что GtkTreeSortable работает как ожидается, GtkTreeIterCompareFunc должна определять частичный порядок в модели, т.е. она должна быть рефлексивной, антисимметричной и транзитивной.

Например, если model — это каталог продуктов, то функция сравнения для столбца «цена» могла бы возвращать price_of(@a) - price_of(@b).

gtk_tree_sortable_sort_column_changed ()

void
gtk_tree_sortable_sort_column_changed (GtkTreeSortable *sortable);

Издаёт сигнал «sort-column-changed» на sortable .

gtk_tree_sortable_get_sort_column_id ()

gboolean
gtk_tree_sortable_get_sort_column_id (GtkTreeSortable *sortable,
                                      gint *sort_column_id,
                                      GtkSortType *order);

Заполняет sort_column_id и order текущим столбцом сортировки и порядком. Возвращает TRUE, если столбец сортировки не является одним из специальных идентификаторов.

gtk_tree_sortable_set_sort_column_id ()

void
gtk_tree_sortable_set_sort_column_id (GtkTreeSortable *sortable,
                                      gint sort_column_id,
                                      GtkSortType order);

Устанавливает текущий столбец сортировки на sort_column_id . sortable пересортирует себя, чтобы отразить это изменение, после издания сигнала «sort-column-changed». sort_column_id может быть либо обычным идентификатором столбца, либо одним из следующих специальных значений:

gtk_tree_sortable_set_sort_func ()

void
gtk_tree_sortable_set_sort_func (GtkTreeSortable *sortable,
                                 gint sort_column_id,
                                 GtkTreeIterCompareFunc sort_func,
                                 gpointer user_data,
                                 GDestroyNotify destroy);

Устанавливает функцию сравнения, используемую при сортировке, на sort_func . Если текущий идентификатор столбца сортировки sortable совпадает с sort_column_id , то модель будет отсортирована с помощью этой функции.

gtk_tree_sortable_set_default_sort_func ()

void
gtk_tree_sortable_set_default_sort_func
                               (GtkTreeSortable *sortable,
                                GtkTreeIterCompareFunc sort_func,
                                gpointer user_data,
                                GDestroyNotify destroy);

Устанавливает функцию сравнения по умолчанию, используемую при сортировке, на sort_func. Если текущий идентификатор столбца сортировки sortable равен GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, то модель будет отсортирована с использованием этой функции.

Если sort_func имеет значение NULL, то функция сравнения по умолчанию не будет установлена. Это означает, что после сортировки модели нельзя будет вернуться к исходному состоянию. В этом случае, когда текущий идентификатор столбца сортировки sortable равен GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, модель будет не отсортирована.

gtk_tree_sortable_has_default_sort_func ()

gboolean
gtk_tree_sortable_has_default_sort_func
                               (GtkTreeSortable *sortable);

Возвращает TRUE, если модель имеет функцию сортировки по умолчанию. Это используется в основном GtkTreeViewColumns для определения, может ли модель вернуться к исходному состоянию или нет.