]> Pileus Git - ~andy/gtk/blob - gtk/gtktreemodelfilter.h
Landing GtkTreeModelFilter and the completion code. (Test program and
[~andy/gtk] / gtk / gtktreemodelfilter.h
1 /* gtktreemodelfilter.h
2  * Copyright (C) 2000,2001  Red Hat, Inc., Jonathan Blandford <jrb@redhat.com>
3  * Copyright (C) 2001-2003  Kristian Rietveld <kris@gtk.org>
4  *
5  * This program is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU General Public License as
7  * published by the Free Software Foundation; either version 2 of the
8  * License, or (at your option) any later version.
9  *
10  * This program 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  * General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public
16  * License along with this program; if not, write to the
17  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18  * Boston, MA 02111-1307, USA.
19  */
20
21 #ifndef __GTK_TREE_MODEL_FILTER_H__
22 #define __GTK_TREE_MODEL_FILTER_H__
23
24 #include <gtk/gtktreemodel.h>
25
26 G_BEGIN_DECLS
27
28 #define GTK_TYPE_TREE_MODEL_FILTER              (gtk_tree_model_filter_get_type ())
29 #define GTK_TREE_MODEL_FILTER(obj)              (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_TREE_MODEL_FILTER, GtkTreeModelFilter))
30 #define GTK_TREE_MODEL_FILTER_CLASS(vtable)     (G_TYPE_CHECK_CLASS_CAST ((vtable), GTK_TYPE_TREE_MODEL_FILTER, GtkTreeModelFilterClass))
31 #define GTK_IS_TREE_MODEL_FILTER(obj)           (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TREE_MODEL_FILTER))
32 #define GTK_IS_TREE_MODEL_FILTER_CLASS(vtable)  (G_TYPE_CHECK_CLASS_TYPE ((vtable), GTK_TYPE_TREE_MODEL_FILTER))
33 #define GTK_TREE_MODEL_FILTER_GET_CLASS(inst)   (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_TREE_MODEL_FILTER, GtkTreeModelFilterClass))
34 #define GTK_TREE_MODEL_FILTER_GET_PRIVATE(obj)  (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_TREE_MODEL_FILTER, GtkTreeModelFilterPrivate))
35
36 typedef gboolean (* GtkTreeModelFilterVisibleFunc) (GtkTreeModel *model,
37                                                     GtkTreeIter  *iter,
38                                                     gpointer      data);
39 typedef void (* GtkTreeModelFilterModifyFunc) (GtkTreeModel *model,
40                                                GtkTreeIter  *iter,
41                                                GValue       *value,
42                                                gint          column,
43                                                gpointer      data);
44
45 typedef struct _GtkTreeModelFilter          GtkTreeModelFilter;
46 typedef struct _GtkTreeModelFilterClass     GtkTreeModelFilterClass;
47 typedef struct _GtkTreeModelFilterPrivate   GtkTreeModelFilterPrivate;
48
49 struct _GtkTreeModelFilter
50 {
51   GObject parent;
52
53   /*< private >*/
54   GtkTreeModelFilterPrivate *priv;
55 };
56
57 struct _GtkTreeModelFilterClass
58 {
59   GObjectClass parent_class;
60 };
61
62 /* base */
63 GType         gtk_tree_model_filter_get_type                   (void);
64 GtkTreeModel *gtk_tree_model_filter_new                        (GtkTreeModel                 *child_model,
65                                                                 GtkTreePath                  *root);
66 void          gtk_tree_model_filter_set_visible_func           (GtkTreeModelFilter           *filter,
67                                                                 GtkTreeModelFilterVisibleFunc func,
68                                                                 gpointer                      data,
69                                                                 GtkDestroyNotify              destroy);
70 void          gtk_tree_model_filter_set_modify_func            (GtkTreeModelFilter           *filter,
71                                                                 gint                          n_columns,
72                                                                 GType                        *types,
73                                                                 GtkTreeModelFilterModifyFunc  func,
74                                                                 gpointer                      data,
75                                                                 GtkDestroyNotify              destroy);
76 void          gtk_tree_model_filter_set_visible_column         (GtkTreeModelFilter           *filter,
77                                                                 gint                          column);
78
79 GtkTreeModel *gtk_tree_model_filter_get_model                  (GtkTreeModelFilter           *filter);
80
81 /* conversion */
82 void          gtk_tree_model_filter_convert_child_iter_to_iter (GtkTreeModelFilter           *filter,
83                                                                 GtkTreeIter                  *filter_iter,
84                                                                 GtkTreeIter                  *child_iter);
85 void          gtk_tree_model_filter_convert_iter_to_child_iter (GtkTreeModelFilter           *filter,
86                                                                 GtkTreeIter                  *child_iter,
87                                                                 GtkTreeIter                  *filter_iter);
88 GtkTreePath  *gtk_tree_model_filter_convert_child_path_to_path (GtkTreeModelFilter           *filter,
89                                                                 GtkTreePath                  *child_path);
90 GtkTreePath  *gtk_tree_model_filter_convert_path_to_child_path (GtkTreeModelFilter           *path,
91                                                                 GtkTreePath                  *filter_path);
92
93 /* extras */
94 void          gtk_tree_model_filter_refilter                   (GtkTreeModelFilter           *filter);
95 void          gtk_tree_model_filter_clear_cache                (GtkTreeModelFilter           *filter);
96
97 G_END_DECLS
98
99 #endif /* __GTK_TREE_MODEL_FILTER_H__ */