2000-10-05 01:04:57 +00:00
|
|
|
/* gtktreestore.h
|
|
|
|
* Copyright (C) 2000 Red Hat, Inc., Jonathan Blandford <jrb@redhat.com>
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Library General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Library General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Library General Public
|
2012-02-27 13:01:10 +00:00
|
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
2000-10-05 01:04:57 +00:00
|
|
|
*/
|
|
|
|
|
2012-12-28 14:57:34 +00:00
|
|
|
#ifndef __GTK_TREE_STORE_H__
|
|
|
|
#define __GTK_TREE_STORE_H__
|
|
|
|
|
2009-10-21 18:30:04 +00:00
|
|
|
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
2008-05-28 15:07:04 +00:00
|
|
|
#error "Only <gtk/gtk.h> can be included directly."
|
|
|
|
#endif
|
|
|
|
|
2010-12-09 04:07:00 +00:00
|
|
|
#include <gdk/gdk.h>
|
2000-10-05 01:04:57 +00:00
|
|
|
#include <gtk/gtktreemodel.h>
|
2001-04-01 05:52:23 +00:00
|
|
|
#include <gtk/gtktreesortable.h>
|
2000-10-26 00:36:47 +00:00
|
|
|
#include <stdarg.h>
|
2000-10-05 01:04:57 +00:00
|
|
|
|
2005-06-21 05:35:43 +00:00
|
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
2000-10-05 01:04:57 +00:00
|
|
|
|
|
|
|
#define GTK_TYPE_TREE_STORE (gtk_tree_store_get_type ())
|
2002-10-10 22:20:48 +00:00
|
|
|
#define GTK_TREE_STORE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_TREE_STORE, GtkTreeStore))
|
|
|
|
#define GTK_TREE_STORE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_TREE_STORE, GtkTreeStoreClass))
|
|
|
|
#define GTK_IS_TREE_STORE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TREE_STORE))
|
|
|
|
#define GTK_IS_TREE_STORE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_TREE_STORE))
|
|
|
|
#define GTK_TREE_STORE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_TREE_STORE, GtkTreeStoreClass))
|
2000-10-05 01:04:57 +00:00
|
|
|
|
2010-12-18 02:45:20 +00:00
|
|
|
typedef struct _GtkTreeStore GtkTreeStore;
|
|
|
|
typedef struct _GtkTreeStoreClass GtkTreeStoreClass;
|
|
|
|
typedef struct _GtkTreeStorePrivate GtkTreeStorePrivate;
|
2000-10-05 01:04:57 +00:00
|
|
|
|
|
|
|
struct _GtkTreeStore
|
|
|
|
{
|
2001-02-21 23:49:22 +00:00
|
|
|
GObject parent;
|
2000-10-26 00:36:47 +00:00
|
|
|
|
2010-12-18 02:45:20 +00:00
|
|
|
GtkTreeStorePrivate *priv;
|
2000-10-05 01:04:57 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
struct _GtkTreeStoreClass
|
|
|
|
{
|
2001-02-21 23:49:22 +00:00
|
|
|
GObjectClass parent_class;
|
2002-02-23 20:22:05 +00:00
|
|
|
|
|
|
|
/* Padding for future expansion */
|
|
|
|
void (*_gtk_reserved1) (void);
|
|
|
|
void (*_gtk_reserved2) (void);
|
|
|
|
void (*_gtk_reserved3) (void);
|
|
|
|
void (*_gtk_reserved4) (void);
|
2000-10-05 01:04:57 +00:00
|
|
|
};
|
|
|
|
|
Fix GtkTreeNode *node ->GtkTreeNode node issue.
2000-10-15 <jrb@redhat.com>
* gtk/gtktreeview.c, gtk/gtktreeview.h, gtk/gtktreestore.h,
gtk/gtktreestore.c, gtk/gtkliststore.h, gtk/gtkliststore.c,
gtk/gtkmodelsimple.c, gtk/gtkmodelsimple.h, gtk/gtktreedatalist.c,
gtk/gtktreemodel.h, gtk/gtktreeselection.c,
gtk/gtktreeselection.h: Fix GtkTreeNode *node ->GtkTreeNode node
issue.
2000-10-15 17:46:23 +00:00
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-11-23 20:02:15 +00:00
|
|
|
GType gtk_tree_store_get_type (void) G_GNUC_CONST;
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
GtkTreeStore *gtk_tree_store_new (gint n_columns,
|
|
|
|
...);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
GtkTreeStore *gtk_tree_store_newv (gint n_columns,
|
|
|
|
GType *types);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_set_column_types (GtkTreeStore *tree_store,
|
|
|
|
gint n_columns,
|
|
|
|
GType *types);
|
2002-02-09 01:28:00 +00:00
|
|
|
|
|
|
|
/* NOTE: use gtk_tree_model_get to get values from a GtkTreeStore */
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_set_value (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
gint column,
|
|
|
|
GValue *value);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_set (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
...);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2007-06-04 23:48:38 +00:00
|
|
|
void gtk_tree_store_set_valuesv (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
gint *columns,
|
|
|
|
GValue *values,
|
|
|
|
gint n_values);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_set_valist (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
va_list var_args);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2002-06-04 17:17:49 +00:00
|
|
|
gboolean gtk_tree_store_remove (GtkTreeStore *tree_store,
|
2001-11-14 02:06:28 +00:00
|
|
|
GtkTreeIter *iter);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_insert (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *parent,
|
|
|
|
gint position);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_insert_before (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *parent,
|
|
|
|
GtkTreeIter *sibling);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_insert_after (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *parent,
|
|
|
|
GtkTreeIter *sibling);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2006-01-15 20:12:49 +00:00
|
|
|
void gtk_tree_store_insert_with_values (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *parent,
|
|
|
|
gint position,
|
|
|
|
...);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2006-01-15 20:12:49 +00:00
|
|
|
void gtk_tree_store_insert_with_valuesv (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *parent,
|
|
|
|
gint position,
|
|
|
|
gint *columns,
|
|
|
|
GValue *values,
|
|
|
|
gint n_values);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_prepend (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *parent);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_append (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *parent);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
gboolean gtk_tree_store_is_ancestor (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *descendant);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
gint gtk_tree_store_iter_depth (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_tree_store_clear (GtkTreeStore *tree_store);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2002-06-04 17:17:49 +00:00
|
|
|
gboolean gtk_tree_store_iter_is_valid (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
API additions: _move, _reorder and _swap for stores, path constructor.
Fri Jul 26 22:53:37 2002 Kristian Rietveld <kris@gtk.org>
API additions: _move, _reorder and _swap for stores, path
constructor.
* gtk/gtktreemodel.[ch] (gtk_tree_path_new_from_indices): new function.
* gtk/gtkliststore.[ch]: added gtk_list_store_reorder_func (private),
gtk_list_store_reorder, gtk_list_store_swap, gtk_list_store_move.
* gtk/gtktreestore.[ch]: added gtk_tree_store_reorder_func (private),
gtk_tree_store_reorder, gtk_tree_store_swap, gtk_tree_store_move.
Fri Jul 26 22:32:57 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreestore.c (node_free): return FALSE,
(gtk_tree_store_finalize): use g_node_traverse instead of
g_node_children_foreach, so the whole tree will be freed (#88854,
patch from Emmanuel Briot).
Fri Jul 26 22:32:24 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreeview.c (gtk_tree_view_button_press): fix some memleaks,
(#84426, patch from Matthias Clasen).
Fri Jul 26 22:31:25 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreeview.c (gtk_tree_view_unref_tree_helper): _iter_children
check shouldn't be in g_return_return_val_if_fail (pointed out by
Josh Green, #88997),
(gtk_tree_view_set_model): call _gtk_tree_view_column_unset_model
for each column when we unset the model (part of #82484),
(gtk_tree_view_get_cell_area): return if we ran out of tree or
if we got an invalid path (#82376).
* gtk/gtktreeprivate.h: add _gtk_tree_view_column_unset_model.
* gtk/gtktreeviewcolumn.c: implement _gtk_tree_view_column_unset_model
which disconnects the sort_column_changed_signal (part of #82484).
* gtk/gtkliststore.c (gtk_list_store_insert): append row if the
given postion is off the end of the tree (#85813).
* gtk/gtkentry.c (gtk_cell_editable_key_press_event): let's use
2-space indent, commit changes if up/down keys has been pressed,
this overrides the focus key foo so the user won't be surprised
(#84665).
2002-07-26 20:51:13 +00:00
|
|
|
void gtk_tree_store_reorder (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *parent,
|
|
|
|
gint *new_order);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2002-10-10 23:42:57 +00:00
|
|
|
void gtk_tree_store_swap (GtkTreeStore *tree_store,
|
API additions: _move, _reorder and _swap for stores, path constructor.
Fri Jul 26 22:53:37 2002 Kristian Rietveld <kris@gtk.org>
API additions: _move, _reorder and _swap for stores, path
constructor.
* gtk/gtktreemodel.[ch] (gtk_tree_path_new_from_indices): new function.
* gtk/gtkliststore.[ch]: added gtk_list_store_reorder_func (private),
gtk_list_store_reorder, gtk_list_store_swap, gtk_list_store_move.
* gtk/gtktreestore.[ch]: added gtk_tree_store_reorder_func (private),
gtk_tree_store_reorder, gtk_tree_store_swap, gtk_tree_store_move.
Fri Jul 26 22:32:57 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreestore.c (node_free): return FALSE,
(gtk_tree_store_finalize): use g_node_traverse instead of
g_node_children_foreach, so the whole tree will be freed (#88854,
patch from Emmanuel Briot).
Fri Jul 26 22:32:24 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreeview.c (gtk_tree_view_button_press): fix some memleaks,
(#84426, patch from Matthias Clasen).
Fri Jul 26 22:31:25 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreeview.c (gtk_tree_view_unref_tree_helper): _iter_children
check shouldn't be in g_return_return_val_if_fail (pointed out by
Josh Green, #88997),
(gtk_tree_view_set_model): call _gtk_tree_view_column_unset_model
for each column when we unset the model (part of #82484),
(gtk_tree_view_get_cell_area): return if we ran out of tree or
if we got an invalid path (#82376).
* gtk/gtktreeprivate.h: add _gtk_tree_view_column_unset_model.
* gtk/gtktreeviewcolumn.c: implement _gtk_tree_view_column_unset_model
which disconnects the sort_column_changed_signal (part of #82484).
* gtk/gtkliststore.c (gtk_list_store_insert): append row if the
given postion is off the end of the tree (#85813).
* gtk/gtkentry.c (gtk_cell_editable_key_press_event): let's use
2-space indent, commit changes if up/down keys has been pressed,
this overrides the focus key foo so the user won't be surprised
(#84665).
2002-07-26 20:51:13 +00:00
|
|
|
GtkTreeIter *a,
|
|
|
|
GtkTreeIter *b);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2002-11-18 19:33:28 +00:00
|
|
|
void gtk_tree_store_move_before (GtkTreeStore *tree_store,
|
API additions: _move, _reorder and _swap for stores, path constructor.
Fri Jul 26 22:53:37 2002 Kristian Rietveld <kris@gtk.org>
API additions: _move, _reorder and _swap for stores, path
constructor.
* gtk/gtktreemodel.[ch] (gtk_tree_path_new_from_indices): new function.
* gtk/gtkliststore.[ch]: added gtk_list_store_reorder_func (private),
gtk_list_store_reorder, gtk_list_store_swap, gtk_list_store_move.
* gtk/gtktreestore.[ch]: added gtk_tree_store_reorder_func (private),
gtk_tree_store_reorder, gtk_tree_store_swap, gtk_tree_store_move.
Fri Jul 26 22:32:57 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreestore.c (node_free): return FALSE,
(gtk_tree_store_finalize): use g_node_traverse instead of
g_node_children_foreach, so the whole tree will be freed (#88854,
patch from Emmanuel Briot).
Fri Jul 26 22:32:24 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreeview.c (gtk_tree_view_button_press): fix some memleaks,
(#84426, patch from Matthias Clasen).
Fri Jul 26 22:31:25 2002 Kristian Rietveld <kris@gtk.org>
Merge from stable:
* gtk/gtktreeview.c (gtk_tree_view_unref_tree_helper): _iter_children
check shouldn't be in g_return_return_val_if_fail (pointed out by
Josh Green, #88997),
(gtk_tree_view_set_model): call _gtk_tree_view_column_unset_model
for each column when we unset the model (part of #82484),
(gtk_tree_view_get_cell_area): return if we ran out of tree or
if we got an invalid path (#82376).
* gtk/gtktreeprivate.h: add _gtk_tree_view_column_unset_model.
* gtk/gtktreeviewcolumn.c: implement _gtk_tree_view_column_unset_model
which disconnects the sort_column_changed_signal (part of #82484).
* gtk/gtkliststore.c (gtk_list_store_insert): append row if the
given postion is off the end of the tree (#85813).
* gtk/gtkentry.c (gtk_cell_editable_key_press_event): let's use
2-space indent, commit changes if up/down keys has been pressed,
this overrides the focus key foo so the user won't be surprised
(#84665).
2002-07-26 20:51:13 +00:00
|
|
|
GtkTreeIter *iter,
|
2002-11-18 19:33:28 +00:00
|
|
|
GtkTreeIter *position);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2002-11-18 19:33:28 +00:00
|
|
|
void gtk_tree_store_move_after (GtkTreeStore *tree_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *position);
|
2001-11-14 02:06:28 +00:00
|
|
|
|
2000-10-05 01:04:57 +00:00
|
|
|
|
2005-06-21 05:35:43 +00:00
|
|
|
G_END_DECLS
|
2000-10-05 01:04:57 +00:00
|
|
|
|
|
|
|
|
|
|
|
#endif /* __GTK_TREE_STORE_H__ */
|