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 как child_model и root как virtual 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