2000-10-05 01:04:57 +00:00
|
|
|
/* gtkliststore.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_LIST_STORE_H__
|
|
|
|
#define __GTK_LIST_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
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
#include <gdk/gdk.h>
|
2000-10-05 01:04:57 +00:00
|
|
|
#include <gtk/gtktreemodel.h>
|
2001-03-23 00:35:19 +00:00
|
|
|
#include <gtk/gtktreesortable.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_LIST_STORE (gtk_list_store_get_type ())
|
2002-10-07 19:10:39 +00:00
|
|
|
#define GTK_LIST_STORE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_LIST_STORE, GtkListStore))
|
|
|
|
#define GTK_LIST_STORE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_LIST_STORE, GtkListStoreClass))
|
|
|
|
#define GTK_IS_LIST_STORE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_LIST_STORE))
|
|
|
|
#define GTK_IS_LIST_STORE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_LIST_STORE))
|
|
|
|
#define GTK_LIST_STORE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_LIST_STORE, GtkListStoreClass))
|
2000-10-05 01:04:57 +00:00
|
|
|
|
2010-08-26 17:15:37 +00:00
|
|
|
typedef struct _GtkListStore GtkListStore;
|
|
|
|
typedef struct _GtkListStorePrivate GtkListStorePrivate;
|
|
|
|
typedef struct _GtkListStoreClass GtkListStoreClass;
|
2000-10-05 01:04:57 +00:00
|
|
|
|
|
|
|
struct _GtkListStore
|
|
|
|
{
|
2001-02-21 23:49:22 +00:00
|
|
|
GObject parent;
|
2000-10-05 01:04:57 +00:00
|
|
|
|
|
|
|
/*< private >*/
|
2010-08-26 17:15:37 +00:00
|
|
|
GtkListStorePrivate *priv;
|
2000-10-05 01:04:57 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
struct _GtkListStoreClass
|
|
|
|
{
|
2001-02-21 23:49:22 +00:00
|
|
|
GObjectClass parent_class;
|
2002-02-23 20:22:05 +00:00
|
|
|
|
2019-05-29 02:23:08 +00:00
|
|
|
/*< private >*/
|
|
|
|
gpointer padding[8];
|
2000-10-05 01:04:57 +00:00
|
|
|
};
|
|
|
|
|
2000-10-27 23:34:58 +00:00
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-11-23 20:02:15 +00:00
|
|
|
GType gtk_list_store_get_type (void) G_GNUC_CONST;
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2020-07-24 13:54:49 +00:00
|
|
|
GtkListStore *gtk_list_store_new (int n_columns,
|
2001-11-14 02:06:28 +00:00
|
|
|
...);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2020-07-24 13:54:49 +00:00
|
|
|
GtkListStore *gtk_list_store_newv (int n_columns,
|
2001-11-14 02:06:28 +00:00
|
|
|
GType *types);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_list_store_set_column_types (GtkListStore *list_store,
|
2020-07-24 13:54:49 +00:00
|
|
|
int n_columns,
|
2001-11-14 02:06:28 +00:00
|
|
|
GType *types);
|
2002-02-09 01:28:00 +00:00
|
|
|
|
|
|
|
/* NOTE: use gtk_tree_model_get to get values from a GtkListStore */
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_list_store_set_value (GtkListStore *list_store,
|
|
|
|
GtkTreeIter *iter,
|
2020-07-24 13:54:49 +00:00
|
|
|
int column,
|
2001-11-14 02:06:28 +00:00
|
|
|
GValue *value);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_list_store_set (GtkListStore *list_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_list_store_set_valuesv (GtkListStore *list_store,
|
|
|
|
GtkTreeIter *iter,
|
2020-07-24 13:54:49 +00:00
|
|
|
int *columns,
|
2007-06-04 23:48:38 +00:00
|
|
|
GValue *values,
|
2020-07-24 13:54:49 +00:00
|
|
|
int n_values);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_list_store_set_valist (GtkListStore *list_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_list_store_remove (GtkListStore *list_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_list_store_insert (GtkListStore *list_store,
|
|
|
|
GtkTreeIter *iter,
|
2020-07-24 13:54:49 +00:00
|
|
|
int position);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_list_store_insert_before (GtkListStore *list_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *sibling);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_list_store_insert_after (GtkListStore *list_store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *sibling);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-12-09 06:21:39 +00:00
|
|
|
void gtk_list_store_insert_with_values (GtkListStore *list_store,
|
|
|
|
GtkTreeIter *iter,
|
2020-07-24 13:54:49 +00:00
|
|
|
int position,
|
2004-12-09 06:21:39 +00:00
|
|
|
...);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-12-09 06:21:39 +00:00
|
|
|
void gtk_list_store_insert_with_valuesv (GtkListStore *list_store,
|
|
|
|
GtkTreeIter *iter,
|
2020-07-24 13:54:49 +00:00
|
|
|
int position,
|
|
|
|
int *columns,
|
2004-12-09 06:21:39 +00:00
|
|
|
GValue *values,
|
2020-07-24 13:54:49 +00:00
|
|
|
int n_values);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-11-14 02:06:28 +00:00
|
|
|
void gtk_list_store_prepend (GtkListStore *list_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_list_store_append (GtkListStore *list_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_list_store_clear (GtkListStore *list_store);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2002-06-04 17:17:49 +00:00
|
|
|
gboolean gtk_list_store_iter_is_valid (GtkListStore *list_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_list_store_reorder (GtkListStore *store,
|
2020-07-24 13:54:49 +00:00
|
|
|
int *new_order);
|
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_list_store_swap (GtkListStore *store,
|
|
|
|
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_list_store_move_after (GtkListStore *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_list_store_move_before (GtkListStore *store,
|
|
|
|
GtkTreeIter *iter,
|
|
|
|
GtkTreeIter *position);
|
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_LIST_STORE_H__ */
|