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, если sort_column_id не является GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID или GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID.

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

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 для определения, может ли модель вернуться к исходному состоянию или нет.