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. --- widgets/table/e-cell.c | 680 ------------------------------------------------- 1 file changed, 680 deletions(-) delete mode 100644 widgets/table/e-cell.c (limited to 'widgets/table/e-cell.c') diff --git a/widgets/table/e-cell.c b/widgets/table/e-cell.c deleted file mode 100644 index b9b96eecb0..0000000000 --- a/widgets/table/e-cell.c +++ /dev/null @@ -1,680 +0,0 @@ -/* - * - * 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: - * Miguel de Icaza - * Chris Lahey - * - * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com) - * - */ - -#ifdef HAVE_CONFIG_H -#include -#endif - -#include -#include "e-util/e-util.h" - -#include "e-cell.h" - -G_DEFINE_TYPE (ECell, e_cell, G_TYPE_OBJECT) - -static ECellView * -ec_new_view (ECell *ecell, - ETableModel *table_model, - gpointer e_table_item_view) -{ - return NULL; -} - -static void -ec_realize (ECellView *e_cell) -{ -} - -static void -ec_kill_view (ECellView *ecell_view) -{ -} - -static void -ec_unrealize (ECellView *e_cell) -{ -} - -static void -ec_draw (ECellView *ecell_view, - cairo_t *cr, - gint model_col, - gint view_col, - gint row, - ECellFlags flags, - gint x1, - gint y1, - gint x2, - gint y2) -{ - g_critical ("e-cell-draw invoked"); -} - -static gint -ec_event (ECellView *ecell_view, - GdkEvent *event, - gint model_col, - gint view_col, - gint row, - ECellFlags flags, - ECellActions *actions) -{ - g_critical ("e-cell-event invoked"); - - return 0; -} - -static gint -ec_height (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row) -{ - g_critical ("e-cell-height invoked"); - - return 0; -} - -static void -ec_focus (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row, - gint x1, - gint y1, - gint x2, - gint y2) -{ - ecell_view->focus_col = view_col; - ecell_view->focus_row = row; - ecell_view->focus_x1 = x1; - ecell_view->focus_y1 = y1; - ecell_view->focus_x2 = x2; - ecell_view->focus_y2 = y2; -} - -static void -ec_unfocus (ECellView *ecell_view) -{ - ecell_view->focus_col = -1; - ecell_view->focus_row = -1; - ecell_view->focus_x1 = -1; - ecell_view->focus_y1 = -1; - ecell_view->focus_x2 = -1; - ecell_view->focus_y2 = -1; -} - -static gpointer -ec_enter_edit (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row) -{ - return NULL; -} - -static void -ec_leave_edit (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row, - gpointer context) -{ -} - -static gpointer -ec_save_state (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row, - gpointer context) -{ - return NULL; -} - -static void -ec_load_state (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row, - gpointer context, - gpointer save_state) -{ -} - -static void -ec_free_state (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row, - gpointer save_state) -{ -} - -static void -e_cell_class_init (ECellClass *class) -{ - class->realize = ec_realize; - class->unrealize = ec_unrealize; - class->new_view = ec_new_view; - class->kill_view = ec_kill_view; - class->draw = ec_draw; - class->event = ec_event; - class->focus = ec_focus; - class->unfocus = ec_unfocus; - class->height = ec_height; - class->enter_edit = ec_enter_edit; - class->leave_edit = ec_leave_edit; - class->save_state = ec_save_state; - class->load_state = ec_load_state; - class->free_state = ec_free_state; - class->print = NULL; - class->print_height = NULL; - class->max_width = NULL; - class->max_width_by_row = NULL; -} - -static void -e_cell_init (ECell *cell) -{ -} - -/** - * e_cell_event: - * @ecell_view: The ECellView where the event will be dispatched - * @event: The GdkEvent. - * @model_col: the column in the model - * @view_col: the column in the view - * @row: the row - * @flags: flags about the current state - * @actions: a second return value in case the cell wants to take some action - * (specifically grabbing & ungrabbing) - * - * Dispatches the event @event to the @ecell_view for. - * - * Returns: processing state from the GdkEvent handling. - */ -gint -e_cell_event (ECellView *ecell_view, - GdkEvent *event, - gint model_col, - gint view_col, - gint row, - ECellFlags flags, - ECellActions *actions) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - return class->event ( - ecell_view, event, model_col, - view_col, row, flags, actions); -} - -/** - * e_cell_new_view: - * @ecell: the Ecell that will create the new view - * @table_model: the table model the ecell is bound to - * @e_table_item_view: an ETableItem object (the CanvasItem that - * reprensents the view of the table) - * - * ECell renderers new to be bound to a table_model and to the actual view - * during their life time to actually render the data. This method is invoked - * by the ETableItem canvas item to instatiate a new view of the ECell. - * - * This is invoked when the ETableModel is attached to the ETableItem - * (a CanvasItem that can render ETableModels in the screen). - * - * Returns: a new ECellView for this @ecell on the @table_model displayed - * on the @e_table_item_view. - */ -ECellView * -e_cell_new_view (ECell *ecell, - ETableModel *table_model, - gpointer e_table_item_view) -{ - return E_CELL_GET_CLASS (ecell)->new_view ( - ecell, table_model, e_table_item_view); -} - -/** - * e_cell_realize: - * @ecell_view: The ECellView to be realized. - * - * This function is invoked to give a chance to the ECellView to allocate - * any resources it needs from Gdk, equivalent to the GtkWidget::realize - * signal. - */ -void -e_cell_realize (ECellView *ecell_view) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - g_return_if_fail (class->realize != NULL); - - class->realize (ecell_view); -} - -/** - * e_cell_kill_view: - * @ecell_view: view to be destroyed. - * - * This method it used to destroy a view of an ECell renderer - */ -void -e_cell_kill_view (ECellView *ecell_view) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - g_return_if_fail (class->kill_view != NULL); - - class->kill_view (ecell_view); -} - -/** - * e_cell_unrealize: - * @ecell_view: The ECellView to be unrealized. - * - * This function is invoked to give a chance to the ECellView to - * release any resources it allocated during the realize method, - * equivalent to the GtkWidget::unrealize signal. - */ -void -e_cell_unrealize (ECellView *ecell_view) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - g_return_if_fail (class->unrealize != NULL); - - class->unrealize (ecell_view); -} - -/** - * e_cell_draw: - * @ecell_view: the ECellView to redraw - * @cr: a Cairo context - * @model_col: the column in the model being drawn. - * @view_col: the column in the view being drawn (what the model maps to). - * @row: the row being drawn - * @flags: rendering flags. - * @x1: boudary for the rendering - * @y1: boudary for the rendering - * @x2: boudary for the rendering - * @y2: boudary for the rendering - * - * This instructs the ECellView to render itself into the Cairo context. - * The region to be drawn in given by (x1,y1)-(x2,y2). - * - * The most important flags are %E_CELL_SELECTED and %E_CELL_FOCUSED, other - * flags include alignments and justifications. - */ -void -e_cell_draw (ECellView *ecell_view, - cairo_t *cr, - gint model_col, - gint view_col, - gint row, - ECellFlags flags, - gint x1, - gint y1, - gint x2, - gint y2) -{ - ECellClass *class; - - g_return_if_fail (ecell_view != NULL); - g_return_if_fail (row >= 0); - g_return_if_fail (row < e_table_model_row_count (ecell_view->e_table_model)); - - class = E_CELL_GET_CLASS (ecell_view->ecell); - g_return_if_fail (class->draw != NULL); - - cairo_save (cr); - - class->draw ( - ecell_view, cr, - model_col, view_col, - row, flags, x1, y1, x2, y2); - - cairo_restore (cr); -} - -/** - * e_cell_print: - * @ecell_view: the ECellView to redraw - * @context: The GtkPrintContext where we output our printed data. - * @model_col: the column in the model being drawn. - * @view_col: the column in the view being drawn (what the model maps to). - * @row: the row being drawn - * @width: width - * @height: height - * - * FIXME: - */ -void -e_cell_print (ECellView *ecell_view, - GtkPrintContext *context, - gint model_col, - gint view_col, - gint row, - gdouble width, - gdouble height) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - if (class->print != NULL) - class->print ( - ecell_view, context, - model_col, view_col, - row, width, height); -} - -/** - * e_cell_print: - * - * FIXME: - */ -gdouble -e_cell_print_height (ECellView *ecell_view, - GtkPrintContext *context, - gint model_col, - gint view_col, - gint row, - gdouble width) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - if (class->print_height == NULL) - return 0.0; - - return class->print_height ( - ecell_view, context, - model_col, view_col, - row, width); -} - -/** - * e_cell_height: - * @ecell_view: the ECellView. - * @model_col: the column in the model - * @view_col: the column in the view. - * @row: the row to me measured - * - * Returns: the height of the cell at @model_col, @row rendered at - * @view_col, @row. - */ -gint -e_cell_height (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - g_return_val_if_fail (class->height != NULL, 0); - - return class->height (ecell_view, model_col, view_col, row); -} - -/** - * e_cell_enter_edit: - * @ecell_view: the ECellView that will enter editing - * @model_col: the column in the model - * @view_col: the column in the view - * @row: the row - * - * Notifies the ECellView that it is about to enter editing mode for - * @model_col, @row rendered at @view_col, @row. - */ -gpointer -e_cell_enter_edit (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - g_return_val_if_fail (class->enter_edit != NULL, NULL); - - return class->enter_edit (ecell_view, model_col, view_col, row); -} - -/** - * e_cell_leave_edit: - * @ecell_view: the ECellView that will leave editing - * @model_col: the column in the model - * @view_col: the column in the view - * @row: the row - * @edit_context: the editing context - * - * Notifies the ECellView that editing is finished at @model_col, @row - * rendered at @view_col, @row. - */ -void -e_cell_leave_edit (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row, - gpointer edit_context) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - g_return_if_fail (class->leave_edit != NULL); - - class->leave_edit (ecell_view, model_col, view_col, row, edit_context); -} - -/** - * e_cell_save_state: - * @ecell_view: the ECellView to save - * @model_col: the column in the model - * @view_col: the column in the view - * @row: the row - * @edit_context: the editing context - * - * Returns: The save state. - * - * Requests that the ECellView return a gpointer representing the state - * of the ECell. This is primarily intended for things like selection - * or scrolling. - */ -gpointer -e_cell_save_state (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row, - gpointer edit_context) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - if (class->save_state == NULL) - return NULL; - - return class->save_state ( - ecell_view, model_col, view_col, row, edit_context); -} - -/** - * e_cell_load_state: - * @ecell_view: the ECellView to load - * @model_col: the column in the model - * @view_col: the column in the view - * @row: the row - * @edit_context: the editing context - * @save_state: the save state to load from - * - * Requests that the ECellView load from the given save state. - */ -void -e_cell_load_state (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row, - gpointer edit_context, - gpointer save_state) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - if (class->load_state != NULL) - class->load_state ( - ecell_view, model_col, view_col, - row, edit_context, save_state); -} - -/** - * e_cell_free_state: - * @ecell_view: the ECellView - * @model_col: the column in the model - * @view_col: the column in the view - * @row: the row - * @edit_context: the editing context - * @save_state: the save state to free - * - * Requests that the ECellView free the given save state. - */ -void -e_cell_free_state (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row, - gpointer save_state) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - if (class->free_state != NULL) - class->free_state ( - ecell_view, model_col, view_col, row, save_state); -} - -/** - * e_cell_max_width: - * @ecell_view: the ECellView that will leave editing - * @model_col: the column in the model - * @view_col: the column in the view. - * - * Returns: the maximum width for the ECellview at @model_col which - * is being rendered as @view_col - */ -gint -e_cell_max_width (ECellView *ecell_view, - gint model_col, - gint view_col) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - g_return_val_if_fail (class->max_width != NULL, 0); - - return class->max_width (ecell_view, model_col, view_col); -} - -/** - * e_cell_max_width_by_row: - * @ecell_view: the ECellView that we are curious about - * @model_col: the column in the model - * @view_col: the column in the view. - * @row: The row in the model. - * - * Returns: the maximum width for the ECellview at @model_col which - * is being rendered as @view_col for the data in @row. - */ -gint -e_cell_max_width_by_row (ECellView *ecell_view, - gint model_col, - gint view_col, - gint row) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - if (class->max_width_by_row == NULL) - return e_cell_max_width (ecell_view, model_col, view_col); - - return class->max_width_by_row (ecell_view, model_col, view_col, row); -} - -/** - * e_cell_max_width_by_row_implemented: - * @ecell_view: the ECellView that we are curious about - * @model_col: the column in the model - * @view_col: the column in the view. - * @row: The row in the model. - * - * Returns: the maximum width for the ECellview at @model_col which - * is being rendered as @view_col for the data in @row. - */ -gboolean -e_cell_max_width_by_row_implemented (ECellView *ecell_view) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - return (class->max_width_by_row != NULL); -} - -gchar * -e_cell_get_bg_color (ECellView *ecell_view, - gint row) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - if (class->get_bg_color == NULL) - return NULL; - - return class->get_bg_color (ecell_view, row); -} - -void -e_cell_style_set (ECellView *ecell_view, - GtkStyle *previous_style) -{ - ECellClass *class; - - class = E_CELL_GET_CLASS (ecell_view->ecell); - - if (class->style_set != NULL) - class->style_set (ecell_view, previous_style); -} - -- cgit v1.2.3