From 24f211162b3d6e6f7b3adca1071b76382bb96c2a Mon Sep 17 00:00:00 2001 From: Christopher James Lahey Date: Fri, 26 Apr 2002 20:33:23 +0000 Subject: Documented the life cycle requirements of the return value of these 2002-04-26 Christopher James Lahey * e-table-model.c (e_table_model_value_at), e-tree-model.c (e_tree_model_value_at): Documented the life cycle requirements of the return value of these functions. svn path=/trunk/; revision=16602 --- widgets/table/e-tree-model.c | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) (limited to 'widgets/table/e-tree-model.c') diff --git a/widgets/table/e-tree-model.c b/widgets/table/e-tree-model.c index 9b205bbc51..13f203974f 100644 --- a/widgets/table/e-tree-model.c +++ b/widgets/table/e-tree-model.c @@ -749,14 +749,24 @@ e_tree_model_has_change_pending (ETreeModel *etree) } /** - * e_tree_model_icon_of_node + * e_tree_model_value_at: * @etree: The ETreeModel. - * @path: The ETreePath to the node we're getting the icon of. + * @node: The ETreePath to the node we're getting the data from. + * @col: the column to retrieve data from + * + * Return value: This function returns the value that is stored by the + * @etree in column @col and node @node. The data returned can be a + * pointer or any data value that can be stored inside a pointer. * - * XXX docs here. + * The data returned is typically used by an ECell renderer. * - * return values: the GdkPixbuf associated with this node. - */ + * The data returned must be valid until the model sends a signal that + * affect that piece of data. node_changed and node_deleted affect + * all data in tha t node and all nodes under that node. + * node_data_changed affects the data in that node. node_col_changed + * affects the data in that node for that column. node_inserted, + * node_removed, and no_change don't affect any data in this way. + **/ void * e_tree_model_value_at (ETreeModel *etree, ETreePath node, int col) { -- cgit v1.2.3