краткое описание

#include <gtk/gtk.h>


            gtktreesortable;
            gtktreesortableiface;
gint        (*gtktreeitercomparefunc)       (gtktreemodel *model,
                                             gtktreeiter *a,
                                             gtktreeiter *b,
                                             gpointer user_data);
void        gtk_tree_sortable_sort_column_changed

                                            (gtktreesortable *sortable);
gboolean    gtk_tree_sortable_get_sort_column_id
                                            (gtktreesortable *sortable,
                                             gint *sort_column_id,
                                             gtksorttype *order);
void        gtk_tree_sortable_set_sort_column_id

                                            (gtktreesortable *sortable,
                                             gint sort_column_id,
                                             gtksorttype order);
void        gtk_tree_sortable_set_sort_func (gtktreesortable *sortable,
                                             gint sort_column_id,
                                             gtktreeitercomparefunc sort_func,
                                             gpointer user_data,
                                             gtkdestroynotify destroy);
void        gtk_tree_sortable_set_default_sort_func

                                            (gtktreesortable *sortable,
                                             gtktreeitercomparefunc sort_func,
                                             gpointer user_data,
                                             gtkdestroynotify destroy);
gboolean    gtk_tree_sortable_has_default_sort_func

                                            (gtktreesortable *sortable);

иерархия объектов

  ginterface
   +----gtktreesortable

предварительные условия

gtktreesortable требует gtktreemodel и gobject.

известные реализации

gtktreesortable осуществляется gtktreemodelsort, gtktreestore и gtkliststore.

сигналы

"sort-column-changed"
            void        user_function      (gtktreesortable *treesortable,
                                            gpointer         user_data)         : run last

описание

gtktreesortable – это интерфейс для реализации древовидных моделей поддерживающих сортировку. gtktreeview использует методы обеспечиваемые этим интерфейсом для сортировки моделей.

детали

gtktreesortable

typedef struct _gtktreesortable gtktreesortable;

gtktreesortableiface

typedef struct {
  gtypeinterface g_iface;

  /* сигналы */
  void     (* sort_column_changed)   (gtktreesortable        *sortable);

  /* виртуальная таблица */
  gboolean (* get_sort_column_id)    (gtktreesortable        *sortable,
                                      gint                   *sort_column_id,
                                      gtksorttype            *order);
  void     (* set_sort_column_id)    (gtktreesortable        *sortable,
                                      gint                    sort_column_id,
                                      gtksorttype             order);
  void     (* set_sort_func)         (gtktreesortable        *sortable,
                                      gint                    sort_column_id,
                                      gtktreeitercomparefunc  func,
                                      gpointer                data,
                                      gtkdestroynotify        destroy);
  void     (* set_default_sort_func) (gtktreesortable        *sortable,
                                      gtktreeitercomparefunc  func,
                                      gpointer                data,
                                      gtkdestroynotify        destroy);
  gboolean (* has_default_sort_func) (gtktreesortable        *sortable);
} gtktreesortableiface;

gtktreeitercomparefunc ()

gint        (*gtktreeitercomparefunc)       (gtktreemodel *model,
                                             gtktreeiter *a,
                                             gtktreeiter *b,
                                             gpointer user_data);

gtktreeitercomparefunc должна возвращать отрицательное целое, ноль, или положительное целое если a находится перед b, a равна b, или a после b соответственно. если два сравниваемых итератора эквивалентны, их порядок в сортируемой модели не определён. чтобы гарантировать что gtktreesortable ведёт себя как ожидается, gtktreeitercomparefunc должен определить частичный порядок в модели, то есть он должен быть рефлексивный, антисимметричный и транзитивный.

например, если model каталогизирует продукты, то когда функция сравнения для столбца "price" должна быть одним из возвращаемых price_of(a) - price_of(b).

gtk_tree_sortable_sort_column_changed ()

void        gtk_tree_sortable_sort_column_changed
                                            (gtktreesortable *sortable);

издаёт сигнал gtktreesortable::sort_column_changed

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. sortable будет пересортирован непосредственно для отражения этих изменений, после издания сигнала gtktreesortable::sort_column_changed. если sort_column_id это gtk_tree_sortable_default_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,
                                             gtkdestroynotify 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,
                                             gtkdestroynotify destroy);

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

если sort_func равен null, то функция сравнения по умолчанию отсутствует. это значит что после сортировки модели, она не может вернуть в состояние по умолчанию. в этом случае, когда id текущемго сортируемого столбца 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, для определения может ли модель возвращаться в состояние значения по умолчанию или нет.

детали сигнала

сигнал "sort-column-changed"

void        user_function                  (gtktreesortable *treesortable,
                                            gpointer         user_data)         : run last

смотрите также

gtktreemodel, gtktreeview