GtkSortListModel

gtk_sort_list_model_new ()

GtkSortListModel *
gtk_sort_list_model_new (GListModel *model,
                         GtkSorter *sorter);

Создаёт новый сортированный список моделей, который использует sorter для сортировки model.

gtk_sort_list_model_set_sorter ()

void
gtk_sort_list_model_set_sorter (GtkSortListModel *self,
                                GtkSorter *sorter);

Устанавливает новый сортировщик для self .

gtk_sort_list_model_get_sorter ()

GtkSorter *
gtk_sort_list_model_get_sorter (GtkSortListModel *self);

Возвращает сортировщик, используемый для сортировки self .

gtk_sort_list-model-set-model ()

void
gtk_sort_list_model_set_model (GtkSortListModel *self,
                               GListModel *model);

Устанавливает модель для сортировки. Тип элемента model должен соответствовать типу элемента self.

gtk_sort_list-model-get-model ()

GListModel *
gtk_sort_list_model_get_model (GtkSortListModel *self);

Получает модель, которая сейчас сортируется, или NULL если её нет.

gtk_sort_list_model_set-incremental ()

void
gtk_sort_list_model_set_incremental (GtkSortListModel *self,
                                     gboolean incremental);

Устанавливает сортировку модели для инкрементной сортировки.

При включённой инкрементной сортировке, sortlistmodel не выполняет полную сортировку сразу, а вместо этого помещает в очередь обработчик простоя, который постепенно сортирует элементы к их правильному положению. Это, конечно, означает, что элементы не появятся мгновенно в правильном месте. Это также означает, что общее время сортировки намного медленнее.

Если ваш фильтр блокирует пользовательский интерфейс во время сортировки, вы можете рассмотреть возможность включения этого параметра. В зависимости от вашей модели и сортировщиков, это может стать интересным в районе от 10 000 до 100 000 элементов.

По умолчанию инкрементная сортировка отключена.

См. gtk_sort_list_model_get_pending() для получения информации о ходе операции инкрементной сортировки.

gtk_sort_list_model_get-incremental ()

gboolean
gtk_sort_list_model_get_incremental (GtkSortListModel *self);

Возвращает, была ли включена инкрементная сортировка с помощью gtk_sort_list_model_set_incremental().

gtk_sort_list_model_get_pending ()

guint
gtk_sort_list_model_get_pending (GtkSortListModel *self);

Оценивает ход текущей операции сортировки

Оценка — это количество элементов, которые ещё необходимо отсортировать для завершения операции сортировки, если это линейный алгоритм. Таким образом, это число не связано с тем, сколько элементов уже отсортировано правильно.

Если вам нужно оценить прогресс, вы можете использовать код такого типа:

pending = gtk_sort_list_model_get_pending (self);
model = gtk_sort_list_model_get_model (self);
progress = 1.0 - pending / (double) MAX (1, g_list_model_get_n_items (model));

Если никакая операция сортировки не происходит — в частности, когда “incremental” FALSE — эта функция возвращает 0.

GtkSortListModel

typedef struct _GtkSortListModel GtkSortListModel;

Свойство “incremental”

  “incremental”              gboolean

Если модель должна сортировать элементы инкрементально

Владелец: GtkSortListModel

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “model”

  “model”                    GListModel *

Сортируемая модель

Владелец: GtkSortListModel

Флаги: Чтение / Запись

Свойство “pending”

  “pending”                  guint

Оценка оставшихся не отсортированных элементов

Владелец: GtkSortListModel

Флаги: Чтение

Значение по умолчанию: 0

Свойство “sorter”

  “sorter”                   GtkSorter *

Сортировщик для этой модели

Владелец: GtkSortListModel

Флаги: Чтение / Запись