/* gtktreemodel.h * Copyright (C) 2000 Red Hat, Inc., Jonathan Blandford * * 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 * License along with this library. If not, see . */ #ifndef __GTK_TREE_MODEL_H__ #define __GTK_TREE_MODEL_H__ #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) #error "Only can be included directly." #endif #include #include G_BEGIN_DECLS #define GTK_TYPE_TREE_MODEL (gtk_tree_model_get_type ()) #define GTK_TREE_MODEL(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_TREE_MODEL, GtkTreeModel)) #define GTK_IS_TREE_MODEL(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TREE_MODEL)) #define GTK_TREE_MODEL_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), GTK_TYPE_TREE_MODEL, GtkTreeModelIface)) #define GTK_TYPE_TREE_ITER (gtk_tree_iter_get_type ()) #define GTK_TYPE_TREE_PATH (gtk_tree_path_get_type ()) #define GTK_TYPE_TREE_ROW_REFERENCE (gtk_tree_row_reference_get_type ()) typedef struct _GtkTreeIter GtkTreeIter; typedef struct _GtkTreePath GtkTreePath; typedef struct _GtkTreeRowReference GtkTreeRowReference; typedef struct _GtkTreeModel GtkTreeModel; /* Dummy typedef */ typedef struct _GtkTreeModelIface GtkTreeModelIface; /** * GtkTreeModelForeachFunc: * @model: the `GtkTreeModel` being iterated * @path: the current `GtkTreePath` * @iter: the current `GtkTreeIter` * @data: (closure): The user data passed to gtk_tree_model_foreach() * * Type of the callback passed to gtk_tree_model_foreach() to * iterate over the rows in a tree model. * * Returns: %TRUE to stop iterating, %FALSE to continue * */ typedef gboolean (* GtkTreeModelForeachFunc) (GtkTreeModel *model, GtkTreePath *path, GtkTreeIter *iter, gpointer data); /** * GtkTreeModelFlags: * @GTK_TREE_MODEL_ITERS_PERSIST: iterators survive all signals * emitted by the tree * @GTK_TREE_MODEL_LIST_ONLY: the model is a list only, and never * has children * * These flags indicate various properties of a `GtkTreeModel`. * * They are returned by [method@Gtk.TreeModel.get_flags], and must be * static for the lifetime of the object. A more complete description * of %GTK_TREE_MODEL_ITERS_PERSIST can be found in the overview of * this section. */ typedef enum { GTK_TREE_MODEL_ITERS_PERSIST = 1 << 0, GTK_TREE_MODEL_LIST_ONLY = 1 << 1 } GtkTreeModelFlags; /** * GtkTreeIter: * @stamp: a unique stamp to catch invalid iterators * @user_data: model-specific data * @user_data2: model-specific data * @user_data3: model-specific data * * The `GtkTreeIter` is the primary structure * for accessing a `GtkTreeModel`. Models are expected to put a unique * integer in the @stamp member, and put * model-specific data in the three @user_data * members. */ struct _GtkTreeIter { int stamp; gpointer user_data; gpointer user_data2; gpointer user_data3; }; /** * GtkTreeModelIface: * @row_changed: Signal emitted when a row in the model has changed. * @row_inserted: Signal emitted when a new row has been inserted in * the model. * @row_has_child_toggled: Signal emitted when a row has gotten the * first child row or lost its last child row. * @row_deleted: Signal emitted when a row has been deleted. * @rows_reordered: Signal emitted when the children of a node in the * GtkTreeModel have been reordered. * @get_flags: Get `GtkTreeModelFlags` supported by this interface. * @get_n_columns: Get the number of columns supported by the model. * @get_column_type: Get the type of the column. * @get_iter: Sets iter to a valid iterator pointing to path. * @get_path: Gets a newly-created `GtkTreePath` referenced by iter. * @get_value: Initializes and sets value to that at column. * @iter_next: Sets iter to point to the node following it at the * current level. * @iter_previous: Sets iter to point to the previous node at the * current level. * @iter_children: Sets iter to point to the first child of parent. * @iter_has_child: %TRUE if iter has children, %FALSE otherwise. * @iter_n_children: Gets the number of children that iter has. * @iter_nth_child: Sets iter to be the child of parent, using the * given index. * @iter_parent: Sets iter to be the parent of child. * @ref_node: Lets the tree ref the node. * @unref_node: Lets the tree unref the node. */ struct _GtkTreeModelIface { /*< private >*/ GTypeInterface g_iface; /*< public >*/ /* Signals */ void (* row_changed) (GtkTreeModel *tree_model, GtkTreePath *path, GtkTreeIter *iter); void (* row_inserted) (GtkTreeModel *tree_model, GtkTreePath *path, GtkTreeIter *iter); void (* row_has_child_toggled) (GtkTreeModel *tree_model, GtkTreePath *path, GtkTreeIter *iter); void (* row_deleted) (GtkTreeModel *tree_model, GtkTreePath *path); void (* rows_reordered) (GtkTreeModel *tree_model, GtkTreePath *path, GtkTreeIter *iter, int *new_order); /* Virtual Table */ GtkTreeModelFlags (* get_flags) (GtkTreeModel *tree_model); int (* get_n_columns) (GtkTreeModel *tree_model); GType (* get_column_type) (GtkTreeModel *tree_model, int index_); gboolean (* get_iter) (GtkTreeModel *tree_model, GtkTreeIter *iter, GtkTreePath *path); GtkTreePath *(* get_path) (GtkTreeModel *tree_model, GtkTreeIter *iter); void (* get_value) (GtkTreeModel *tree_model, GtkTreeIter *iter, int column, GValue *value); gboolean (* iter_next) (GtkTreeModel *tree_model, GtkTreeIter *iter); gboolean (* iter_previous) (GtkTreeModel *tree_model, GtkTreeIter *iter); gboolean (* iter_children) (GtkTreeModel *tree_model, GtkTreeIter *iter, GtkTreeIter *parent); gboolean (* iter_has_child) (GtkTreeModel *tree_model, GtkTreeIter *iter); int (* iter_n_children) (GtkTreeModel *tree_model, GtkTreeIter *iter); gboolean (* iter_nth_child) (GtkTreeModel *tree_model, GtkTreeIter *iter, GtkTreeIter *parent, int n); gboolean (* iter_parent) (GtkTreeModel *tree_model, GtkTreeIter *iter, GtkTreeIter *child); void (* ref_node) (GtkTreeModel *tree_model, GtkTreeIter *iter); void (* unref_node) (GtkTreeModel *tree_model, GtkTreeIter *iter); }; /* GtkTreePath operations */ GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreePath *gtk_tree_path_new (void); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreePath *gtk_tree_path_new_from_string (const char *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreePath *gtk_tree_path_new_from_indices (int first_index, ...); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreePath *gtk_tree_path_new_from_indicesv (int *indices, gsize length); GDK_DEPRECATED_IN_4_10_FOR(GListModel) char *gtk_tree_path_to_string (GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreePath *gtk_tree_path_new_first (void); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_path_append_index (GtkTreePath *path, int index_); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_path_prepend_index (GtkTreePath *path, int index_); GDK_DEPRECATED_IN_4_10_FOR(GListModel) int gtk_tree_path_get_depth (GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) int *gtk_tree_path_get_indices (GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) int *gtk_tree_path_get_indices_with_depth (GtkTreePath *path, int *depth); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_path_free (GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreePath *gtk_tree_path_copy (const GtkTreePath *path); GDK_AVAILABLE_IN_ALL GType gtk_tree_path_get_type (void) G_GNUC_CONST; GDK_DEPRECATED_IN_4_10_FOR(GListModel) int gtk_tree_path_compare (const GtkTreePath *a, const GtkTreePath *b); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_path_next (GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_path_prev (GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_path_up (GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_path_down (GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_path_is_ancestor (GtkTreePath *path, GtkTreePath *descendant); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_path_is_descendant (GtkTreePath *path, GtkTreePath *ancestor); /** * GtkTreeRowReference: * * A GtkTreeRowReference tracks model changes so that it always refers to the * same row (a `GtkTreePath` refers to a position, not a fixed row). Create a * new GtkTreeRowReference with gtk_tree_row_reference_new(). */ GDK_AVAILABLE_IN_ALL GType gtk_tree_row_reference_get_type (void) G_GNUC_CONST; GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreeRowReference *gtk_tree_row_reference_new (GtkTreeModel *model, GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreeRowReference *gtk_tree_row_reference_new_proxy (GObject *proxy, GtkTreeModel *model, GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreePath *gtk_tree_row_reference_get_path (GtkTreeRowReference *reference); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreeModel *gtk_tree_row_reference_get_model (GtkTreeRowReference *reference); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_row_reference_valid (GtkTreeRowReference *reference); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreeRowReference *gtk_tree_row_reference_copy (GtkTreeRowReference *reference); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_row_reference_free (GtkTreeRowReference *reference); /* These two functions are only needed if you created the row reference with a * proxy object */ GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_row_reference_inserted (GObject *proxy, GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_row_reference_deleted (GObject *proxy, GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_row_reference_reordered (GObject *proxy, GtkTreePath *path, GtkTreeIter *iter, int *new_order); /* GtkTreeIter operations */ GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreeIter * gtk_tree_iter_copy (GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_iter_free (GtkTreeIter *iter); GDK_AVAILABLE_IN_ALL GType gtk_tree_iter_get_type (void) G_GNUC_CONST; GDK_AVAILABLE_IN_ALL GType gtk_tree_model_get_type (void) G_GNUC_CONST; GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreeModelFlags gtk_tree_model_get_flags (GtkTreeModel *tree_model); GDK_DEPRECATED_IN_4_10_FOR(GListModel) int gtk_tree_model_get_n_columns (GtkTreeModel *tree_model); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GType gtk_tree_model_get_column_type (GtkTreeModel *tree_model, int index_); /* Iterator movement */ GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_model_get_iter (GtkTreeModel *tree_model, GtkTreeIter *iter, GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_model_get_iter_from_string (GtkTreeModel *tree_model, GtkTreeIter *iter, const char *path_string); GDK_DEPRECATED_IN_4_10_FOR(GListModel) char * gtk_tree_model_get_string_from_iter (GtkTreeModel *tree_model, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_model_get_iter_first (GtkTreeModel *tree_model, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) GtkTreePath * gtk_tree_model_get_path (GtkTreeModel *tree_model, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_get_value (GtkTreeModel *tree_model, GtkTreeIter *iter, int column, GValue *value); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_model_iter_previous (GtkTreeModel *tree_model, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_model_iter_next (GtkTreeModel *tree_model, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_model_iter_children (GtkTreeModel *tree_model, GtkTreeIter *iter, GtkTreeIter *parent); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_model_iter_has_child (GtkTreeModel *tree_model, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) int gtk_tree_model_iter_n_children (GtkTreeModel *tree_model, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_model_iter_nth_child (GtkTreeModel *tree_model, GtkTreeIter *iter, GtkTreeIter *parent, int n); GDK_DEPRECATED_IN_4_10_FOR(GListModel) gboolean gtk_tree_model_iter_parent (GtkTreeModel *tree_model, GtkTreeIter *iter, GtkTreeIter *child); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_ref_node (GtkTreeModel *tree_model, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_unref_node (GtkTreeModel *tree_model, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_get (GtkTreeModel *tree_model, GtkTreeIter *iter, ...); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_get_valist (GtkTreeModel *tree_model, GtkTreeIter *iter, va_list var_args); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_foreach (GtkTreeModel *model, GtkTreeModelForeachFunc func, gpointer user_data); /* Signals */ GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_row_changed (GtkTreeModel *tree_model, GtkTreePath *path, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_row_inserted (GtkTreeModel *tree_model, GtkTreePath *path, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_row_has_child_toggled (GtkTreeModel *tree_model, GtkTreePath *path, GtkTreeIter *iter); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_row_deleted (GtkTreeModel *tree_model, GtkTreePath *path); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_rows_reordered (GtkTreeModel *tree_model, GtkTreePath *path, GtkTreeIter *iter, int *new_order); GDK_DEPRECATED_IN_4_10_FOR(GListModel) void gtk_tree_model_rows_reordered_with_length (GtkTreeModel *tree_model, GtkTreePath *path, GtkTreeIter *iter, int *new_order, int length); G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkTreeModel, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkTreeIter, gtk_tree_iter_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkTreePath, gtk_tree_path_free) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkTreeRowReference, gtk_tree_row_reference_free) G_END_DECLS #endif /* __GTK_TREE_MODEL_H__ */