GtkFilterListModel

gtk_filter_list_model_new ()

GtkFilterListModel *
gtk_filter_list_model_new (GListModel *model,
                           GtkFilter *filter);

Создаёт новый GtkFilterListModel, который будет фильтровать model с помощью указанного filter .

gtk_filter_list_model_set_model ()

void
gtk_filter_list_model_set_model (GtkFilterListModel *self,
                                 GListModel *model);

Устанавливает модель для фильтрации.

GTK не гарантирует, что model соответствует типу элементов self . Предполагается, что вызывающий код знает, что делает, и установил соответствующий фильтр для обеспечения соответствия типов элементов.

gtk_filter_list_model_get_model ()

GListModel *
gtk_filter_list_model_get_model (GtkFilterListModel *self);

Получает текущую отфильтрованную модель или NULL , если её нет.

gtk_filter_list_model_set_filter ()

void
gtk_filter_list_model_set_filter (GtkFilterListModel *self,
                                  GtkFilter *filter);

Устанавливает фильтр для фильтрации элементов.

gtk_filter_list-model-get-filter ()

GtkFilter *
gtk_filter_list_model_get_filter (GtkFilterListModel *self);

Получает GtkFilter, установленный в данный момент на self .

gtk_filter_list-model-set-incremental ()

void
gtk_filter_list_model_set_incremental (GtkFilterListModel *self,
                                       gboolean incremental);

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

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

По умолчанию инкрементальная фильтрация отключена.

См. gtk_filter_list_model_get_pending() для получения информации о прогрессе операции инкрементальной фильтрации.

gtk_filter-list-model-get-incremental ()

gboolean
gtk_filter_list_model_get_incremental (GtkFilterListModel *self);

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

gtk_filter-list-model-get-pending ()

guint
gtk_filter_list_model_get_pending (GtkFilterListModel *self);

Возвращает количество элементов, которые ещё не отфильтрованы.

Вы можете использовать это значение, чтобы проверить, занят ли self фильтрацией, сравнив возвращаемое значение с 0, или вычислить процент оставшегося фильтра, разделив возвращаемое значение на общее количество элементов в основной модели:

pending = gtk_filter_list_model_get_pending (self);
model = gtk_filter_list_model_get_model (self);
percentage = pending / (double) g_list_model_get_n_items (model);

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

GtkFilterListModel

typedef struct _GtkFilterListModel GtkFilterListModel;

Свойство “filter”

  “filter”                   GtkFilter *

Фильтр для данной модели

Владелец: GtkFilterListModel

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

Свойство “incremental”

  “incremental”              gboolean

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

Владелец: GtkFilterListModel

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

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

Свойство “model”

  “model”                    GListModel *

Модель, которая фильтруется

Владелец: GtkFilterListModel

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

Свойство “pending”

  “pending”                  guint

Количество элементов, которые ещё не отфильтрованы

Владелец: GtkFilterListModel

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

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