1 /* gtktreemodelfilter.c
2 * Copyright (C) 2000,2001 Red Hat, Inc., Jonathan Blandford <jrb@redhat.com>
3 * Copyright (C) 2001-2003 Kristian Rietveld <kris@gtk.org>
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Library General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Library General Public License for more details.
15 * You should have received a copy of the GNU Library General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 * Boston, MA 02111-1307, USA.
22 #include "gtktreemodelfilter.h"
24 #include "gtktreednd.h"
26 #include "gtkprivate.h"
31 * iter->stamp = filter->priv->stamp
32 * iter->user_data = FilterLevel
33 * iter->user_data2 = FilterElt
36 /* all paths, iters, etc prefixed with c_ are paths, iters, etc relative to the
41 * There are three model/views involved, so there are two mappings:
42 * * this model -> child model: mapped via offset in FilterElt.
43 * * this model -> parent model (or view): mapped via the array index
46 * Note that there are two kinds of paths relative to the filter model
47 * (those generated from the array indices): paths taking non-visible
48 * nodes into account, and paths which don't. Paths which take
49 * non-visible nodes into account should only be used internally and
50 * NEVER be passed along with a signal emission.
52 * The filter model has a reference on every node that is not in the root
53 * level and has a parent with ref_count > 1. Exception is a virtual root
54 * level; all nodes in the virtual root level are referenced too.
57 typedef struct _FilterElt FilterElt;
58 typedef struct _FilterLevel FilterLevel;
63 FilterLevel *children;
76 FilterElt *parent_elt;
77 FilterLevel *parent_level;
80 #define GTK_TREE_MODEL_FILTER_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TREE_MODEL_FILTER, GtkTreeModelFilterPrivate))
82 struct _GtkTreeModelFilterPrivate
87 GtkTreeModel *child_model;
90 GtkTreePath *virtual_root;
92 GtkTreeModelFilterVisibleFunc visible_func;
93 gpointer visible_data;
94 GtkDestroyNotify visible_destroy;
96 gint modify_n_columns;
98 GtkTreeModelFilterModifyFunc modify_func;
100 gpointer modify_destroy;
104 gboolean visible_method_set;
105 gboolean modify_func_set;
107 gboolean in_row_deleted;
112 guint has_child_toggled_id;
125 #define GTK_TREE_MODEL_FILTER_CACHE_CHILD_ITERS(filter) \
126 (((GtkTreeModelFilter *)filter)->priv->child_flags & GTK_TREE_MODEL_ITERS_PERSIST)
128 #define FILTER_ELT(filter_elt) ((FilterElt *)filter_elt)
129 #define FILTER_LEVEL(filter_level) ((FilterLevel *)filter_level)
131 /* general code (object/interface init, properties, etc) */
132 static void gtk_tree_model_filter_init (GtkTreeModelFilter *filter);
133 static void gtk_tree_model_filter_class_init (GtkTreeModelFilterClass *filter_class);
134 static void gtk_tree_model_filter_tree_model_init (GtkTreeModelIface *iface);
135 static void gtk_tree_model_filter_drag_source_init (GtkTreeDragSourceIface *iface);
136 static void gtk_tree_model_filter_finalize (GObject *object);
137 static void gtk_tree_model_filter_set_property (GObject *object,
141 static void gtk_tree_model_filter_get_property (GObject *object,
146 /* signal handlers */
147 static void gtk_tree_model_filter_row_changed (GtkTreeModel *c_model,
151 static void gtk_tree_model_filter_row_inserted (GtkTreeModel *c_model,
155 static void gtk_tree_model_filter_row_has_child_toggled (GtkTreeModel *c_model,
159 static void gtk_tree_model_filter_row_deleted (GtkTreeModel *c_model,
162 static void gtk_tree_model_filter_rows_reordered (GtkTreeModel *c_model,
168 /* GtkTreeModel interface */
169 static GtkTreeModelFlags gtk_tree_model_filter_get_flags (GtkTreeModel *model);
170 static gint gtk_tree_model_filter_get_n_columns (GtkTreeModel *model);
171 static GType gtk_tree_model_filter_get_column_type (GtkTreeModel *model,
173 static gboolean gtk_tree_model_filter_get_iter_full (GtkTreeModel *model,
176 static gboolean gtk_tree_model_filter_get_iter (GtkTreeModel *model,
179 static GtkTreePath *gtk_tree_model_filter_get_path (GtkTreeModel *model,
181 static void gtk_tree_model_filter_get_value (GtkTreeModel *model,
185 static gboolean gtk_tree_model_filter_iter_next (GtkTreeModel *model,
187 static gboolean gtk_tree_model_filter_iter_children (GtkTreeModel *model,
189 GtkTreeIter *parent);
190 static gboolean gtk_tree_model_filter_iter_has_child (GtkTreeModel *model,
192 static gint gtk_tree_model_filter_iter_n_children (GtkTreeModel *model,
194 static gboolean gtk_tree_model_filter_iter_nth_child (GtkTreeModel *model,
198 static gboolean gtk_tree_model_filter_iter_parent (GtkTreeModel *model,
201 static void gtk_tree_model_filter_ref_node (GtkTreeModel *model,
203 static void gtk_tree_model_filter_unref_node (GtkTreeModel *model,
206 /* TreeDragSource interface */
207 static gboolean gtk_tree_model_filter_row_draggable (GtkTreeDragSource *drag_source,
209 static gboolean gtk_tree_model_filter_drag_data_get (GtkTreeDragSource *drag_source,
211 GtkSelectionData *selection_data);
212 static gboolean gtk_tree_model_filter_drag_data_delete (GtkTreeDragSource *drag_source,
215 /* private functions */
216 static void gtk_tree_model_filter_build_level (GtkTreeModelFilter *filter,
217 FilterLevel *parent_level,
218 FilterElt *parent_elt,
219 gboolean emit_inserted);
221 static void gtk_tree_model_filter_free_level (GtkTreeModelFilter *filter,
222 FilterLevel *filter_level);
224 static GtkTreePath *gtk_tree_model_filter_elt_get_path (FilterLevel *level,
228 static GtkTreePath *gtk_tree_model_filter_add_root (GtkTreePath *src,
230 static GtkTreePath *gtk_tree_model_filter_remove_root (GtkTreePath *src,
233 static void gtk_tree_model_filter_increment_stamp (GtkTreeModelFilter *filter);
235 static gboolean gtk_tree_model_filter_visible (GtkTreeModelFilter *filter,
236 GtkTreeIter *child_iter);
237 static void gtk_tree_model_filter_clear_cache_helper (GtkTreeModelFilter *filter,
240 static void gtk_tree_model_filter_real_unref_node (GtkTreeModel *model,
242 gboolean propagate_unref);
244 static void gtk_tree_model_filter_set_model (GtkTreeModelFilter *filter,
245 GtkTreeModel *child_model);
246 static void gtk_tree_model_filter_ref_path (GtkTreeModelFilter *filter,
248 static void gtk_tree_model_filter_unref_path (GtkTreeModelFilter *filter,
250 static void gtk_tree_model_filter_set_root (GtkTreeModelFilter *filter,
253 static GtkTreePath *gtk_real_tree_model_filter_convert_child_path_to_path (GtkTreeModelFilter *filter,
254 GtkTreePath *child_path,
255 gboolean build_levels,
256 gboolean fetch_children);
258 static FilterElt *gtk_tree_model_filter_get_nth (GtkTreeModelFilter *filter,
261 static FilterElt *gtk_tree_model_filter_get_nth_visible (GtkTreeModelFilter *filter,
265 static FilterElt *gtk_tree_model_filter_fetch_child (GtkTreeModelFilter *filter,
269 static void gtk_tree_model_filter_remove_node (GtkTreeModelFilter *filter,
271 static void gtk_tree_model_filter_update_children (GtkTreeModelFilter *filter,
274 static FilterElt *bsearch_elt_with_offset (GArray *array,
279 static GObjectClass *parent_class = NULL;
282 gtk_tree_model_filter_get_type (void)
284 static GType tree_model_filter_type = 0;
286 if (!tree_model_filter_type)
288 static const GTypeInfo tree_model_filter_info =
290 sizeof (GtkTreeModelFilterClass),
291 NULL, /* base_init */
292 NULL, /* base_finalize */
293 (GClassInitFunc) gtk_tree_model_filter_class_init,
294 NULL, /* class_finalize */
295 NULL, /* class_data */
296 sizeof (GtkTreeModelFilter),
298 (GInstanceInitFunc) gtk_tree_model_filter_init
301 static const GInterfaceInfo tree_model_info =
303 (GInterfaceInitFunc) gtk_tree_model_filter_tree_model_init,
308 static const GInterfaceInfo drag_source_info =
310 (GInterfaceInitFunc) gtk_tree_model_filter_drag_source_init,
315 tree_model_filter_type = g_type_register_static (G_TYPE_OBJECT,
316 I_("GtkTreeModelFilter"),
317 &tree_model_filter_info, 0);
319 g_type_add_interface_static (tree_model_filter_type,
323 g_type_add_interface_static (tree_model_filter_type,
324 GTK_TYPE_TREE_DRAG_SOURCE,
328 return tree_model_filter_type;
332 gtk_tree_model_filter_init (GtkTreeModelFilter *filter)
334 filter->priv = GTK_TREE_MODEL_FILTER_GET_PRIVATE (filter);
336 filter->priv->visible_column = -1;
337 filter->priv->zero_ref_count = 0;
338 filter->priv->visible_method_set = FALSE;
339 filter->priv->modify_func_set = FALSE;
340 filter->priv->in_row_deleted = FALSE;
344 gtk_tree_model_filter_class_init (GtkTreeModelFilterClass *filter_class)
346 GObjectClass *object_class;
348 object_class = (GObjectClass *) filter_class;
349 parent_class = g_type_class_peek_parent (filter_class);
351 object_class->set_property = gtk_tree_model_filter_set_property;
352 object_class->get_property = gtk_tree_model_filter_get_property;
354 object_class->finalize = gtk_tree_model_filter_finalize;
356 /* Properties -- FIXME: disabled translations for now, until I can come up with a
359 g_object_class_install_property (object_class,
361 g_param_spec_object ("child-model",
363 ("The model for the filtermodel to filter"),
365 GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY));
367 g_object_class_install_property (object_class,
369 g_param_spec_boxed ("virtual-root",
370 ("The virtual root"),
371 ("The virtual root (relative to the child model) for this filtermodel"),
373 GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY));
375 g_type_class_add_private (object_class, sizeof (GtkTreeModelFilterPrivate));
379 gtk_tree_model_filter_tree_model_init (GtkTreeModelIface *iface)
381 iface->get_flags = gtk_tree_model_filter_get_flags;
382 iface->get_n_columns = gtk_tree_model_filter_get_n_columns;
383 iface->get_column_type = gtk_tree_model_filter_get_column_type;
384 iface->get_iter = gtk_tree_model_filter_get_iter;
385 iface->get_path = gtk_tree_model_filter_get_path;
386 iface->get_value = gtk_tree_model_filter_get_value;
387 iface->iter_next = gtk_tree_model_filter_iter_next;
388 iface->iter_children = gtk_tree_model_filter_iter_children;
389 iface->iter_has_child = gtk_tree_model_filter_iter_has_child;
390 iface->iter_n_children = gtk_tree_model_filter_iter_n_children;
391 iface->iter_nth_child = gtk_tree_model_filter_iter_nth_child;
392 iface->iter_parent = gtk_tree_model_filter_iter_parent;
393 iface->ref_node = gtk_tree_model_filter_ref_node;
394 iface->unref_node = gtk_tree_model_filter_unref_node;
398 gtk_tree_model_filter_drag_source_init (GtkTreeDragSourceIface *iface)
400 iface->row_draggable = gtk_tree_model_filter_row_draggable;
401 iface->drag_data_delete = gtk_tree_model_filter_drag_data_delete;
402 iface->drag_data_get = gtk_tree_model_filter_drag_data_get;
407 gtk_tree_model_filter_finalize (GObject *object)
409 GtkTreeModelFilter *filter = (GtkTreeModelFilter *) object;
411 if (filter->priv->virtual_root)
412 gtk_tree_model_filter_unref_path (filter, filter->priv->virtual_root);
414 gtk_tree_model_filter_set_model (filter, NULL);
416 if (filter->priv->virtual_root)
417 gtk_tree_path_free (filter->priv->virtual_root);
419 if (filter->priv->root)
420 gtk_tree_model_filter_free_level (filter, filter->priv->root);
422 if (filter->priv->modify_types)
423 g_free (filter->priv->modify_types);
426 parent_class->finalize (object);
430 gtk_tree_model_filter_set_property (GObject *object,
435 GtkTreeModelFilter *filter = GTK_TREE_MODEL_FILTER (object);
439 case PROP_CHILD_MODEL:
440 gtk_tree_model_filter_set_model (filter, g_value_get_object (value));
442 case PROP_VIRTUAL_ROOT:
443 gtk_tree_model_filter_set_root (filter, g_value_get_boxed (value));
446 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
452 gtk_tree_model_filter_get_property (GObject *object,
457 GtkTreeModelFilter *filter = GTK_TREE_MODEL_FILTER (object);
461 case PROP_CHILD_MODEL:
462 g_value_set_object (value, filter->priv->child_model);
464 case PROP_VIRTUAL_ROOT:
465 g_value_set_boxed (value, filter->priv->virtual_root);
468 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
476 gtk_tree_model_filter_build_level (GtkTreeModelFilter *filter,
477 FilterLevel *parent_level,
478 FilterElt *parent_elt,
479 gboolean emit_inserted)
482 GtkTreeIter first_node;
484 FilterLevel *new_level;
488 g_assert (filter->priv->child_model != NULL);
490 if (filter->priv->in_row_deleted)
495 if (filter->priv->virtual_root)
497 if (gtk_tree_model_get_iter (filter->priv->child_model, &root, filter->priv->virtual_root) == FALSE)
499 length = gtk_tree_model_iter_n_children (filter->priv->child_model, &root);
501 if (gtk_tree_model_iter_children (filter->priv->child_model, &iter, &root) == FALSE)
506 if (!gtk_tree_model_get_iter_first (filter->priv->child_model, &iter))
508 length = gtk_tree_model_iter_n_children (filter->priv->child_model, NULL);
513 GtkTreeIter parent_iter;
514 GtkTreeIter child_parent_iter;
516 parent_iter.stamp = filter->priv->stamp;
517 parent_iter.user_data = parent_level;
518 parent_iter.user_data2 = parent_elt;
520 gtk_tree_model_filter_convert_iter_to_child_iter (filter,
523 if (gtk_tree_model_iter_children (filter->priv->child_model, &iter, &child_parent_iter) == FALSE)
526 /* stamp may have changed */
527 gtk_tree_model_filter_convert_iter_to_child_iter (filter,
530 length = gtk_tree_model_iter_n_children (filter->priv->child_model, &child_parent_iter);
533 g_return_if_fail (length > 0);
535 new_level = g_new (FilterLevel, 1);
536 new_level->array = g_array_sized_new (FALSE, FALSE,
539 new_level->ref_count = 0;
540 new_level->visible_nodes = 0;
541 new_level->parent_elt = parent_elt;
542 new_level->parent_level = parent_level;
545 parent_elt->children = new_level;
547 filter->priv->root = new_level;
549 /* increase the count of zero ref_counts */
552 parent_elt->zero_ref_count++;
554 parent_elt = parent_level->parent_elt;
555 parent_level = parent_level->parent_level;
557 if (new_level != filter->priv->root)
558 filter->priv->zero_ref_count++;
566 if (gtk_tree_model_filter_visible (filter, &iter))
568 FilterElt filter_elt;
570 filter_elt.offset = i;
571 filter_elt.zero_ref_count = 0;
572 filter_elt.ref_count = 0;
573 filter_elt.children = NULL;
574 filter_elt.visible = TRUE;
576 if (GTK_TREE_MODEL_FILTER_CACHE_CHILD_ITERS (filter))
577 filter_elt.iter = iter;
579 g_array_append_val (new_level->array, filter_elt);
580 new_level->visible_nodes++;
582 if (new_level->parent_level || filter->priv->virtual_root)
586 f_iter.stamp = filter->priv->stamp;
587 f_iter.user_data = new_level;
588 f_iter.user_data2 = &(g_array_index (new_level->array, FilterElt, new_level->array->len - 1));
590 gtk_tree_model_filter_ref_node (GTK_TREE_MODEL (filter), &f_iter);
596 f_path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter),
598 gtk_tree_model_row_inserted (GTK_TREE_MODEL (filter),
600 gtk_tree_path_free (f_path);
606 while (gtk_tree_model_iter_next (filter->priv->child_model, &iter));
608 if (new_level->array->len == 0
609 && (new_level != filter->priv->root || filter->priv->virtual_root))
611 /* If none of the nodes are visible, we will just pull in the
612 * first node of the level and keep a reference on it. We need this
613 * to make sure that we get all signals for this level.
615 FilterElt filter_elt;
617 filter_elt.offset = 0;
618 filter_elt.zero_ref_count = 0;
619 filter_elt.ref_count = 0;
620 filter_elt.children = NULL;
621 filter_elt.visible = FALSE;
623 if (GTK_TREE_MODEL_FILTER_CACHE_CHILD_ITERS (filter))
624 filter_elt.iter = first_node;
626 g_array_append_val (new_level->array, filter_elt);
630 f_iter.stamp = filter->priv->stamp;
631 f_iter.user_data = new_level;
632 f_iter.user_data2 = &(g_array_index (new_level->array, FilterElt, new_level->array->len - 1));
634 gtk_tree_model_filter_ref_node (GTK_TREE_MODEL (filter), &f_iter);
636 else if (new_level->array->len == 0)
637 gtk_tree_model_filter_free_level (filter, new_level);
641 gtk_tree_model_filter_free_level (GtkTreeModelFilter *filter,
642 FilterLevel *filter_level)
646 g_assert (filter_level);
648 for (i = 0; i < filter_level->array->len; i++)
650 if (g_array_index (filter_level->array, FilterElt, i).children)
651 gtk_tree_model_filter_free_level (filter,
652 FILTER_LEVEL (g_array_index (filter_level->array, FilterElt, i).children));
654 if (filter_level->parent_level || filter->priv->virtual_root)
658 f_iter.stamp = filter->priv->stamp;
659 f_iter.user_data = filter_level;
660 f_iter.user_data2 = &(g_array_index (filter_level->array, FilterElt, i));
662 gtk_tree_model_filter_unref_node (GTK_TREE_MODEL (filter), &f_iter);
666 if (filter_level->ref_count == 0)
668 FilterLevel *parent_level = filter_level->parent_level;
669 FilterElt *parent_elt = filter_level->parent_elt;
674 parent_elt->zero_ref_count--;
678 parent_elt = parent_level->parent_elt;
679 parent_level = parent_level->parent_level;
682 while (parent_level);
683 if (filter_level != filter->priv->root)
684 filter->priv->zero_ref_count--;
687 if (filter_level->parent_elt)
688 filter_level->parent_elt->children = NULL;
690 filter->priv->root = NULL;
692 g_array_free (filter_level->array, TRUE);
693 filter_level->array = NULL;
695 g_free (filter_level);
699 /* Creates paths suitable for accessing the child model. */
701 gtk_tree_model_filter_elt_get_path (FilterLevel *level,
705 FilterLevel *walker = level;
706 FilterElt *walker2 = elt;
708 GtkTreePath *real_path;
710 g_return_val_if_fail (level != NULL, NULL);
711 g_return_val_if_fail (elt != NULL, NULL);
713 path = gtk_tree_path_new ();
717 gtk_tree_path_prepend_index (path, walker2->offset);
719 walker2 = walker->parent_elt;
720 walker = walker->parent_level;
725 real_path = gtk_tree_model_filter_add_root (path, root);
726 gtk_tree_path_free (path);
734 gtk_tree_model_filter_add_root (GtkTreePath *src,
740 retval = gtk_tree_path_copy (root);
742 for (i = 0; i < gtk_tree_path_get_depth (src); i++)
743 gtk_tree_path_append_index (retval, gtk_tree_path_get_indices (src)[i]);
749 gtk_tree_model_filter_remove_root (GtkTreePath *src,
757 if (gtk_tree_path_get_depth (src) <= gtk_tree_path_get_depth (root))
760 depth = gtk_tree_path_get_depth (src);
761 indices = gtk_tree_path_get_indices (src);
763 for (i = 0; i < gtk_tree_path_get_depth (root); i++)
764 if (indices[i] != gtk_tree_path_get_indices (root)[i])
767 retval = gtk_tree_path_new ();
769 for (; i < depth; i++)
770 gtk_tree_path_append_index (retval, indices[i]);
776 gtk_tree_model_filter_increment_stamp (GtkTreeModelFilter *filter)
780 filter->priv->stamp++;
782 while (filter->priv->stamp == 0);
784 gtk_tree_model_filter_clear_cache (filter);
788 gtk_tree_model_filter_visible (GtkTreeModelFilter *filter,
789 GtkTreeIter *child_iter)
791 if (filter->priv->visible_func)
793 return filter->priv->visible_func (filter->priv->child_model,
795 filter->priv->visible_data)
798 else if (filter->priv->visible_column >= 0)
802 gtk_tree_model_get_value (filter->priv->child_model, child_iter,
803 filter->priv->visible_column, &val);
805 if (g_value_get_boolean (&val))
807 g_value_unset (&val);
811 g_value_unset (&val);
815 /* no visible function set, so always visible */
820 gtk_tree_model_filter_clear_cache_helper (GtkTreeModelFilter *filter,
827 for (i = 0; i < level->array->len; i++)
829 if (g_array_index (level->array, FilterElt, i).zero_ref_count > 0)
830 gtk_tree_model_filter_clear_cache_helper (filter, g_array_index (level->array, FilterElt, i).children);
833 if (level->ref_count == 0 && level != filter->priv->root)
835 gtk_tree_model_filter_free_level (filter, level);
841 gtk_tree_model_filter_get_nth (GtkTreeModelFilter *filter,
845 if (level->array->len <= n)
848 return &g_array_index (level->array, FilterElt, n);
852 gtk_tree_model_filter_get_nth_visible (GtkTreeModelFilter *filter,
859 if (level->visible_nodes <= n)
862 elt = FILTER_ELT (level->array->data);
863 while (!elt->visible)
873 while (!elt->visible)
880 gtk_tree_model_filter_fetch_child (GtkTreeModelFilter *filter,
886 gint start, middle, end;
888 GtkTreePath *c_path = NULL;
890 GtkTreePath *c_parent_path = NULL;
891 GtkTreeIter c_parent_iter;
894 /* check if child exists and is visible */
895 if (level->parent_elt)
898 gtk_tree_model_filter_elt_get_path (level->parent_level,
900 filter->priv->virtual_root);
906 if (filter->priv->virtual_root)
907 c_parent_path = gtk_tree_path_copy (filter->priv->virtual_root);
909 c_parent_path = NULL;
914 gtk_tree_model_get_iter (filter->priv->child_model,
917 len = gtk_tree_model_iter_n_children (filter->priv->child_model,
920 c_path = gtk_tree_path_copy (c_parent_path);
921 gtk_tree_path_free (c_parent_path);
925 len = gtk_tree_model_iter_n_children (filter->priv->child_model, NULL);
926 c_path = gtk_tree_path_new ();
929 gtk_tree_path_append_index (c_path, offset);
930 gtk_tree_model_get_iter (filter->priv->child_model, &c_iter, c_path);
931 gtk_tree_path_free (c_path);
933 if (offset >= len || !gtk_tree_model_filter_visible (filter, &c_iter))
938 elt.zero_ref_count = 0;
941 /* visibility should be FALSE as we don't emit row_inserted */
944 if (GTK_TREE_MODEL_FILTER_CACHE_CHILD_ITERS (filter))
947 /* find index (binary search on offset) */
949 end = level->array->len;
955 middle = (start + end) / 2;
957 if (g_array_index (level->array, FilterElt, middle).offset <= offset)
963 if (g_array_index (level->array, FilterElt, middle).offset <= offset)
971 g_array_insert_val (level->array, i, elt);
977 for ( ; i < level->array->len; i++)
979 FilterElt *e = &(g_array_index (level->array, FilterElt, i));
981 e->children->parent_elt = e;
984 c_iter.stamp = filter->priv->stamp;
985 c_iter.user_data = level;
986 c_iter.user_data2 = &g_array_index (level->array, FilterElt, *index);
988 if (level->parent_level || filter->priv->virtual_root)
989 gtk_tree_model_filter_ref_node (GTK_TREE_MODEL (filter), &c_iter);
991 return &g_array_index (level->array, FilterElt, *index);
995 gtk_tree_model_filter_remove_node (GtkTreeModelFilter *filter,
998 FilterElt *elt, *parent;
999 FilterLevel *level, *parent_level;
1000 gint offset, i, length;
1002 gboolean emit_child_toggled = FALSE;
1004 level = FILTER_LEVEL (iter->user_data);
1005 elt = FILTER_ELT (iter->user_data2);
1007 parent = level->parent_elt;
1008 parent_level = level->parent_level;
1010 length = level->array->len;
1011 offset = elt->offset;
1013 /* we distinguish a couple of cases:
1014 * - root level, length > 1: emit row-deleted and remove.
1015 * - root level, length == 1: emit row-deleted and keep in cache.
1016 * - level, length == 1: parent->ref_count > 1: emit row-deleted and keep.
1017 * - level, length > 1: emit row-deleted and remove.
1018 * - else, remove level.
1020 * if level != root level and visible nodes == 0, emit row-has-child-toggled.
1023 if (level != filter->priv->root && level->visible_nodes == 0)
1024 emit_child_toggled = TRUE;
1031 /* we emit row-deleted, and remove the node from the cache.
1034 path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter), iter);
1035 elt->visible = FALSE;
1036 gtk_tree_model_filter_increment_stamp (filter);
1037 iter->stamp = filter->priv->stamp;
1038 gtk_tree_model_row_deleted (GTK_TREE_MODEL (filter), path);
1039 gtk_tree_path_free (path);
1041 while (elt->ref_count > 1)
1042 gtk_tree_model_filter_real_unref_node (GTK_TREE_MODEL (filter),
1045 if (parent_level || filter->priv->virtual_root)
1046 gtk_tree_model_filter_unref_node (GTK_TREE_MODEL (filter), iter);
1048 gtk_tree_model_filter_real_unref_node (GTK_TREE_MODEL (filter),
1051 /* remove the node */
1052 tmp = bsearch_elt_with_offset (level->array, elt->offset, &i);
1056 g_array_remove_index (level->array, i);
1059 for (i = MAX (i, 0); i < level->array->len; i++)
1061 /* NOTE: here we do *not* decrease offsets, because the node was
1062 * not removed from the child model
1064 elt = &g_array_index (level->array, FilterElt, i);
1066 elt->children->parent_elt = elt;
1070 else if ((length == 1 && parent && parent->ref_count > 1)
1071 || (length == 1 && level == filter->priv->root))
1075 /* we emit row-deleted, but keep the node in the cache and
1079 path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter), iter);
1080 elt->visible = FALSE;
1081 gtk_tree_model_filter_increment_stamp (filter);
1082 gtk_tree_model_row_deleted (GTK_TREE_MODEL (filter), path);
1083 gtk_tree_path_free (path);
1089 /* blow level away */
1091 path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter), iter);
1092 elt->visible = FALSE;
1093 gtk_tree_model_filter_increment_stamp (filter);
1094 iter->stamp = filter->priv->stamp;
1095 gtk_tree_model_row_deleted (GTK_TREE_MODEL (filter), path);
1096 gtk_tree_path_free (path);
1098 while (elt->ref_count > 1)
1099 gtk_tree_model_filter_real_unref_node (GTK_TREE_MODEL (filter),
1102 gtk_tree_model_filter_free_level (filter, level);
1105 if (emit_child_toggled)
1110 piter.stamp = filter->priv->stamp;
1111 piter.user_data = parent_level;
1112 piter.user_data2 = parent;
1114 ppath = gtk_tree_model_get_path (GTK_TREE_MODEL (filter), &piter);
1116 gtk_tree_model_row_has_child_toggled (GTK_TREE_MODEL (filter),
1118 gtk_tree_path_free (ppath);
1123 gtk_tree_model_filter_update_children (GtkTreeModelFilter *filter,
1133 iter.stamp = filter->priv->stamp;
1134 iter.user_data = level;
1135 iter.user_data2 = elt;
1137 gtk_tree_model_filter_convert_iter_to_child_iter (filter, &c_iter, &iter);
1139 if (gtk_tree_model_iter_has_child (filter->priv->child_model, &c_iter))
1141 GtkTreePath *path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter),
1143 gtk_tree_model_row_has_child_toggled (GTK_TREE_MODEL (filter),
1147 gtk_tree_path_free (path);
1152 bsearch_elt_with_offset (GArray *array,
1156 gint start, middle, end;
1167 elt = &g_array_index (array, FilterElt, 0);
1169 if (elt->offset == offset)
1180 middle = (start + end) / 2;
1182 elt = &g_array_index (array, FilterElt, middle);
1184 if (elt->offset < offset)
1186 else if (elt->offset > offset)
1191 while (start != end);
1193 if (elt->offset == offset)
1202 /* TreeModel signals */
1204 gtk_tree_model_filter_row_changed (GtkTreeModel *c_model,
1205 GtkTreePath *c_path,
1206 GtkTreeIter *c_iter,
1209 GtkTreeModelFilter *filter = GTK_TREE_MODEL_FILTER (data);
1211 GtkTreeIter children;
1212 GtkTreeIter real_c_iter;
1213 GtkTreePath *path = NULL;
1218 gboolean requested_state;
1219 gboolean current_state;
1220 gboolean free_c_path = FALSE;
1222 g_return_if_fail (c_path != NULL || c_iter != NULL);
1226 c_path = gtk_tree_model_get_path (c_model, c_iter);
1231 real_c_iter = *c_iter;
1233 gtk_tree_model_get_iter (c_model, &real_c_iter, c_path);
1235 /* is this node above the virtual root? */
1236 if (filter->priv->virtual_root
1237 && (gtk_tree_path_get_depth (filter->priv->virtual_root)
1238 >= gtk_tree_path_get_depth (c_path)))
1241 /* what's the requested state? */
1242 requested_state = gtk_tree_model_filter_visible (filter, &real_c_iter);
1244 /* now, let's see whether the item is there */
1245 path = gtk_real_tree_model_filter_convert_child_path_to_path (filter,
1252 gtk_tree_model_filter_get_iter_full (GTK_TREE_MODEL (filter),
1254 current_state = FILTER_ELT (iter.user_data2)->visible;
1257 current_state = FALSE;
1259 if (current_state == FALSE && requested_state == FALSE)
1260 /* no changes required */
1263 if (current_state == TRUE && requested_state == FALSE)
1265 /* get rid of this node */
1266 level = FILTER_LEVEL (iter.user_data);
1267 level->visible_nodes--;
1269 gtk_tree_model_filter_remove_node (filter, &iter);
1274 if (current_state == TRUE && requested_state == TRUE)
1276 /* propagate the signal; also get a path taking only visible
1277 * nodes into account.
1279 gtk_tree_path_free (path);
1280 path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter), &iter);
1281 gtk_tree_model_row_changed (GTK_TREE_MODEL (filter), path, &iter);
1283 level = FILTER_LEVEL (iter.user_data);
1284 elt = FILTER_ELT (iter.user_data2);
1286 /* and update the children */
1287 if (gtk_tree_model_iter_children (c_model, &children, &real_c_iter))
1288 gtk_tree_model_filter_update_children (filter, level, elt);
1293 /* only current == FALSE and requested == TRUE is left,
1296 g_return_if_fail (current_state == FALSE && requested_state == TRUE);
1298 /* make sure the new item has been pulled in */
1299 if (!filter->priv->root)
1304 gtk_tree_model_filter_build_level (filter, NULL, NULL, FALSE);
1306 root = FILTER_LEVEL (filter->priv->root);
1310 for (i = 0; i < root->array->len; i++)
1311 g_array_index (root->array, FilterElt, i).visible = FALSE;
1312 root->visible_nodes = 0;
1316 gtk_tree_model_filter_increment_stamp (filter);
1319 path = gtk_real_tree_model_filter_convert_child_path_to_path (filter,
1325 /* parent is probably being filtered out */
1328 gtk_tree_model_filter_get_iter_full (GTK_TREE_MODEL (filter), &iter, path);
1330 level = FILTER_LEVEL (iter.user_data);
1331 elt = FILTER_ELT (iter.user_data2);
1333 /* elt->visible can be TRUE at this point if it was pulled in above */
1336 elt->visible = TRUE;
1337 level->visible_nodes++;
1340 if ((level->parent_elt && level->parent_elt->visible) || !level->parent_elt)
1342 /* visibility changed -- reget path */
1343 gtk_tree_path_free (path);
1344 path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter), &iter);
1346 gtk_tree_model_row_inserted (GTK_TREE_MODEL (filter), path, &iter);
1348 if (gtk_tree_model_iter_children (c_model, &children, c_iter))
1349 gtk_tree_model_filter_update_children (filter, level, elt);
1354 gtk_tree_path_free (path);
1357 gtk_tree_path_free (c_path);
1361 gtk_tree_model_filter_row_inserted (GtkTreeModel *c_model,
1362 GtkTreePath *c_path,
1363 GtkTreeIter *c_iter,
1366 GtkTreeModelFilter *filter = GTK_TREE_MODEL_FILTER (data);
1367 GtkTreePath *path = NULL;
1368 GtkTreePath *real_path = NULL;
1371 GtkTreeIter real_c_iter;
1375 FilterLevel *parent_level;
1379 gboolean free_c_path = FALSE;
1381 g_return_if_fail (c_path != NULL || c_iter != NULL);
1385 c_path = gtk_tree_model_get_path (c_model, c_iter);
1390 real_c_iter = *c_iter;
1392 gtk_tree_model_get_iter (c_model, &real_c_iter, c_path);
1394 /* the row has already been inserted. so we need to fixup the
1395 * virtual root here first
1397 if (filter->priv->virtual_root)
1399 if (gtk_tree_path_get_depth (filter->priv->virtual_root) >=
1400 gtk_tree_path_get_depth (c_path))
1403 gint *v_indices, *c_indices;
1404 gboolean common_prefix = TRUE;
1406 level = gtk_tree_path_get_depth (c_path) - 1;
1407 v_indices = gtk_tree_path_get_indices (filter->priv->virtual_root);
1408 c_indices = gtk_tree_path_get_indices (c_path);
1410 for (i = 0; i < level; i++)
1411 if (v_indices[i] != c_indices[i])
1413 common_prefix = FALSE;
1417 if (common_prefix && v_indices[level] >= c_indices[level])
1418 (v_indices[level])++;
1422 if (!filter->priv->root)
1424 /* build level will pull in the new child */
1425 gtk_tree_model_filter_build_level (filter, NULL, NULL, FALSE);
1427 if (filter->priv->root
1428 && FILTER_LEVEL (filter->priv->root)->visible_nodes)
1434 parent_level = level = FILTER_LEVEL (filter->priv->root);
1436 /* subtract virtual root if necessary */
1437 if (filter->priv->virtual_root)
1439 real_path = gtk_tree_model_filter_remove_root (c_path,
1440 filter->priv->virtual_root);
1446 real_path = gtk_tree_path_copy (c_path);
1448 if (gtk_tree_path_get_depth (real_path) - 1 >= 1)
1450 /* find the parent level */
1451 while (i < gtk_tree_path_get_depth (real_path) - 1)
1456 /* we don't cover this signal */
1459 elt = bsearch_elt_with_offset (level->array,
1460 gtk_tree_path_get_indices (real_path)[i],
1464 /* parent is probably being filtered out */
1469 GtkTreePath *tmppath;
1470 GtkTreeIter tmpiter;
1472 tmpiter.stamp = filter->priv->stamp;
1473 tmpiter.user_data = level;
1474 tmpiter.user_data2 = elt;
1476 tmppath = gtk_tree_model_get_path (GTK_TREE_MODEL (data),
1481 gtk_tree_model_row_has_child_toggled (GTK_TREE_MODEL (data),
1483 gtk_tree_path_free (tmppath);
1486 /* not covering this signal */
1490 level = elt->children;
1491 parent_level = level;
1499 /* let's try to insert the value */
1500 offset = gtk_tree_path_get_indices (real_path)[gtk_tree_path_get_depth (real_path) - 1];
1502 /* update the offsets, yes if we didn't insert the node above, there will
1503 * be a gap here. This will be filled with the node (via fetch_child) when
1504 * it becomes visible
1506 for (i = 0; i < level->array->len; i++)
1508 FilterElt *e = &g_array_index (level->array, FilterElt, i);
1509 if ((e->offset >= offset))
1513 /* only insert when visible */
1514 if (gtk_tree_model_filter_visible (filter, &real_c_iter))
1518 if (GTK_TREE_MODEL_FILTER_CACHE_CHILD_ITERS (filter))
1519 felt.iter = real_c_iter;
1521 felt.offset = offset;
1522 felt.zero_ref_count = 0;
1524 felt.visible = TRUE;
1525 felt.children = NULL;
1527 for (i = 0; i < level->array->len; i++)
1528 if (g_array_index (level->array, FilterElt, i).offset > offset)
1531 level->visible_nodes++;
1533 g_array_insert_val (level->array, i, felt);
1535 if (level->parent_level || filter->priv->virtual_root)
1539 f_iter.stamp = filter->priv->stamp;
1540 f_iter.user_data = level;
1541 f_iter.user_data2 = &g_array_index (level->array, FilterElt, i);
1543 gtk_tree_model_filter_ref_node (GTK_TREE_MODEL (filter), &f_iter);
1547 /* another iteration to update the references of children to parents. */
1548 for (i = 0; i < level->array->len; i++)
1550 FilterElt *e = &g_array_index (level->array, FilterElt, i);
1552 e->children->parent_elt = e;
1555 /* don't emit the signal if we aren't visible */
1556 if (!gtk_tree_model_filter_visible (filter, &real_c_iter))
1560 /* NOTE: pass c_path here and NOT real_path. This function does
1561 * root subtraction itself
1563 path = gtk_real_tree_model_filter_convert_child_path_to_path (filter,
1570 gtk_tree_model_filter_increment_stamp (filter);
1572 gtk_tree_model_filter_get_iter_full (GTK_TREE_MODEL (data), &iter, path);
1574 /* get a path taking only visible nodes into account */
1575 gtk_tree_path_free (path);
1576 path = gtk_tree_model_get_path (GTK_TREE_MODEL (data), &iter);
1578 gtk_tree_model_row_inserted (GTK_TREE_MODEL (data), path, &iter);
1580 gtk_tree_path_free (path);
1584 gtk_tree_path_free (real_path);
1587 gtk_tree_path_free (c_path);
1591 gtk_tree_model_filter_row_has_child_toggled (GtkTreeModel *c_model,
1592 GtkTreePath *c_path,
1593 GtkTreeIter *c_iter,
1596 GtkTreeModelFilter *filter = GTK_TREE_MODEL_FILTER (data);
1602 g_return_if_fail (c_path != NULL && c_iter != NULL);
1604 /* If we get row-has-child-toggled on the virtual root, and there is
1605 * no root level; try to build it now.
1607 if (filter->priv->virtual_root && !filter->priv->root
1608 && !gtk_tree_path_compare (c_path, filter->priv->virtual_root))
1610 gtk_tree_model_filter_build_level (filter, NULL, NULL, TRUE);
1614 if (!gtk_tree_model_filter_visible (filter, c_iter))
1617 path = gtk_real_tree_model_filter_convert_child_path_to_path (filter,
1624 gtk_tree_model_filter_get_iter_full (GTK_TREE_MODEL (data), &iter, path);
1626 gtk_tree_path_free (path);
1628 level = FILTER_LEVEL (iter.user_data);
1629 elt = FILTER_ELT (iter.user_data2);
1631 g_assert (elt->visible);
1633 /* If this node is referenced and has children, build the level so we
1634 * can monitor it for changes.
1636 if (elt->ref_count > 1 && gtk_tree_model_iter_has_child (c_model, c_iter))
1637 gtk_tree_model_filter_build_level (filter, level, elt, TRUE);
1639 /* get a path taking only visible nodes into account */
1640 path = gtk_tree_model_get_path (GTK_TREE_MODEL (data), &iter);
1641 gtk_tree_model_row_has_child_toggled (GTK_TREE_MODEL (data), path, &iter);
1642 gtk_tree_path_free (path);
1646 gtk_tree_model_filter_row_deleted (GtkTreeModel *c_model,
1647 GtkTreePath *c_path,
1650 GtkTreeModelFilter *filter = GTK_TREE_MODEL_FILTER (data);
1653 FilterElt *elt, *parent;
1654 FilterLevel *level, *parent_level;
1655 gboolean emit_child_toggled = FALSE;
1659 g_return_if_fail (c_path != NULL);
1661 /* special case the deletion of an ancestor of the virtual root */
1662 if (filter->priv->virtual_root &&
1663 (gtk_tree_path_is_ancestor (c_path, filter->priv->virtual_root) ||
1664 !gtk_tree_path_compare (c_path, filter->priv->virtual_root)))
1668 FilterLevel *level = FILTER_LEVEL (filter->priv->root);
1673 /* remove everything in the filter model
1675 * For now, we just iterate over the root level and emit a
1676 * row_deleted for each FilterElt. Not sure if this is correct.
1679 gtk_tree_model_filter_increment_stamp (filter);
1680 path = gtk_tree_path_new ();
1681 gtk_tree_path_append_index (path, 0);
1683 for (i = 0; i < level->visible_nodes; i++)
1684 gtk_tree_model_row_deleted (GTK_TREE_MODEL (data), path);
1686 gtk_tree_path_free (path);
1687 gtk_tree_model_filter_free_level (filter, filter->priv->root);
1692 /* fixup virtual root */
1693 if (filter->priv->virtual_root)
1695 if (gtk_tree_path_get_depth (filter->priv->virtual_root) >=
1696 gtk_tree_path_get_depth (c_path))
1699 gint *v_indices, *c_indices;
1700 gboolean common_prefix = TRUE;
1702 level = gtk_tree_path_get_depth (c_path) - 1;
1703 v_indices = gtk_tree_path_get_indices (filter->priv->virtual_root);
1704 c_indices = gtk_tree_path_get_indices (c_path);
1706 for (i = 0; i < level; i++)
1707 if (v_indices[i] != c_indices[i])
1709 common_prefix = FALSE;
1713 if (v_indices[level] > c_indices[level])
1714 (v_indices[level])--;
1718 path = gtk_real_tree_model_filter_convert_child_path_to_path (filter,
1725 /* The node deleted in the child model is not visible in the
1726 * filter model. We will not emit a signal, just fixup the offsets
1727 * of the other nodes.
1729 GtkTreePath *real_path;
1731 if (!filter->priv->root)
1734 level = FILTER_LEVEL (filter->priv->root);
1736 /* subtract vroot if necessary */
1737 if (filter->priv->virtual_root)
1739 real_path = gtk_tree_model_filter_remove_root (c_path,
1740 filter->priv->virtual_root);
1741 /* we don't handle this */
1746 real_path = gtk_tree_path_copy (c_path);
1749 if (gtk_tree_path_get_depth (real_path) - 1 >= 1)
1751 /* find the level where the deletion occurred */
1752 while (i < gtk_tree_path_get_depth (real_path) - 1)
1758 /* we don't cover this */
1759 gtk_tree_path_free (real_path);
1763 elt = bsearch_elt_with_offset (level->array,
1764 gtk_tree_path_get_indices (real_path)[i],
1767 if (!elt || !elt->children)
1769 /* parent is filtered out, so no level */
1770 gtk_tree_path_free (real_path);
1774 level = elt->children;
1779 offset = gtk_tree_path_get_indices (real_path)[gtk_tree_path_get_depth (real_path) - 1];
1780 gtk_tree_path_free (real_path);
1785 /* decrease offset of all nodes following the deleted node */
1786 for (i = 0; i < level->array->len; i++)
1788 elt = &g_array_index (level->array, FilterElt, i);
1789 if (elt->offset > offset)
1792 elt->children->parent_elt = elt;
1798 /* a node was deleted, which was in our cache */
1799 gtk_tree_model_filter_get_iter_full (GTK_TREE_MODEL (data), &iter, path);
1801 level = FILTER_LEVEL (iter.user_data);
1802 elt = FILTER_ELT (iter.user_data2);
1803 offset = elt->offset;
1807 /* get a path taking only visible nodes into account */
1808 gtk_tree_path_free (path);
1809 path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter), &iter);
1811 level->visible_nodes--;
1813 if (level->visible_nodes == 0)
1815 emit_child_toggled = TRUE;
1816 parent_level = level->parent_level;
1817 parent = level->parent_elt;
1820 /* emit row_deleted */
1821 gtk_tree_model_filter_increment_stamp (filter);
1822 gtk_tree_model_row_deleted (GTK_TREE_MODEL (data), path);
1823 iter.stamp = filter->priv->stamp;
1826 /* The filter model's reference on the child node is released
1829 while (elt->ref_count > 1)
1830 gtk_tree_model_filter_real_unref_node (GTK_TREE_MODEL (data), &iter,
1833 if (level->array->len == 1)
1836 gtk_tree_model_filter_free_level (filter, level);
1842 /* release the filter model's reference on the node */
1843 if (level->parent_level || filter->priv->virtual_root)
1844 gtk_tree_model_filter_unref_node (GTK_TREE_MODEL (filter), &iter);
1846 gtk_tree_model_filter_real_unref_node (GTK_TREE_MODEL (data), &iter,
1849 /* remove the row */
1850 tmp = bsearch_elt_with_offset (level->array, elt->offset, &i);
1852 offset = tmp->offset;
1853 g_array_remove_index (level->array, i);
1856 for (i = MAX (i, 0); i < level->array->len; i++)
1858 elt = &g_array_index (level->array, FilterElt, i);
1859 if (elt->offset > offset)
1862 elt->children->parent_elt = elt;
1866 if (emit_child_toggled && parent_level)
1871 iter.stamp = filter->priv->stamp;
1872 iter.user_data = parent_level;
1873 iter.user_data2 = parent;
1875 /* We set in_row_deleted to TRUE to avoid a level build triggered
1876 * by row-has-child-toggled (parent model could call iter_has_child
1879 filter->priv->in_row_deleted = TRUE;
1880 path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter), &iter);
1881 gtk_tree_model_row_has_child_toggled (GTK_TREE_MODEL (filter),
1883 gtk_tree_path_free (path);
1884 filter->priv->in_row_deleted = FALSE;
1887 gtk_tree_path_free (path);
1891 gtk_tree_model_filter_rows_reordered (GtkTreeModel *c_model,
1892 GtkTreePath *c_path,
1893 GtkTreeIter *c_iter,
1899 GtkTreeModelFilter *filter = GTK_TREE_MODEL_FILTER (data);
1905 gint i, j, elt_count;
1910 g_return_if_fail (new_order != NULL);
1912 if (c_path == NULL || gtk_tree_path_get_indices (c_path) == NULL)
1914 if (!filter->priv->root)
1917 length = gtk_tree_model_iter_n_children (c_model, NULL);
1919 if (filter->priv->virtual_root)
1923 /* reorder root level of path */
1924 for (i = 0; i < length; i++)
1925 if (new_order[i] == gtk_tree_path_get_indices (filter->priv->virtual_root)[0])
1931 gtk_tree_path_get_indices (filter->priv->virtual_root)[0] = new_pos;
1935 path = gtk_tree_path_new ();
1936 level = FILTER_LEVEL (filter->priv->root);
1940 GtkTreeIter child_iter;
1942 /* virtual root anchor reordering */
1943 if (filter->priv->virtual_root &&
1944 gtk_tree_path_get_depth (c_path) <
1945 gtk_tree_path_get_depth (filter->priv->virtual_root))
1950 GtkTreeIter real_c_iter;
1952 level = gtk_tree_path_get_depth (c_path);
1955 real_c_iter = *c_iter;
1957 gtk_tree_model_get_iter (c_model, &real_c_iter, c_path);
1959 length = gtk_tree_model_iter_n_children (c_model, &real_c_iter);
1961 for (i = 0; i < length; i++)
1962 if (new_order[i] == gtk_tree_path_get_indices (filter->priv->virtual_root)[level])
1968 gtk_tree_path_get_indices (filter->priv->virtual_root)[level] = new_pos;
1972 path = gtk_real_tree_model_filter_convert_child_path_to_path (filter,
1977 if (!path && filter->priv->virtual_root &&
1978 gtk_tree_path_compare (c_path, filter->priv->virtual_root))
1981 if (!path && !filter->priv->virtual_root)
1986 /* root level mode */
1988 gtk_tree_model_get_iter (c_model, c_iter, c_path);
1989 length = gtk_tree_model_iter_n_children (c_model, c_iter);
1990 path = gtk_tree_path_new ();
1991 level = FILTER_LEVEL (filter->priv->root);
1995 gtk_tree_model_filter_get_iter_full (GTK_TREE_MODEL (data),
1998 level = FILTER_LEVEL (iter.user_data);
1999 elt = FILTER_ELT (iter.user_data2);
2003 gtk_tree_path_free (path);
2007 level = elt->children;
2009 gtk_tree_model_filter_convert_iter_to_child_iter (GTK_TREE_MODEL_FILTER (filter), &child_iter, &iter);
2010 length = gtk_tree_model_iter_n_children (c_model, &child_iter);
2014 if (level->array->len < 1)
2016 gtk_tree_path_free (path);
2020 /* NOTE: we do not bail out here if level->array->len < 2 like
2021 * GtkTreeModelSort does. This because we do some special tricky
2025 /* construct a new array */
2026 new_array = g_array_sized_new (FALSE, FALSE, sizeof (FilterElt),
2028 tmp_array = g_new (gint, level->array->len);
2030 for (i = 0, elt_count = 0; i < length; i++)
2032 FilterElt *e = NULL;
2033 gint old_offset = -1;
2035 for (j = 0; j < level->array->len; j++)
2036 if (g_array_index (level->array, FilterElt, j).offset == new_order[i])
2038 e = &g_array_index (level->array, FilterElt, j);
2046 tmp_array[elt_count] = old_offset;
2047 g_array_append_val (new_array, *e);
2048 g_array_index (new_array, FilterElt, elt_count).offset = i;
2052 g_array_free (level->array, TRUE);
2053 level->array = new_array;
2056 for (i = 0; i < level->array->len; i++)
2058 FilterElt *e = &g_array_index (level->array, FilterElt, i);
2060 e->children->parent_elt = e;
2063 /* emit rows_reordered */
2064 if (!gtk_tree_path_get_indices (path))
2065 gtk_tree_model_rows_reordered (GTK_TREE_MODEL (data), path, NULL,
2069 /* get a path taking only visible nodes into account */
2070 gtk_tree_path_free (path);
2071 path = gtk_tree_model_get_path (GTK_TREE_MODEL (data), &iter);
2073 gtk_tree_model_rows_reordered (GTK_TREE_MODEL (data), path, &iter,
2079 gtk_tree_path_free (path);
2082 /* TreeModelIface implementation */
2083 static GtkTreeModelFlags
2084 gtk_tree_model_filter_get_flags (GtkTreeModel *model)
2086 GtkTreeModelFlags flags;
2088 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), 0);
2089 g_return_val_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->child_model != NULL, 0);
2091 flags = gtk_tree_model_get_flags (GTK_TREE_MODEL_FILTER (model)->priv->child_model);
2093 if ((flags & GTK_TREE_MODEL_LIST_ONLY) == GTK_TREE_MODEL_LIST_ONLY)
2094 return GTK_TREE_MODEL_LIST_ONLY;
2100 gtk_tree_model_filter_get_n_columns (GtkTreeModel *model)
2102 GtkTreeModelFilter *filter = (GtkTreeModelFilter *)model;
2104 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), 0);
2105 g_return_val_if_fail (filter->priv->child_model != NULL, 0);
2107 if (filter->priv->child_model == NULL)
2110 /* so we can't modify the modify func after this ... */
2111 filter->priv->modify_func_set = TRUE;
2113 if (filter->priv->modify_n_columns > 0)
2114 return filter->priv->modify_n_columns;
2116 return gtk_tree_model_get_n_columns (filter->priv->child_model);
2120 gtk_tree_model_filter_get_column_type (GtkTreeModel *model,
2123 GtkTreeModelFilter *filter = (GtkTreeModelFilter *)model;
2125 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), G_TYPE_INVALID);
2126 g_return_val_if_fail (filter->priv->child_model != NULL, G_TYPE_INVALID);
2128 /* so we can't modify the modify func after this ... */
2129 filter->priv->modify_func_set = TRUE;
2131 if (filter->priv->modify_types)
2133 g_return_val_if_fail (index < filter->priv->modify_n_columns, G_TYPE_INVALID);
2135 return filter->priv->modify_types[index];
2138 return gtk_tree_model_get_column_type (filter->priv->child_model, index);
2141 /* A special case of _get_iter; this function can also get iters which
2142 * are not visible. These iters should ONLY be passed internally, never
2143 * pass those along with a signal emission.
2146 gtk_tree_model_filter_get_iter_full (GtkTreeModel *model,
2150 GtkTreeModelFilter *filter = (GtkTreeModelFilter *)model;
2155 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), FALSE);
2156 g_return_val_if_fail (filter->priv->child_model != NULL, FALSE);
2158 indices = gtk_tree_path_get_indices (path);
2160 if (filter->priv->root == NULL)
2161 gtk_tree_model_filter_build_level (filter, NULL, NULL, FALSE);
2162 level = FILTER_LEVEL (filter->priv->root);
2164 depth = gtk_tree_path_get_depth (path);
2171 for (i = 0; i < depth - 1; i++)
2173 if (!level || indices[i] >= level->array->len)
2178 elt = gtk_tree_model_filter_get_nth (filter, level, indices[i]);
2181 gtk_tree_model_filter_build_level (filter, level, elt, FALSE);
2182 level = elt->children;
2185 if (!level || indices[i] >= level->array->len)
2191 iter->stamp = filter->priv->stamp;
2192 iter->user_data = level;
2194 elt = gtk_tree_model_filter_get_nth (filter, level, indices[depth - 1]);
2195 iter->user_data2 = elt;
2201 gtk_tree_model_filter_get_iter (GtkTreeModel *model,
2205 GtkTreeModelFilter *filter = (GtkTreeModelFilter *)model;
2210 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), FALSE);
2211 g_return_val_if_fail (filter->priv->child_model != NULL, FALSE);
2213 indices = gtk_tree_path_get_indices (path);
2215 if (filter->priv->root == NULL)
2216 gtk_tree_model_filter_build_level (filter, NULL, NULL, FALSE);
2217 level = FILTER_LEVEL (filter->priv->root);
2219 depth = gtk_tree_path_get_depth (path);
2226 for (i = 0; i < depth - 1; i++)
2228 if (!level || indices[i] >= level->visible_nodes)
2233 elt = gtk_tree_model_filter_get_nth_visible (filter, level, indices[i]);
2236 gtk_tree_model_filter_build_level (filter, level, elt, FALSE);
2237 level = elt->children;
2240 if (!level || indices[i] >= level->visible_nodes)
2246 iter->stamp = filter->priv->stamp;
2247 iter->user_data = level;
2249 elt = gtk_tree_model_filter_get_nth_visible (filter, level,
2250 indices[depth - 1]);
2251 iter->user_data2 = elt;
2256 static GtkTreePath *
2257 gtk_tree_model_filter_get_path (GtkTreeModel *model,
2260 GtkTreePath *retval;
2264 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), NULL);
2265 g_return_val_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->child_model != NULL, NULL);
2266 g_return_val_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->stamp == iter->stamp, NULL);
2268 retval = gtk_tree_path_new ();
2269 level = iter->user_data;
2270 elt = iter->user_data2;
2277 int i = 0, index = 0;
2279 while (&g_array_index (level->array, FilterElt, i) != elt)
2281 if (g_array_index (level->array, FilterElt, i).visible)
2285 g_assert (i < level->array->len);
2288 gtk_tree_path_prepend_index (retval, index);
2289 elt = level->parent_elt;
2290 level = level->parent_level;
2297 gtk_tree_model_filter_get_value (GtkTreeModel *model,
2302 GtkTreeIter child_iter;
2303 GtkTreeModelFilter *filter = GTK_TREE_MODEL_FILTER (model);
2305 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (model));
2306 g_return_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->child_model != NULL);
2307 g_return_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->stamp == iter->stamp);
2309 if (filter->priv->modify_func)
2311 g_return_if_fail (column < filter->priv->modify_n_columns);
2313 g_value_init (value, filter->priv->modify_types[column]);
2314 filter->priv->modify_func (model,
2318 filter->priv->modify_data);
2323 gtk_tree_model_filter_convert_iter_to_child_iter (GTK_TREE_MODEL_FILTER (model), &child_iter, iter);
2324 gtk_tree_model_get_value (GTK_TREE_MODEL_FILTER (model)->priv->child_model,
2325 &child_iter, column, value);
2329 gtk_tree_model_filter_iter_next (GtkTreeModel *model,
2336 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), FALSE);
2337 g_return_val_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->child_model != NULL, FALSE);
2338 g_return_val_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->stamp == iter->stamp, FALSE);
2340 level = iter->user_data;
2341 elt = iter->user_data2;
2343 i = elt - FILTER_ELT (level->array->data);
2345 while (i < level->array->len - 1)
2352 iter->user_data2 = elt;
2357 /* no next visible iter */
2364 gtk_tree_model_filter_iter_children (GtkTreeModel *model,
2366 GtkTreeIter *parent)
2368 GtkTreeModelFilter *filter = (GtkTreeModelFilter *)model;
2372 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), FALSE);
2373 g_return_val_if_fail (filter->priv->child_model != NULL, FALSE);
2375 g_return_val_if_fail (filter->priv->stamp == parent->stamp, FALSE);
2381 if (!filter->priv->root)
2382 gtk_tree_model_filter_build_level (filter, NULL, NULL, FALSE);
2383 if (!filter->priv->root)
2386 level = filter->priv->root;
2388 if (!level->visible_nodes)
2391 iter->stamp = filter->priv->stamp;
2392 iter->user_data = level;
2394 while (i < level->array->len)
2396 if (!g_array_index (level->array, FilterElt, i).visible)
2402 iter->user_data2 = &g_array_index (level->array, FilterElt, i);
2413 if (FILTER_ELT (parent->user_data2)->children == NULL)
2414 gtk_tree_model_filter_build_level (filter,
2415 FILTER_LEVEL (parent->user_data),
2416 FILTER_ELT (parent->user_data2),
2418 if (FILTER_ELT (parent->user_data2)->children == NULL)
2421 if (FILTER_ELT (parent->user_data2)->children->visible_nodes <= 0)
2424 iter->stamp = filter->priv->stamp;
2425 iter->user_data = FILTER_ELT (parent->user_data2)->children;
2427 level = FILTER_LEVEL (iter->user_data);
2429 while (i < level->array->len)
2431 if (!g_array_index (level->array, FilterElt, i).visible)
2437 iter->user_data2 = &g_array_index (level->array, FilterElt, i);
2450 gtk_tree_model_filter_iter_has_child (GtkTreeModel *model,
2453 GtkTreeIter child_iter;
2454 GtkTreeModelFilter *filter = (GtkTreeModelFilter *)model;
2457 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), FALSE);
2458 g_return_val_if_fail (filter->priv->child_model != NULL, FALSE);
2459 g_return_val_if_fail (filter->priv->stamp == iter->stamp, FALSE);
2461 filter = GTK_TREE_MODEL_FILTER (model);
2463 gtk_tree_model_filter_convert_iter_to_child_iter (GTK_TREE_MODEL_FILTER (model), &child_iter, iter);
2464 elt = FILTER_ELT (iter->user_data2);
2469 /* we need to build the level to check if not all children are filtered
2473 && gtk_tree_model_iter_has_child (filter->priv->child_model, &child_iter))
2474 gtk_tree_model_filter_build_level (filter, FILTER_LEVEL (iter->user_data),
2477 if (elt->children && elt->children->visible_nodes > 0)
2484 gtk_tree_model_filter_iter_n_children (GtkTreeModel *model,
2487 GtkTreeIter child_iter;
2488 GtkTreeModelFilter *filter = (GtkTreeModelFilter *)model;
2491 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), 0);
2492 g_return_val_if_fail (filter->priv->child_model != NULL, 0);
2494 g_return_val_if_fail (filter->priv->stamp == iter->stamp, 0);
2498 if (!filter->priv->root)
2499 gtk_tree_model_filter_build_level (filter, NULL, NULL, FALSE);
2501 if (filter->priv->root)
2502 return FILTER_LEVEL (filter->priv->root)->visible_nodes;
2507 elt = FILTER_ELT (iter->user_data2);
2512 gtk_tree_model_filter_convert_iter_to_child_iter (GTK_TREE_MODEL_FILTER (model), &child_iter, iter);
2514 if (!elt->children &&
2515 gtk_tree_model_iter_has_child (filter->priv->child_model, &child_iter))
2516 gtk_tree_model_filter_build_level (filter,
2517 FILTER_LEVEL (iter->user_data),
2521 return elt->children->visible_nodes;
2527 gtk_tree_model_filter_iter_nth_child (GtkTreeModel *model,
2529 GtkTreeIter *parent,
2534 GtkTreeIter children;
2536 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), FALSE);
2538 g_return_val_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->stamp == parent->stamp, FALSE);
2540 /* use this instead of has_child to force us to build the level, if needed */
2541 if (gtk_tree_model_filter_iter_children (model, &children, parent) == FALSE)
2547 level = children.user_data;
2548 elt = FILTER_ELT (level->array->data);
2550 if (n >= level->visible_nodes)
2556 elt = gtk_tree_model_filter_get_nth_visible (GTK_TREE_MODEL_FILTER (model),
2559 iter->stamp = GTK_TREE_MODEL_FILTER (model)->priv->stamp;
2560 iter->user_data = level;
2561 iter->user_data2 = elt;
2567 gtk_tree_model_filter_iter_parent (GtkTreeModel *model,
2574 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (model), FALSE);
2575 g_return_val_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->child_model != NULL, FALSE);
2576 g_return_val_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->stamp == child->stamp, FALSE);
2578 level = child->user_data;
2580 if (level->parent_level)
2582 iter->stamp = GTK_TREE_MODEL_FILTER (model)->priv->stamp;
2583 iter->user_data = level->parent_level;
2584 iter->user_data2 = level->parent_elt;
2593 gtk_tree_model_filter_ref_node (GtkTreeModel *model,
2596 GtkTreeModelFilter *filter = (GtkTreeModelFilter *)model;
2597 GtkTreeIter child_iter;
2601 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (model));
2602 g_return_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->child_model != NULL);
2603 g_return_if_fail (GTK_TREE_MODEL_FILTER (model)->priv->stamp == iter->stamp);
2605 gtk_tree_model_filter_convert_iter_to_child_iter (GTK_TREE_MODEL_FILTER (model), &child_iter, iter);
2607 gtk_tree_model_ref_node (filter->priv->child_model, &child_iter);
2609 level = iter->user_data;
2610 elt = iter->user_data2;
2614 if (level->ref_count == 1)
2616 FilterLevel *parent_level = level->parent_level;
2617 FilterElt *parent_elt = level->parent_elt;
2619 /* we were at zero -- time to decrease the zero_ref_count val */
2623 parent_elt->zero_ref_count--;
2627 parent_elt = parent_level->parent_elt;
2628 parent_level = parent_level->parent_level;
2631 while (parent_level);
2632 filter->priv->zero_ref_count--;
2637 gtk_tree_model_filter_unref_node (GtkTreeModel *model,
2640 gtk_tree_model_filter_real_unref_node (model, iter, TRUE);
2644 gtk_tree_model_filter_real_unref_node (GtkTreeModel *model,
2646 gboolean propagate_unref)
2648 GtkTreeModelFilter *filter = (GtkTreeModelFilter *)model;
2652 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (model));
2653 g_return_if_fail (filter->priv->child_model != NULL);
2654 g_return_if_fail (filter->priv->stamp == iter->stamp);
2656 if (propagate_unref)
2658 GtkTreeIter child_iter;
2659 gtk_tree_model_filter_convert_iter_to_child_iter (GTK_TREE_MODEL_FILTER (model), &child_iter, iter);
2660 gtk_tree_model_unref_node (filter->priv->child_model, &child_iter);
2663 level = iter->user_data;
2664 elt = iter->user_data2;
2666 g_return_if_fail (elt->ref_count > 0);
2670 if (level->ref_count == 0)
2672 FilterLevel *parent_level = level->parent_level;
2673 FilterElt *parent_elt = level->parent_elt;
2675 /* we are at zero -- time to increase the zero_ref_count val */
2676 while (parent_level)
2678 parent_elt->zero_ref_count++;
2680 parent_elt = parent_level->parent_elt;
2681 parent_level = parent_level->parent_level;
2683 filter->priv->zero_ref_count++;
2687 /* TreeDragSource interface implementation */
2689 gtk_tree_model_filter_row_draggable (GtkTreeDragSource *drag_source,
2692 GtkTreeModelFilter *tree_model_filter = (GtkTreeModelFilter *)drag_source;
2693 GtkTreePath *child_path;
2696 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (drag_source), FALSE);
2697 g_return_val_if_fail (path != NULL, FALSE);
2699 child_path = gtk_tree_model_filter_convert_path_to_child_path (tree_model_filter, path);
2700 draggable = gtk_tree_drag_source_row_draggable (GTK_TREE_DRAG_SOURCE (tree_model_filter->priv->child_model), child_path);
2701 gtk_tree_path_free (child_path);
2707 gtk_tree_model_filter_drag_data_get (GtkTreeDragSource *drag_source,
2709 GtkSelectionData *selection_data)
2711 GtkTreeModelFilter *tree_model_filter = (GtkTreeModelFilter *)drag_source;
2712 GtkTreePath *child_path;
2715 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (drag_source), FALSE);
2716 g_return_val_if_fail (path != NULL, FALSE);
2718 child_path = gtk_tree_model_filter_convert_path_to_child_path (tree_model_filter, path);
2719 gotten = gtk_tree_drag_source_drag_data_get (GTK_TREE_DRAG_SOURCE (tree_model_filter->priv->child_model), child_path, selection_data);
2720 gtk_tree_path_free (child_path);
2726 gtk_tree_model_filter_drag_data_delete (GtkTreeDragSource *drag_source,
2729 GtkTreeModelFilter *tree_model_filter = (GtkTreeModelFilter *)drag_source;
2730 GtkTreePath *child_path;
2733 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (drag_source), FALSE);
2734 g_return_val_if_fail (path != NULL, FALSE);
2736 child_path = gtk_tree_model_filter_convert_path_to_child_path (tree_model_filter, path);
2737 deleted = gtk_tree_drag_source_drag_data_delete (GTK_TREE_DRAG_SOURCE (tree_model_filter->priv->child_model), child_path);
2738 gtk_tree_path_free (child_path);
2743 /* bits and pieces */
2745 gtk_tree_model_filter_set_model (GtkTreeModelFilter *filter,
2746 GtkTreeModel *child_model)
2748 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (filter));
2750 if (filter->priv->child_model)
2752 g_signal_handler_disconnect (filter->priv->child_model,
2753 filter->priv->changed_id);
2754 g_signal_handler_disconnect (filter->priv->child_model,
2755 filter->priv->inserted_id);
2756 g_signal_handler_disconnect (filter->priv->child_model,
2757 filter->priv->has_child_toggled_id);
2758 g_signal_handler_disconnect (filter->priv->child_model,
2759 filter->priv->deleted_id);
2760 g_signal_handler_disconnect (filter->priv->child_model,
2761 filter->priv->reordered_id);
2763 /* reset our state */
2764 if (filter->priv->root)
2765 gtk_tree_model_filter_free_level (filter, filter->priv->root);
2767 filter->priv->root = NULL;
2768 g_object_unref (filter->priv->child_model);
2769 filter->priv->visible_column = -1;
2771 /* FIXME: do we need to destroy more here? */
2774 filter->priv->child_model = child_model;
2778 g_object_ref (filter->priv->child_model);
2779 filter->priv->changed_id =
2780 g_signal_connect (child_model, "row_changed",
2781 G_CALLBACK (gtk_tree_model_filter_row_changed),
2783 filter->priv->inserted_id =
2784 g_signal_connect (child_model, "row_inserted",
2785 G_CALLBACK (gtk_tree_model_filter_row_inserted),
2787 filter->priv->has_child_toggled_id =
2788 g_signal_connect (child_model, "row_has_child_toggled",
2789 G_CALLBACK (gtk_tree_model_filter_row_has_child_toggled),
2791 filter->priv->deleted_id =
2792 g_signal_connect (child_model, "row_deleted",
2793 G_CALLBACK (gtk_tree_model_filter_row_deleted),
2795 filter->priv->reordered_id =
2796 g_signal_connect (child_model, "rows_reordered",
2797 G_CALLBACK (gtk_tree_model_filter_rows_reordered),
2800 filter->priv->child_flags = gtk_tree_model_get_flags (child_model);
2801 filter->priv->stamp = g_random_int ();
2806 gtk_tree_model_filter_ref_path (GtkTreeModelFilter *filter,
2812 len = gtk_tree_path_get_depth (path);
2813 p = gtk_tree_path_copy (path);
2818 gtk_tree_model_get_iter (GTK_TREE_MODEL (filter->priv->child_model), &iter, p);
2819 gtk_tree_model_ref_node (GTK_TREE_MODEL (filter->priv->child_model), &iter);
2820 gtk_tree_path_up (p);
2825 gtk_tree_model_filter_unref_path (GtkTreeModelFilter *filter,
2831 len = gtk_tree_path_get_depth (path);
2832 p = gtk_tree_path_copy (path);
2837 gtk_tree_model_get_iter (GTK_TREE_MODEL (filter->priv->child_model), &iter, p);
2838 gtk_tree_model_unref_node (GTK_TREE_MODEL (filter->priv->child_model), &iter);
2839 gtk_tree_path_up (p);
2844 gtk_tree_model_filter_set_root (GtkTreeModelFilter *filter,
2847 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (filter));
2850 filter->priv->virtual_root = NULL;
2852 filter->priv->virtual_root = gtk_tree_path_copy (root);
2858 * gtk_tree_model_filter_new:
2859 * @child_model: A #GtkTreeModel.
2860 * @root: A #GtkTreePath or %NULL.
2862 * Creates a new #GtkTreeModel, with @child_model as the child_model
2863 * and @root as the virtual root.
2865 * Return value: A new #GtkTreeModel.
2870 gtk_tree_model_filter_new (GtkTreeModel *child_model,
2873 GtkTreeModel *retval;
2874 GtkTreeModelFilter *filter;
2876 g_return_val_if_fail (GTK_IS_TREE_MODEL (child_model), NULL);
2878 retval = g_object_new (GTK_TYPE_TREE_MODEL_FILTER,
2879 "child-model", child_model,
2880 "virtual-root", root,
2883 filter = GTK_TREE_MODEL_FILTER (retval);
2884 if (filter->priv->virtual_root)
2885 gtk_tree_model_filter_ref_path (filter, filter->priv->virtual_root);
2891 * gtk_tree_model_filter_get_model:
2892 * @filter: A #GtkTreeModelFilter.
2894 * Returns a pointer to the child model of @filter.
2896 * Return value: A pointer to a #GtkTreeModel.
2901 gtk_tree_model_filter_get_model (GtkTreeModelFilter *filter)
2903 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (filter), NULL);
2905 return filter->priv->child_model;
2909 * gtk_tree_model_filter_set_visible_func:
2910 * @filter: A #GtkTreeModelFilter.
2911 * @func: A #GtkTreeModelFilterVisibleFunc, the visible function.
2912 * @data: User data to pass to the visible function, or %NULL.
2913 * @destroy: Destroy notifier of @data, or %NULL.
2915 * Sets the visible function used when filtering the @filter to be @func. The
2916 * function should return %TRUE if the given row should be visible and
2919 * If the condition calculated by the function changes over time (e.g. because
2920 * it depends on some global parameters), you must call
2921 * gtk_tree_model_filter_refilter() to keep the visibility information of
2922 * the model uptodate.
2927 gtk_tree_model_filter_set_visible_func (GtkTreeModelFilter *filter,
2928 GtkTreeModelFilterVisibleFunc func,
2930 GtkDestroyNotify destroy)
2932 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (filter));
2933 g_return_if_fail (func != NULL);
2934 g_return_if_fail (filter->priv->visible_method_set == FALSE);
2936 if (filter->priv->visible_func)
2938 GtkDestroyNotify d = filter->priv->visible_destroy;
2940 filter->priv->visible_destroy = NULL;
2941 d (filter->priv->visible_data);
2944 filter->priv->visible_func = func;
2945 filter->priv->visible_data = data;
2946 filter->priv->visible_destroy = destroy;
2948 filter->priv->visible_method_set = TRUE;
2952 * gtk_tree_model_filter_set_modify_func:
2953 * @filter: A #GtkTreeModelFilter.
2954 * @n_columns: The number of columns in the filter model.
2955 * @types: The #GType<!-- -->s of the columns.
2956 * @func: A #GtkTreeModelFilterModifyFunc
2957 * @data: User data to pass to the modify function, or %NULL.
2958 * @destroy: Destroy notifier of @data, or %NULL.
2960 * With the @n_columns and @types parameters, you give an array of column
2961 * types for this model (which will be exposed to the parent model/view).
2962 * The @func, @data and @destroy parameters are for specifying the modify
2963 * function. The modify function will get called for <emphasis>each</emphasis>
2964 * data access, the goal of the modify function is to return the data which
2965 * should be displayed at the location specified using the parameters of the
2971 gtk_tree_model_filter_set_modify_func (GtkTreeModelFilter *filter,
2974 GtkTreeModelFilterModifyFunc func,
2976 GtkDestroyNotify destroy)
2978 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (filter));
2979 g_return_if_fail (func != NULL);
2980 g_return_if_fail (filter->priv->modify_func_set == FALSE);
2982 if (filter->priv->modify_destroy)
2984 GtkDestroyNotify d = filter->priv->modify_destroy;
2986 filter->priv->modify_destroy = NULL;
2987 d (filter->priv->modify_data);
2990 filter->priv->modify_n_columns = n_columns;
2991 filter->priv->modify_types = g_new0 (GType, n_columns);
2992 memcpy (filter->priv->modify_types, types, sizeof (GType) * n_columns);
2993 filter->priv->modify_func = func;
2994 filter->priv->modify_data = data;
2995 filter->priv->modify_destroy = destroy;
2997 filter->priv->modify_func_set = TRUE;
3001 * gtk_tree_model_filter_set_visible_column:
3002 * @filter: A #GtkTreeModelFilter.
3003 * @column: A #gint which is the column containing the visible information.
3005 * Sets @column of the child_model to be the column where @filter should
3006 * look for visibility information. @columns should be a column of type
3007 * %G_TYPE_BOOLEAN, where %TRUE means that a row is visible, and %FALSE
3013 gtk_tree_model_filter_set_visible_column (GtkTreeModelFilter *filter,
3016 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (filter));
3017 g_return_if_fail (column >= 0);
3018 g_return_if_fail (filter->priv->visible_method_set == FALSE);
3020 filter->priv->visible_column = column;
3022 filter->priv->visible_method_set = TRUE;
3028 * gtk_tree_model_filter_convert_child_iter_to_iter:
3029 * @filter: A #GtkTreeModelFilter.
3030 * @filter_iter: An uninitialized #GtkTreeIter.
3031 * @child_iter: A valid #GtkTreeIter pointing to a row on the child model.
3033 * Sets @filter_iter to point to the row in @filter that corresponds to the
3034 * row pointed at by @child_iter.
3039 gtk_tree_model_filter_convert_child_iter_to_iter (GtkTreeModelFilter *filter,
3040 GtkTreeIter *filter_iter,
3041 GtkTreeIter *child_iter)
3043 GtkTreePath *child_path, *path;
3045 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (filter));
3046 g_return_if_fail (filter->priv->child_model != NULL);
3047 g_return_if_fail (filter_iter != NULL);
3048 g_return_if_fail (child_iter != NULL);
3050 filter_iter->stamp = 0;
3052 child_path = gtk_tree_model_get_path (filter->priv->child_model, child_iter);
3053 g_return_if_fail (child_path != NULL);
3055 path = gtk_tree_model_filter_convert_child_path_to_path (filter,
3057 gtk_tree_path_free (child_path);
3058 g_return_if_fail (path != NULL);
3060 gtk_tree_model_get_iter (GTK_TREE_MODEL (filter), filter_iter, path);
3061 gtk_tree_path_free (path);
3065 * gtk_tree_model_filter_convert_iter_to_child_iter:
3066 * @filter: A #GtkTreeModelFilter.
3067 * @child_iter: An uninitialized #GtkTreeIter.
3068 * @filter_iter: A valid #GtkTreeIter pointing to a row on @filter.
3070 * Sets @child_iter to point to the row pointed to by @filter_iter.
3075 gtk_tree_model_filter_convert_iter_to_child_iter (GtkTreeModelFilter *filter,
3076 GtkTreeIter *child_iter,
3077 GtkTreeIter *filter_iter)
3079 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (filter));
3080 g_return_if_fail (filter->priv->child_model != NULL);
3081 g_return_if_fail (child_iter != NULL);
3082 g_return_if_fail (filter_iter != NULL);
3083 g_return_if_fail (filter_iter->stamp == filter->priv->stamp);
3085 if (GTK_TREE_MODEL_FILTER_CACHE_CHILD_ITERS (filter))
3087 *child_iter = FILTER_ELT (filter_iter->user_data2)->iter;
3093 path = gtk_tree_model_filter_elt_get_path (filter_iter->user_data,
3094 filter_iter->user_data2,
3095 filter->priv->virtual_root);
3096 gtk_tree_model_get_iter (filter->priv->child_model, child_iter, path);
3097 gtk_tree_path_free (path);
3101 /* The path returned can only be used internally in the filter model. */
3102 static GtkTreePath *
3103 gtk_real_tree_model_filter_convert_child_path_to_path (GtkTreeModelFilter *filter,
3104 GtkTreePath *child_path,
3105 gboolean build_levels,
3106 gboolean fetch_children)
3108 gint *child_indices;
3109 GtkTreePath *retval;
3110 GtkTreePath *real_path;
3115 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (filter), NULL);
3116 g_return_val_if_fail (filter->priv->child_model != NULL, NULL);
3117 g_return_val_if_fail (child_path != NULL, NULL);
3119 if (!filter->priv->virtual_root)
3120 real_path = gtk_tree_path_copy (child_path);
3122 real_path = gtk_tree_model_filter_remove_root (child_path,
3123 filter->priv->virtual_root);
3128 retval = gtk_tree_path_new ();
3129 child_indices = gtk_tree_path_get_indices (real_path);
3131 if (filter->priv->root == NULL && build_levels)
3132 gtk_tree_model_filter_build_level (filter, NULL, NULL, FALSE);
3133 level = FILTER_LEVEL (filter->priv->root);
3135 for (i = 0; i < gtk_tree_path_get_depth (real_path); i++)
3138 gboolean found_child = FALSE;
3142 gtk_tree_path_free (real_path);
3143 gtk_tree_path_free (retval);
3147 tmp = bsearch_elt_with_offset (level->array, child_indices[i], &j);
3150 gtk_tree_path_append_index (retval, j);
3151 if (!tmp->children && build_levels)
3152 gtk_tree_model_filter_build_level (filter, level, tmp, FALSE);
3153 level = tmp->children;
3157 if (!found_child && fetch_children)
3159 tmp = gtk_tree_model_filter_fetch_child (filter, level,
3163 /* didn't find the child, let's try to bring it back */
3164 if (!tmp || tmp->offset != child_indices[i])
3167 gtk_tree_path_free (real_path);
3168 gtk_tree_path_free (retval);
3172 gtk_tree_path_append_index (retval, j);
3173 if (!tmp->children && build_levels)
3174 gtk_tree_model_filter_build_level (filter, level, tmp, FALSE);
3175 level = tmp->children;
3178 else if (!found_child && !fetch_children)
3181 gtk_tree_path_free (real_path);
3182 gtk_tree_path_free (retval);
3187 gtk_tree_path_free (real_path);
3192 * gtk_tree_model_filter_convert_child_path_to_path:
3193 * @filter: A #GtkTreeModelFilter.
3194 * @child_path: A #GtkTreePath to convert.
3196 * Converts @child_path to a path relative to @filter. That is, @child_path
3197 * points to a path in the child model. The rerturned path will point to the
3198 * same row in the filtered model. If @child_path isn't a valid path on the
3199 * child model, then %NULL is returned.
3201 * Return value: A newly allocated #GtkTreePath, or %NULL.
3206 gtk_tree_model_filter_convert_child_path_to_path (GtkTreeModelFilter *filter,
3207 GtkTreePath *child_path)
3212 /* this function does the sanity checks */
3213 path = gtk_real_tree_model_filter_convert_child_path_to_path (filter,
3218 /* get a new path which only takes visible nodes into account.
3219 * -- if this gives any performance issues, we can write a special
3220 * version of convert_child_path_to_path immediately returning
3221 * a visible-nodes-only path.
3223 gtk_tree_model_get_iter (GTK_TREE_MODEL (filter), &iter, path);
3225 gtk_tree_path_free (path);
3226 path = gtk_tree_model_get_path (GTK_TREE_MODEL (filter), &iter);
3232 * gtk_tree_model_filter_convert_path_to_child_path:
3233 * @filter: A #GtkTreeModelFilter.
3234 * @filter_path: A #GtkTreePath to convert.
3236 * Converts @filter_path to a path on the child model of @filter. That is,
3237 * @filter_path points to a location in @filter. The returned path will
3238 * point to the same location in the model not being filtered. If @filter_path
3239 * does not point to a location in the child model, %NULL is returned.
3241 * Return value: A newly allocated #GtkTreePath, or %NULL.
3246 gtk_tree_model_filter_convert_path_to_child_path (GtkTreeModelFilter *filter,
3247 GtkTreePath *filter_path)
3249 gint *filter_indices;
3250 GtkTreePath *retval;
3254 g_return_val_if_fail (GTK_IS_TREE_MODEL_FILTER (filter), NULL);
3255 g_return_val_if_fail (filter->priv->child_model != NULL, NULL);
3256 g_return_val_if_fail (filter_path != NULL, NULL);
3259 retval = gtk_tree_path_new ();
3260 filter_indices = gtk_tree_path_get_indices (filter_path);
3261 if (!filter->priv->root)
3262 gtk_tree_model_filter_build_level (filter, NULL, NULL, FALSE);
3263 level = FILTER_LEVEL (filter->priv->root);
3265 for (i = 0; i < gtk_tree_path_get_depth (filter_path); i++)
3269 if (!level || level->visible_nodes <= filter_indices[i])
3271 gtk_tree_path_free (retval);
3275 elt = gtk_tree_model_filter_get_nth_visible (filter, level,
3278 if (elt->children == NULL)
3279 gtk_tree_model_filter_build_level (filter, level, elt, FALSE);
3281 if (!level || level->visible_nodes <= filter_indices[i])
3283 gtk_tree_path_free (retval);
3287 gtk_tree_path_append_index (retval, elt->offset);
3288 level = elt->children;
3293 if (filter->priv->virtual_root)
3295 GtkTreePath *real_retval;
3297 real_retval = gtk_tree_model_filter_add_root (retval,
3298 filter->priv->virtual_root);
3299 gtk_tree_path_free (retval);
3308 gtk_tree_model_filter_refilter_helper (GtkTreeModel *model,
3313 /* evil, don't try this at home, but certainly speeds things up */
3314 gtk_tree_model_filter_row_changed (model, path, iter, data);
3320 * gtk_tree_model_filter_refilter:
3321 * @filter: A #GtkTreeModelFilter.
3323 * Emits ::row_changed for each row in the child model, which causes
3324 * the filter to re-evaluate whether a row is visible or not.
3329 gtk_tree_model_filter_refilter (GtkTreeModelFilter *filter)
3331 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (filter));
3334 gtk_tree_model_foreach (filter->priv->child_model,
3335 gtk_tree_model_filter_refilter_helper,
3340 * gtk_tree_model_filter_clear_cache:
3341 * @filter: A #GtkTreeModelFilter.
3343 * This function should almost never be called. It clears the @filter
3344 * of any cached iterators that haven't been reffed with
3345 * gtk_tree_model_ref_node(). This might be useful if the child model
3346 * being filtered is static (and doesn't change often) and there has been
3347 * a lot of unreffed access to nodes. As a side effect of this function,
3348 * all unreffed itters will be invalid.
3353 gtk_tree_model_filter_clear_cache (GtkTreeModelFilter *filter)
3355 g_return_if_fail (GTK_IS_TREE_MODEL_FILTER (filter));
3357 if (filter->priv->zero_ref_count > 0)
3358 gtk_tree_model_filter_clear_cache_helper (filter,
3359 FILTER_LEVEL (filter->priv->root));
3362 #define __GTK_TREE_MODEL_FILTER_C__
3363 #include "gtkaliasdef.c"