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-table-model.c | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) (limited to 'widgets/table/e-table-model.c') diff --git a/widgets/table/e-table-model.c b/widgets/table/e-table-model.c index 258c16ac10..f731dc396a 100644 --- a/widgets/table/e-table-model.c +++ b/widgets/table/e-table-model.c @@ -110,8 +110,14 @@ e_table_model_append_row (ETableModel *e_table_model, ETableModel *source, int r * returned can be a pointer or any data value that can be stored * inside a pointer. * - * The data returned is typically used by an ECell renderer - */ + * The data returned is typically used by an ECell renderer. + * + * The data returned must be valid until the model sends a signal that + * affect that piece of data. model_changed affects all data. + * row_changed affects the data in that row. cell_changed affects the + * data in that cell. rows_deleted affects all data in those rows. + * rows_inserted and no_change don't affect any data in this way. + **/ void * e_table_model_value_at (ETableModel *e_table_model, int col, int row) { -- cgit v1.2.3