2001-10-26 Christopher James Lahey <clahey@ximian.com> * e-cell-checkbox.c, e-cell-checkbox.h, e-cell-combo.c, e-cell-combo.h, e-cell-date.c, e-cell-date.h, e-cell-number.c, e-cell-number.h, e-cell-pixbuf.c, e-cell-pixbuf.h, e-cell-popup.c, e-cell-popup.h, e-cell-size.c, e-cell-size.h, e-cell-spin-button.c, e-cell-spin-button.h, e-cell-string.c, e-cell-text.c, e-cell-text.h, e-cell-toggle.c, e-cell-toggle.h, e-cell-tree.c, e-cell-tree.h, e-cell.c, e-cell.h, e-table-click-to-add.c, e-table-click-to-add.h, e-table-col-dnd.h, e-table-col.c, e-table-col.h, e-table-column-specification.c, e-table-column-specification.h, e-table-column.c, e-table-config-field.c, e-table-config-field.h, e-table-config.c, e-table-config.h, e-table-defines.h, e-table-example-1.c, e-table-example-2.c, e-table-extras.c, e-table-extras.h, e-table-field-chooser-dialog.c, e-table-field-chooser-dialog.h, e-table-field-chooser-item.c, e-table-field-chooser-item.h, e-table-field-chooser.c, e-table-field-chooser.h, e-table-group-container.c, e-table-group-container.h, e-table-group-leaf.c, e-table-group-leaf.h, e-table-group.c, e-table-group.h, e-table-header-item.c, e-table-header-item.h, e-table-header-utils.c, e-table-header-utils.h, e-table-header.c, e-table-header.h, e-table-item.c, e-table-item.h, e-table-memory-callbacks.c, e-table-memory-callbacks.h, e-table-memory.c, e-table-memory.h, e-table-model.c, e-table-model.h, e-table-one.c, e-table-one.h, e-table-scrolled.c, e-table-scrolled.h, e-table-selection-model.c, e-table-selection-model.h, e-table-simple.c, e-table-simple.h, e-table-size-test.c, e-table-sort-info.c, e-table-sort-info.h, e-table-sorted-variable.c, e-table-sorted-variable.h, e-table-sorted.c, e-table-sorted.h, e-table-sorter.c, e-table-sorter.h, e-table-sorting-utils.c, e-table-sorting-utils.h, e-table-specification.c, e-table-specification.h, e-table-state.c, e-table-state.h, e-table-subset-variable.c, e-table-subset-variable.h, e-table-subset.c, e-table-subset.h, e-table-tooltip.h, e-table-tree.h, e-table-utils.c, e-table-utils.h, e-table-without.c, e-table-without.h, e-table.c, e-table.h, e-tree-memory-callbacks.c, e-tree-memory-callbacks.h, e-tree-memory.c, e-tree-memory.h, e-tree-model.c, e-tree-model.h, e-tree-scrolled.c, e-tree-scrolled.h, e-tree-selection-model.c, e-tree-selection-model.h, e-tree-simple.c, e-tree-simple.h, e-tree-sorted-variable.c, e-tree-sorted-variable.h, e-tree-sorted.c, e-tree-sorted.h, e-tree-table-adapter.c, e-tree-table-adapter.h, e-tree.c, e-tree.h, table-test.c, table-test.h, test-check.c, test-cols.c, test-table.c: Changed the license announcement at the top of these files. * e-cell-string.c: Removed unused file. svn path=/trunk/; revision=14154
208 lines
8.2 KiB
C
208 lines
8.2 KiB
C
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
|
|
/*
|
|
* e-tree-model.h
|
|
* Copyright 2000, 2001, Ximian, Inc.
|
|
*
|
|
* Authors:
|
|
* Chris Lahey <clahey@ximian.com>
|
|
* Chris Toshok <toshok@ximian.com>
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License, version 2, as published by the Free Software Foundation.
|
|
*
|
|
* 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, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
|
|
* 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef _E_TREE_MODEL_H_
|
|
#define _E_TREE_MODEL_H_
|
|
|
|
#include <gdk-pixbuf/gdk-pixbuf.h>
|
|
#include <gtk/gtkobject.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
#define E_TREE_MODEL_TYPE (e_tree_model_get_type ())
|
|
#define E_TREE_MODEL(o) (GTK_CHECK_CAST ((o), E_TREE_MODEL_TYPE, ETreeModel))
|
|
#define E_TREE_MODEL_CLASS(k) (GTK_CHECK_CLASS_CAST((k), E_TREE_MODEL_TYPE, ETreeModelClass))
|
|
#define E_IS_TREE_MODEL(o) (GTK_CHECK_TYPE ((o), E_TREE_MODEL_TYPE))
|
|
#define E_IS_TREE_MODEL_CLASS(k) (GTK_CHECK_CLASS_TYPE ((k), E_TREE_MODEL_TYPE))
|
|
|
|
typedef void * ETreePath;
|
|
typedef struct ETreeModel ETreeModel;
|
|
typedef struct ETreeModelClass ETreeModelClass;
|
|
typedef gint (*ETreePathCompareFunc)(ETreeModel *model, ETreePath path1, ETreePath path2);
|
|
typedef gboolean (*ETreePathFunc)(ETreeModel *model, ETreePath path, gpointer data);
|
|
|
|
struct ETreeModel {
|
|
GtkObject base;
|
|
};
|
|
|
|
struct ETreeModelClass {
|
|
GtkObjectClass parent_class;
|
|
|
|
/*
|
|
* Virtual methods
|
|
*/
|
|
ETreePath (*get_root) (ETreeModel *etm);
|
|
|
|
ETreePath (*get_parent) (ETreeModel *etm, ETreePath node);
|
|
ETreePath (*get_first_child) (ETreeModel *etm, ETreePath node);
|
|
ETreePath (*get_last_child) (ETreeModel *etm, ETreePath node);
|
|
ETreePath (*get_next) (ETreeModel *etm, ETreePath node);
|
|
ETreePath (*get_prev) (ETreeModel *etm, ETreePath node);
|
|
|
|
gboolean (*is_root) (ETreeModel *etm, ETreePath node);
|
|
gboolean (*is_expandable) (ETreeModel *etm, ETreePath node);
|
|
guint (*get_children) (ETreeModel *etm, ETreePath node, ETreePath **paths);
|
|
guint (*depth) (ETreeModel *etm, ETreePath node);
|
|
|
|
GdkPixbuf *(*icon_at) (ETreeModel *etm, ETreePath node);
|
|
|
|
gboolean (*get_expanded_default) (ETreeModel *etm);
|
|
gint (*column_count) (ETreeModel *etm);
|
|
|
|
gboolean (*has_save_id) (ETreeModel *etm);
|
|
gchar *(*get_save_id) (ETreeModel *etm, ETreePath node);
|
|
|
|
gboolean (*has_get_node_by_id) (ETreeModel *etm);
|
|
ETreePath (*get_node_by_id) (ETreeModel *etm, const char *save_id);
|
|
|
|
gboolean (*has_change_pending) (ETreeModel *etm);
|
|
|
|
/*
|
|
* ETable analogs
|
|
*/
|
|
void *(*value_at) (ETreeModel *etm, ETreePath node, int col);
|
|
void (*set_value_at) (ETreeModel *etm, ETreePath node, int col, const void *val);
|
|
gboolean (*is_editable) (ETreeModel *etm, ETreePath node, int col);
|
|
|
|
void *(*duplicate_value) (ETreeModel *etm, int col, const void *value);
|
|
void (*free_value) (ETreeModel *etm, int col, void *value);
|
|
void *(*initialize_value) (ETreeModel *etm, int col);
|
|
gboolean (*value_is_empty) (ETreeModel *etm, int col, const void *value);
|
|
char *(*value_to_string) (ETreeModel *etm, int col, const void *value);
|
|
|
|
/*
|
|
* Signals
|
|
*/
|
|
void (*pre_change) (ETreeModel *etm);
|
|
void (*node_changed) (ETreeModel *etm, ETreePath node);
|
|
void (*node_data_changed) (ETreeModel *etm, ETreePath node);
|
|
void (*node_col_changed) (ETreeModel *etm, ETreePath node, int col);
|
|
void (*node_inserted) (ETreeModel *etm, ETreePath parent, ETreePath inserted_node);
|
|
void (*node_removed) (ETreeModel *etm, ETreePath parent, ETreePath removed_node, int old_position);
|
|
};
|
|
GtkType e_tree_model_get_type (void);
|
|
ETreeModel *e_tree_model_new (void);
|
|
|
|
/* tree traversal operations */
|
|
ETreePath e_tree_model_get_root (ETreeModel *etree);
|
|
ETreePath e_tree_model_node_get_parent (ETreeModel *etree,
|
|
ETreePath path);
|
|
ETreePath e_tree_model_node_get_first_child (ETreeModel *etree,
|
|
ETreePath path);
|
|
ETreePath e_tree_model_node_get_last_child (ETreeModel *etree,
|
|
ETreePath path);
|
|
ETreePath e_tree_model_node_get_next (ETreeModel *etree,
|
|
ETreePath path);
|
|
ETreePath e_tree_model_node_get_prev (ETreeModel *etree,
|
|
ETreePath path);
|
|
|
|
/* node accessors */
|
|
gboolean e_tree_model_node_is_root (ETreeModel *etree,
|
|
ETreePath path);
|
|
gboolean e_tree_model_node_is_expandable (ETreeModel *etree,
|
|
ETreePath path);
|
|
guint e_tree_model_node_get_children (ETreeModel *etree,
|
|
ETreePath path,
|
|
ETreePath **paths);
|
|
guint e_tree_model_node_depth (ETreeModel *etree,
|
|
ETreePath path);
|
|
GdkPixbuf *e_tree_model_icon_at (ETreeModel *etree,
|
|
ETreePath path);
|
|
gboolean e_tree_model_get_expanded_default (ETreeModel *model);
|
|
gint e_tree_model_column_count (ETreeModel *model);
|
|
|
|
|
|
gboolean e_tree_model_has_save_id (ETreeModel *model);
|
|
gchar *e_tree_model_get_save_id (ETreeModel *model,
|
|
ETreePath node);
|
|
|
|
gboolean e_tree_model_has_get_node_by_id (ETreeModel *model);
|
|
ETreePath e_tree_model_get_node_by_id (ETreeModel *model,
|
|
const char *save_id);
|
|
|
|
gboolean e_tree_model_has_change_pending (ETreeModel *model);
|
|
|
|
void *e_tree_model_value_at (ETreeModel *etree,
|
|
ETreePath node,
|
|
int col);
|
|
void e_tree_model_set_value_at (ETreeModel *etree,
|
|
ETreePath node,
|
|
int col,
|
|
const void *val);
|
|
gboolean e_tree_model_node_is_editable (ETreeModel *etree,
|
|
ETreePath node,
|
|
int col);
|
|
void *e_tree_model_duplicate_value (ETreeModel *etree,
|
|
int col,
|
|
const void *value);
|
|
void e_tree_model_free_value (ETreeModel *etree,
|
|
int col,
|
|
void *value);
|
|
void *e_tree_model_initialize_value (ETreeModel *etree,
|
|
int col);
|
|
gboolean e_tree_model_value_is_empty (ETreeModel *etree,
|
|
int col,
|
|
const void *value);
|
|
char *e_tree_model_value_to_string (ETreeModel *etree,
|
|
int col,
|
|
const void *value);
|
|
|
|
/* depth first traversal of path's descendents, calling func on each one */
|
|
void e_tree_model_node_traverse (ETreeModel *model,
|
|
ETreePath path,
|
|
ETreePathFunc func,
|
|
gpointer data);
|
|
void e_tree_model_node_traverse_preorder (ETreeModel *model,
|
|
ETreePath path,
|
|
ETreePathFunc func,
|
|
gpointer data);
|
|
|
|
/*
|
|
** Routines for emitting signals on the ETreeModel
|
|
*/
|
|
void e_tree_model_pre_change (ETreeModel *tree_model);
|
|
void e_tree_model_node_changed (ETreeModel *tree_model,
|
|
ETreePath node);
|
|
void e_tree_model_node_data_changed (ETreeModel *tree_model,
|
|
ETreePath node);
|
|
void e_tree_model_node_col_changed (ETreeModel *tree_model,
|
|
ETreePath node,
|
|
int col);
|
|
void e_tree_model_node_inserted (ETreeModel *tree_model,
|
|
ETreePath parent_node,
|
|
ETreePath inserted_node);
|
|
void e_tree_model_node_removed (ETreeModel *tree_model,
|
|
ETreePath parent_node,
|
|
ETreePath removed_node,
|
|
int old_position);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* _E_TREE_MODEL_H */
|