GtkTreeModelFilter

GtkTreeModelFilterVisibleFunc ()

gboolean
(*GtkTreeModelFilterVisibleFunc) (GtkTreeModel *model,
                                  GtkTreeIter *iter,
                                  gpointer data);

Функция, определяющая, видна ли строка, указанная параметром iter.

GtkTreeModelFilterModifyFunc ()

void
(*GtkTreeModelFilterModifyFunc) (GtkTreeModel *model,
                                 GtkTreeIter *iter,
                                 GValue *value,
                                 gint column,
                                 gpointer data);

Функция, вычисляющая значения отображения из исходных значений в модели. Она должна заполнить value значением отображения для столбца column в строке, указанной параметром iter .

Так как эта функция вызывается для каждого доступа к данным, она не является особенно эффективной операцией.

gtk_tree_model_filter_new ()

GtkTreeModel *
gtk_tree_model_filter_new (GtkTreeModel *child_model,
                           GtkTreePath *root);

Создаёт новую GtkTreeModel, используя child_model в качестве модели-источника и root в качестве виртуального корня.

С: 2.4

gtk_tree_model_filter_set_visible_func ()

void
gtk_tree_model_filter_set_visible_func
                               (GtkTreeModelFilter *filter,
                                GtkTreeModelFilterVisibleFunc func,
                                gpointer data,
                                GDestroyNotify destroy);

Устанавливает функцию видимости, используемую при фильтрации filter, которая должна быть func. Функция должна возвращать TRUE, если данная строка должна быть видимой, и FALSE в противном случае.

Если условие, вычисляемое функцией, изменяется со временем (например, потому что оно зависит от каких-то глобальных параметров), необходимо вызвать gtk_tree_model_filter_refilter() для обновления информации о видимости в модели.

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

static gboolean
visible_func(GtkTreeModel*model,
GtkTreeIter*iter,
gpointer      data)
{
// Visible if row is non-empty and first column is “HI”
gchar*str;
gboolean visible = FALSE;

gtk_tree_model_get(model, iter,0,&str,-1);
if(str &&strcmp(str,"HI")==0)
    visible = TRUE;
g_free(str);

return visible;
}

Обратите внимание, что gtk_tree_model_filter_set_visible_func() или gtk_tree_model_filter_set_visible_column() могут быть вызваны только один раз для данной модели фильтра.

С: 2.4

gtk_tree_model_filter_set_modify_func ()

void
gtk_tree_model_filter_set_modify_func (GtkTreeModelFilter *filter,
                                       gint n_columns,
                                       GType *types,
                                       GtkTreeModelFilterModifyFunc func,
                                       gpointer data,
                                       GDestroyNotify destroy);

С помощью параметров n_columns и types вы предоставляете массив типов столбцов для этой модели (которые будут доступны родительской модели/представлению). Параметры func, data и destroy предназначены для указания функции изменения. Функция изменения будет вызываться для каждого доступа к данным, цель функции изменения — вернуть данные, которые должны отображаться в указанном месте с помощью параметров функции изменения.

Обратите внимание, что gtk_tree_model_filter_set_modify_func() может быть вызвана только один раз для заданной модели фильтра.

С: 2.4

gtk_tree_model_filter_set_visible_column ()

void
gtk_tree_model_filter_set_visible_column
                               (GtkTreeModelFilter *filter,
                                gint column);

Устанавливает column дочерней модели в столбец, где filter должен искать информацию о видимости. columns должен быть столбцом типа G_TYPE_BOOLEAN, где TRUE означает, что строка видима, а FALSE — если нет.

Обратите внимание, что gtk_tree_model_filter_set_visible_func() или gtk_tree_model_filter_set_visible_column() могут быть вызваны только один раз для заданной модели фильтра.

С: 2.4

gtk_tree_model_filter_get_model ()

GtkTreeModel *
gtk_tree_model_filter_get_model (GtkTreeModelFilter *filter);

Возвращает указатель на дочернюю модель filter.

С: 2.4

gtk_tree_model_filter_convert_child_iter_to-iter ()

gboolean
gtk_tree_model_filter_convert_child_iter_to_iter
                               (GtkTreeModelFilter *filter,
                                GtkTreeIter *filter_iter,
                                GtkTreeIter *child_iter);

Устанавливает filter_iter, чтобы указать на строку в filter, которая соответствует строке, на которую указывает child_iter. Если filter_iter не была установлена, возвращается FALSE.

С: 2.4

gtk_tree_model_filter_convert_iter_to-child-iter ()

void
gtk_tree_model_filter_convert_iter_to_child_iter
                               (GtkTreeModelFilter *filter,
                                GtkTreeIter *child_iter,
                                GtkTreeIter *filter_iter);

Устанавливает child_iter, чтобы указать на строку, на которую указывает filter_iter.

С: 2.4

gtk_tree_model_filter_convert_child-path-to-path ()

GtkTreePath *
gtk_tree_model_filter_convert_child_path_to_path
                               (GtkTreeModelFilter *filter,
                                GtkTreePath *child_path);

Преобразует child_path в путь, относительный к filter. То есть child_path указывает на путь в дочерней модели. Возвращаемый путь укажет на ту же строку в отфильтрованной модели. Если child_path не является допустимым путём в дочерней модели или указывает на строку, которая не видна в filter, то возвращается NULL.

С: 2.4

gtk_tree_model_filter_convert_path_to_child_path ()

GtkTreePath *
gtk_tree_model_filter_convert_path_to_child_path
                               (GtkTreeModelFilter *filter,
                                GtkTreePath *filter_path);

Преобразует filter_path в путь на модели дочерних элементов filter. То есть, filter_path указывает на расположение в filter. Возвращаемый путь будет указывать на то же расположение в модели, не подвергающейся фильтрации. Если filter_path не указывает на расположение в модели дочерних элементов, возвращается NULL.

С: 2.4

gtk_tree_model_filter_refilter ()

void
gtk_tree_model_filter_refilter (GtkTreeModelFilter *filter);

Вызывает ::row_changed для каждой строки в модели дочерних элементов, что заставляет фильтр повторно оценивать, видна ли строка или нет.

С: 2.4

gtk_tree_model_filter_clear_cache ()

void
gtk_tree_model_filter_clear_cache (GtkTreeModelFilter *filter);

Функцию следует вызывать крайне редко. Очищает кэш filter любых кэшированных итераторов, которые не были сохранены с помощью gtk_tree_model_ref_node(). Это может быть полезно, если модель дочерних элементов, подвергающихся фильтрации, статична (и не часто меняется), и был значительный несохраненный доступ к узлам. В качестве побочного эффекта этой функции все несохранённые итераторы станут недействительными.

С: 2.4