From d09d8de870b6697c8a8b262e7e077b871a69b315 Mon Sep 17 00:00:00 2001 From: Matthew Barnes Date: Mon, 10 Dec 2012 08:09:59 -0500 Subject: Consolidate base utility libraries into libeutil. Evolution consists of entirely too many small utility libraries, which increases linking and loading time, places a burden on higher layers of the application (e.g. modules) which has to remember to link to all the small in-tree utility libraries, and makes it difficult to generate API documentation for these utility libraries in one Gtk-Doc module. Merge the following utility libraries under the umbrella of libeutil, and enforce a single-include policy on libeutil so we can reorganize the files as desired without disrupting its pseudo-public API. libemail-utils/libemail-utils.la libevolution-utils/libevolution-utils.la filter/libfilter.la widgets/e-timezone-dialog/libetimezonedialog.la widgets/menus/libmenus.la widgets/misc/libemiscwidgets.la widgets/table/libetable.la widgets/text/libetext.la This also merges libedataserverui from the Evolution-Data-Server module, since Evolution is its only consumer nowadays, and I'd like to make some improvements to those APIs without concern for backward-compatibility. And finally, start a Gtk-Doc module for libeutil. It's going to be a project just getting all the symbols _listed_ much less _documented_. But the skeletal structure is in place and I'm off to a good start. --- e-util/e-table-model.c | 682 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 682 insertions(+) create mode 100644 e-util/e-table-model.c (limited to 'e-util/e-table-model.c') diff --git a/e-util/e-table-model.c b/e-util/e-table-model.c new file mode 100644 index 0000000000..1ae4d3e81b --- /dev/null +++ b/e-util/e-table-model.c @@ -0,0 +1,682 @@ +/* + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) version 3. + * + * This program 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 + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with the program; if not, see + * + * + * Authors: + * Chris Lahey + * + * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com) + * + */ + +#ifdef HAVE_CONFIG_H +#include +#endif + +#include "e-table-model.h" + +#include "e-marshal.h" + +#define ETM_FROZEN(e) \ + (GPOINTER_TO_INT (g_object_get_data (G_OBJECT (e), "frozen")) != 0) + +#define d(x) + +d (static gint depth = 0;) + +G_DEFINE_TYPE (ETableModel, e_table_model, G_TYPE_OBJECT) + +enum { + MODEL_NO_CHANGE, + MODEL_CHANGED, + MODEL_PRE_CHANGE, + MODEL_ROW_CHANGED, + MODEL_CELL_CHANGED, + MODEL_ROWS_INSERTED, + MODEL_ROWS_DELETED, + ROW_SELECTION, + LAST_SIGNAL +}; + +static guint signals[LAST_SIGNAL] = { 0, }; + +/** + * e_table_model_column_count: + * @e_table_model: The e-table-model to operate on + * + * Returns: the number of columns in the table model. + */ +gint +e_table_model_column_count (ETableModel *e_table_model) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), 0); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + g_return_val_if_fail (class->column_count != NULL, 0); + + return class->column_count (e_table_model); +} + +/** + * e_table_model_row_count: + * @e_table_model: the e-table-model to operate on + * + * Returns: the number of rows in the Table model. + */ +gint +e_table_model_row_count (ETableModel *e_table_model) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), 0); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + g_return_val_if_fail (class->row_count != NULL, 0); + + return class->row_count (e_table_model); +} + +/** + * e_table_model_append_row: + * @e_table_model: the table model to append the a row to. + * @source: + * @row: + * + */ +void +e_table_model_append_row (ETableModel *e_table_model, + ETableModel *source, + gint row) +{ + ETableModelClass *class; + + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + + if (class->append_row != NULL) + class->append_row (e_table_model, source, row); +} + +/** + * e_table_value_at: + * @e_table_model: the e-table-model to operate on + * @col: column in the model to pull data from. + * @row: row in the model to pull data from. + * + * Return value: This function returns the value that is stored + * by the @e_table_model in column @col and row @row. The data + * 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 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. + **/ +gpointer +e_table_model_value_at (ETableModel *e_table_model, + gint col, + gint row) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), NULL); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + g_return_val_if_fail (class->value_at != NULL, NULL); + + return class->value_at (e_table_model, col, row); +} + +/** + * e_table_model_set_value_at: + * @e_table_model: the table model to operate on. + * @col: the column where the data will be stored in the model. + * @row: the row where the data will be stored in the model. + * @value: the data to be stored. + * + * This function instructs the model to store the value in @data in the + * the @e_table_model at column @col and row @row. The @data typically + * comes from one of the ECell rendering objects. + * + * There should be an agreement between the Table Model and the user + * of this function about the data being stored. Typically it will + * be a pointer to a set of data, or a datum that fits inside a gpointer . + */ +void +e_table_model_set_value_at (ETableModel *e_table_model, + gint col, + gint row, + gconstpointer value) +{ + ETableModelClass *class; + + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + g_return_if_fail (class->set_value_at != NULL); + + class->set_value_at (e_table_model, col, row, value); +} + +/** + * e_table_model_is_cell_editable: + * @e_table_model: the table model to query. + * @col: column to query. + * @row: row to query. + * + * Returns: %TRUE if the cell in @e_table_model at @col,@row can be + * edited, %FALSE otherwise + */ +gboolean +e_table_model_is_cell_editable (ETableModel *e_table_model, + gint col, + gint row) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), FALSE); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + g_return_val_if_fail (class->is_cell_editable != NULL, FALSE); + + return class->is_cell_editable (e_table_model, col, row); +} + +gpointer +e_table_model_duplicate_value (ETableModel *e_table_model, + gint col, + gconstpointer value) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), NULL); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + + if (class->duplicate_value == NULL) + return NULL; + + return class->duplicate_value (e_table_model, col, value); +} + +void +e_table_model_free_value (ETableModel *e_table_model, + gint col, + gpointer value) +{ + ETableModelClass *class; + + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + + if (class->free_value != NULL) + class->free_value (e_table_model, col, value); +} + +gboolean +e_table_model_has_save_id (ETableModel *e_table_model) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), FALSE); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + + if (class->has_save_id == NULL) + return FALSE; + + return class->has_save_id (e_table_model); +} + +gchar * +e_table_model_get_save_id (ETableModel *e_table_model, + gint row) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), NULL); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + + if (class->get_save_id == NULL) + return NULL; + + return class->get_save_id (e_table_model, row); +} + +gboolean +e_table_model_has_change_pending (ETableModel *e_table_model) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), FALSE); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + + if (class->has_change_pending == NULL) + return FALSE; + + return class->has_change_pending (e_table_model); +} + +gpointer +e_table_model_initialize_value (ETableModel *e_table_model, + gint col) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), NULL); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + + if (class->initialize_value == NULL) + return NULL; + + return class->initialize_value (e_table_model, col); +} + +gboolean +e_table_model_value_is_empty (ETableModel *e_table_model, + gint col, + gconstpointer value) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), FALSE); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + + if (class->value_is_empty == NULL) + return FALSE; + + return class->value_is_empty (e_table_model, col, value); +} + +gchar * +e_table_model_value_to_string (ETableModel *e_table_model, + gint col, + gconstpointer value) +{ + ETableModelClass *class; + + g_return_val_if_fail (E_IS_TABLE_MODEL (e_table_model), NULL); + + class = E_TABLE_MODEL_GET_CLASS (e_table_model); + + if (class->value_to_string == NULL) + return g_strdup (""); + + return class->value_to_string (e_table_model, col, value); +} + +static void +e_table_model_class_init (ETableModelClass *class) +{ + GObjectClass *object_class = G_OBJECT_CLASS (class); + + signals[MODEL_NO_CHANGE] = g_signal_new ( + "model_no_change", + G_TYPE_FROM_CLASS (object_class), + G_SIGNAL_RUN_LAST, + G_STRUCT_OFFSET (ETableModelClass, model_no_change), + (GSignalAccumulator) NULL, NULL, + g_cclosure_marshal_VOID__VOID, + G_TYPE_NONE, 0); + + signals[MODEL_CHANGED] = g_signal_new ( + "model_changed", + G_TYPE_FROM_CLASS (object_class), + G_SIGNAL_RUN_LAST, + G_STRUCT_OFFSET (ETableModelClass, model_changed), + (GSignalAccumulator) NULL, NULL, + g_cclosure_marshal_VOID__VOID, + G_TYPE_NONE, 0); + + signals[MODEL_PRE_CHANGE] = g_signal_new ( + "model_pre_change", + G_TYPE_FROM_CLASS (object_class), + G_SIGNAL_RUN_LAST, + G_STRUCT_OFFSET (ETableModelClass, model_pre_change), + (GSignalAccumulator) NULL, NULL, + g_cclosure_marshal_VOID__VOID, + G_TYPE_NONE, 0); + + signals[MODEL_ROW_CHANGED] = g_signal_new ( + "model_row_changed", + G_TYPE_FROM_CLASS (object_class), + G_SIGNAL_RUN_LAST, + G_STRUCT_OFFSET (ETableModelClass, model_row_changed), + (GSignalAccumulator) NULL, NULL, + g_cclosure_marshal_VOID__INT, + G_TYPE_NONE, 1, + G_TYPE_INT); + + signals[MODEL_CELL_CHANGED] = g_signal_new ( + "model_cell_changed", + G_TYPE_FROM_CLASS (object_class), + G_SIGNAL_RUN_LAST, + G_STRUCT_OFFSET (ETableModelClass, model_cell_changed), + (GSignalAccumulator) NULL, NULL, + e_marshal_VOID__INT_INT, + G_TYPE_NONE, 2, + G_TYPE_INT, + G_TYPE_INT); + + signals[MODEL_ROWS_INSERTED] = g_signal_new ( + "model_rows_inserted", + G_TYPE_FROM_CLASS (object_class), + G_SIGNAL_RUN_LAST, + G_STRUCT_OFFSET (ETableModelClass, model_rows_inserted), + (GSignalAccumulator) NULL, NULL, + e_marshal_VOID__INT_INT, + G_TYPE_NONE, 2, + G_TYPE_INT, + G_TYPE_INT); + + signals[MODEL_ROWS_DELETED] = g_signal_new ( + "model_rows_deleted", + G_TYPE_FROM_CLASS (object_class), + G_SIGNAL_RUN_LAST, + G_STRUCT_OFFSET (ETableModelClass, model_rows_deleted), + (GSignalAccumulator) NULL, NULL, + e_marshal_VOID__INT_INT, + G_TYPE_NONE, 2, + G_TYPE_INT, + G_TYPE_INT); + + class->column_count = NULL; + class->row_count = NULL; + class->append_row = NULL; + + class->value_at = NULL; + class->set_value_at = NULL; + class->is_cell_editable = NULL; + + class->has_save_id = NULL; + class->get_save_id = NULL; + + class->has_change_pending = NULL; + + class->duplicate_value = NULL; + class->free_value = NULL; + class->initialize_value = NULL; + class->value_is_empty = NULL; + class->value_to_string = NULL; + + class->model_no_change = NULL; + class->model_changed = NULL; + class->model_row_changed = NULL; + class->model_cell_changed = NULL; + class->model_rows_inserted = NULL; + class->model_rows_deleted = NULL; +} + +static void +e_table_model_init (ETableModel *e_table_model) +{ + /* nothing to do */ +} + +#if d(!)0 +static void +print_tabs (void) +{ + gint i; + for (i = 0; i < depth; i++) + g_print ("\t"); +} +#endif + +void +e_table_model_pre_change (ETableModel *e_table_model) +{ + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + if (ETM_FROZEN (e_table_model)) + return; + + d (print_tabs ()); + d (depth++); + g_signal_emit (e_table_model, signals[MODEL_PRE_CHANGE], 0); + d (depth--); +} + +/** + * e_table_model_no_change: + * @e_table_model: the table model to notify of the lack of a change + * + * Use this function to notify any views of this table model that + * the contents of the table model have changed. This will emit + * the signal "model_no_change" on the @e_table_model object. + * + * It is preferable to use the e_table_model_row_changed() and + * the e_table_model_cell_changed() to notify of smaller changes + * than to invalidate the entire model, as the views might have + * ways of caching the information they render from the model. + */ +void +e_table_model_no_change (ETableModel *e_table_model) +{ + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + if (ETM_FROZEN (e_table_model)) + return; + + d (print_tabs ()); + d (depth++); + g_signal_emit (e_table_model, signals[MODEL_NO_CHANGE], 0); + d (depth--); +} + +/** + * e_table_model_changed: + * @e_table_model: the table model to notify of the change + * + * Use this function to notify any views of this table model that + * the contents of the table model have changed. This will emit + * the signal "model_changed" on the @e_table_model object. + * + * It is preferable to use the e_table_model_row_changed() and + * the e_table_model_cell_changed() to notify of smaller changes + * than to invalidate the entire model, as the views might have + * ways of caching the information they render from the model. + */ +void +e_table_model_changed (ETableModel *e_table_model) +{ + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + if (ETM_FROZEN (e_table_model)) + return; + + d (print_tabs ()); + d (depth++); + g_signal_emit (e_table_model, signals[MODEL_CHANGED], 0); + d (depth--); +} + +/** + * e_table_model_row_changed: + * @e_table_model: the table model to notify of the change + * @row: the row that was changed in the model. + * + * Use this function to notify any views of the table model that + * the contents of row @row have changed in model. This function + * will emit the "model_row_changed" signal on the @e_table_model + * object + */ +void +e_table_model_row_changed (ETableModel *e_table_model, + gint row) +{ + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + if (ETM_FROZEN (e_table_model)) + return; + + d (print_tabs ()); + d (depth++); + g_signal_emit (e_table_model, signals[MODEL_ROW_CHANGED], 0, row); + d (depth--); +} + +/** + * e_table_model_cell_changed: + * @e_table_model: the table model to notify of the change + * @col: the column. + * @row: the row + * + * Use this function to notify any views of the table model that + * contents of the cell at @col,@row has changed. This will emit + * the "model_cell_changed" signal on the @e_table_model + * object + */ +void +e_table_model_cell_changed (ETableModel *e_table_model, + gint col, + gint row) +{ + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + if (ETM_FROZEN (e_table_model)) + return; + + d (print_tabs ()); + d (depth++); + g_signal_emit ( + e_table_model, signals[MODEL_CELL_CHANGED], 0, col, row); + d (depth--); +} + +/** + * e_table_model_rows_inserted: + * @e_table_model: the table model to notify of the change + * @row: the row that was inserted into the model. + * @count: The number of rows that were inserted. + * + * Use this function to notify any views of the table model that + * @count rows at row @row have been inserted into the model. This + * function will emit the "model_rows_inserted" signal on the + * @e_table_model object + */ +void +e_table_model_rows_inserted (ETableModel *e_table_model, + gint row, + gint count) +{ + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + if (ETM_FROZEN (e_table_model)) + return; + + d (print_tabs ()); + d (depth++); + g_signal_emit ( + e_table_model, signals[MODEL_ROWS_INSERTED], 0, row, count); + d (depth--); +} + +/** + * e_table_model_row_inserted: + * @e_table_model: the table model to notify of the change + * @row: the row that was inserted into the model. + * + * Use this function to notify any views of the table model that the + * row @row has been inserted into the model. This function will emit + * the "model_rows_inserted" signal on the @e_table_model object + */ +void +e_table_model_row_inserted (ETableModel *e_table_model, + gint row) +{ + e_table_model_rows_inserted (e_table_model, row, 1); +} + +/** + * e_table_model_row_deleted: + * @e_table_model: the table model to notify of the change + * @row: the row that was deleted + * @count: The number of rows deleted + * + * Use this function to notify any views of the table model that + * @count rows at row @row have been deleted from the model. This + * function will emit the "model_rows_deleted" signal on the + * @e_table_model object + */ +void +e_table_model_rows_deleted (ETableModel *e_table_model, + gint row, + gint count) +{ + g_return_if_fail (E_IS_TABLE_MODEL (e_table_model)); + + if (ETM_FROZEN (e_table_model)) + return; + + d (print_tabs ()); + d (depth++); + g_signal_emit ( + e_table_model, signals[MODEL_ROWS_DELETED], 0, row, count); + d (depth--); +} + +/** + * e_table_model_row_deleted: + * @e_table_model: the table model to notify of the change + * @row: the row that was deleted + * + * Use this function to notify any views of the table model that the + * row @row has been deleted from the model. This function will emit + * the "model_rows_deleted" signal on the @e_table_model object + */ +void +e_table_model_row_deleted (ETableModel *e_table_model, + gint row) +{ + e_table_model_rows_deleted (e_table_model, row, 1); +} + +void +e_table_model_freeze (ETableModel *e_table_model) +{ + e_table_model_pre_change (e_table_model); + + /* FIXME This expression is awesome! */ + g_object_set_data ( + G_OBJECT (e_table_model), "frozen", + GINT_TO_POINTER (GPOINTER_TO_INT ( + g_object_get_data (G_OBJECT (e_table_model), "frozen")) + 1)); +} + +void +e_table_model_thaw (ETableModel *e_table_model) +{ + /* FIXME This expression is awesome! */ + g_object_set_data ( + G_OBJECT (e_table_model), "frozen", + GINT_TO_POINTER (GPOINTER_TO_INT ( + g_object_get_data (G_OBJECT (e_table_model), "frozen")) - 1)); + + e_table_model_changed (e_table_model); +} + -- cgit v1.2.3