/* * 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-specification.h" #include #include #include #include #include #include #include "e-xml-utils.h" /* workaround for avoiding API breakage */ #define etsp_get_type e_table_specification_get_type G_DEFINE_TYPE (ETableSpecification, etsp, G_TYPE_OBJECT) static void etsp_finalize (GObject *object) { ETableSpecification *etsp = E_TABLE_SPECIFICATION (object); gint i; if (etsp->columns) { for (i = 0; etsp->columns[i]; i++) { g_object_unref (etsp->columns[i]); } g_free (etsp->columns); etsp->columns = NULL; } if (etsp->state) g_object_unref (etsp->state); etsp->state = NULL; g_free (etsp->click_to_add_message); etsp->click_to_add_message = NULL; g_free (etsp->domain); etsp->domain = NULL; G_OBJECT_CLASS (etsp_parent_class)->finalize (object); } static void etsp_class_init (ETableSpecificationClass *class) { GObjectClass *object_class = G_OBJECT_CLASS (class); object_class->finalize = etsp_finalize; } static void etsp_init (ETableSpecification *etsp) { etsp->columns = NULL; etsp->state = NULL; etsp->alternating_row_colors = TRUE; etsp->no_headers = FALSE; etsp->click_to_add = FALSE; etsp->click_to_add_end = FALSE; etsp->horizontal_draw_grid = FALSE; etsp->vertical_draw_grid = FALSE; etsp->draw_focus = TRUE; etsp->horizontal_scrolling = FALSE; etsp->horizontal_resize = FALSE; etsp->allow_grouping = TRUE; etsp->cursor_mode = E_CURSOR_SIMPLE; etsp->selection_mode = GTK_SELECTION_MULTIPLE; etsp->click_to_add_message = NULL; etsp->domain = NULL; } /** * e_table_specification_new: * * Creates a new %ETableSpecification object. This object is used to hold the * information about the rendering information for ETable. * * Returns: a newly created %ETableSpecification object. */ ETableSpecification * e_table_specification_new (void) { ETableSpecification *etsp = g_object_new (E_TYPE_TABLE_SPECIFICATION, NULL); return (ETableSpecification *) etsp; } /** * e_table_specification_load_from_file: * @specification: An ETableSpecification that you want to modify * @filename: a filename that contains an ETableSpecification * * This routine modifies @specification to reflect the state described * by the file @filename. * * Returns: TRUE on success, FALSE on failure. */ gboolean e_table_specification_load_from_file (ETableSpecification *specification, const gchar *filename) { xmlDoc *doc; doc = e_xml_parse_file (filename); if (doc) { xmlNode *node = xmlDocGetRootElement (doc); e_table_specification_load_from_node (specification, node); xmlFreeDoc (doc); return TRUE; } return FALSE; } /** * e_table_specification_load_from_string: * @specification: An ETableSpecification that you want to modify * @xml: a stringified representation of an ETableSpecification description. * * This routine modifies @specification to reflect the state described * by @xml. @xml is typically returned by e_table_specification_save_to_string * or it can be embedded in your source code. * * Returns: TRUE on success, FALSE on failure. */ gboolean e_table_specification_load_from_string (ETableSpecification *specification, const gchar *xml) { xmlDoc *doc; doc = xmlParseMemory ((gchar *) xml, strlen (xml)); if (doc) { xmlNode *node = xmlDocGetRootElement (doc); e_table_specification_load_from_node (specification, node); xmlFreeDoc (doc); return TRUE; } return FALSE; } /** * e_table_specification_load_from_node: * @specification: An ETableSpecification that you want to modify * @node: an xmlNode with an XML ETableSpecification description. * * This routine modifies @specification to reflect the state described * by @node. */ void e_table_specification_load_from_node (ETableSpecification *specification, const xmlNode *node) { gchar *temp; xmlNode *children; GList *list = NULL, *list2; gint i; specification->no_headers = e_xml_get_bool_prop_by_name (node, (const guchar *)"no-headers"); specification->click_to_add = e_xml_get_bool_prop_by_name (node, (const guchar *)"click-to-add"); specification->click_to_add_end = e_xml_get_bool_prop_by_name (node, (const guchar *)"click-to-add-end") && specification->click_to_add; specification->alternating_row_colors = e_xml_get_bool_prop_by_name_with_default (node, (const guchar *)"alternating-row-colors", TRUE); specification->horizontal_draw_grid = e_xml_get_bool_prop_by_name (node, (const guchar *)"horizontal-draw-grid"); specification->vertical_draw_grid = e_xml_get_bool_prop_by_name (node, (const guchar *)"vertical-draw-grid"); if (e_xml_get_bool_prop_by_name_with_default (node, (const guchar *)"draw-grid", TRUE) == e_xml_get_bool_prop_by_name_with_default (node, (const guchar *)"draw-grid", FALSE)) { specification->horizontal_draw_grid = specification->vertical_draw_grid = e_xml_get_bool_prop_by_name (node, (const guchar *)"draw-grid"); } specification->draw_focus = e_xml_get_bool_prop_by_name_with_default (node, (const guchar *)"draw-focus", TRUE); specification->horizontal_scrolling = e_xml_get_bool_prop_by_name_with_default (node, (const guchar *)"horizontal-scrolling", FALSE); specification->horizontal_resize = e_xml_get_bool_prop_by_name_with_default (node, (const guchar *)"horizontal-resize", FALSE); specification->allow_grouping = e_xml_get_bool_prop_by_name_with_default (node, (const guchar *)"allow-grouping", TRUE); specification->selection_mode = GTK_SELECTION_MULTIPLE; temp = e_xml_get_string_prop_by_name (node, (const guchar *)"selection-mode"); if (temp && !g_ascii_strcasecmp (temp, "single")) { specification->selection_mode = GTK_SELECTION_SINGLE; } else if (temp && !g_ascii_strcasecmp (temp, "browse")) { specification->selection_mode = GTK_SELECTION_BROWSE; } else if (temp && !g_ascii_strcasecmp (temp, "extended")) { specification->selection_mode = GTK_SELECTION_MULTIPLE; } g_free (temp); specification->cursor_mode = E_CURSOR_SIMPLE; temp = e_xml_get_string_prop_by_name (node, (const guchar *)"cursor-mode"); if (temp && !g_ascii_strcasecmp (temp, "line")) { specification->cursor_mode = E_CURSOR_LINE; } else if (temp && !g_ascii_strcasecmp (temp, "spreadsheet")) { specification->cursor_mode = E_CURSOR_SPREADSHEET; } g_free (temp); g_free (specification->click_to_add_message); specification->click_to_add_message = e_xml_get_string_prop_by_name ( node, (const guchar *)"_click-to-add-message"); g_free (specification->domain); specification->domain = e_xml_get_string_prop_by_name ( node, (const guchar *)"gettext-domain"); if (specification->domain && !*specification->domain) { g_free (specification->domain); specification->domain = NULL; } if (specification->state) g_object_unref (specification->state); specification->state = NULL; if (specification->columns) { for (i = 0; specification->columns[i]; i++) { g_object_unref (specification->columns[i]); } g_free (specification->columns); } specification->columns = NULL; for (children = node->xmlChildrenNode; children; children = children->next) { if (!strcmp ((gchar *) children->name, "ETableColumn")) { ETableColumnSpecification *col_spec = e_table_column_specification_new (); e_table_column_specification_load_from_node (col_spec, children); list = g_list_append (list, col_spec); } else if (specification->state == NULL && !strcmp ((gchar *) children->name, "ETableState")) { specification->state = e_table_state_new (); e_table_state_load_from_node (specification->state, children); e_table_sort_info_set_can_group (specification->state->sort_info, specification->allow_grouping); } } if (specification->state == NULL) { /* Make the default state. */ specification->state = e_table_state_vanilla (g_list_length (list)); } specification->columns = g_new (ETableColumnSpecification *, g_list_length (list) + 1); for (list2 = list, i = 0; list2; list2 = g_list_next (list2), i++) { specification->columns[i] = list2->data; } specification->columns[i] = NULL; g_list_free (list); } /** * e_table_specification_save_to_file: * @specification: An %ETableSpecification that you want to save * @filename: a file name to store the specification. * * This routine stores the @specification into @filename. * * Returns: 0 on success or -1 on error. */ gint e_table_specification_save_to_file (ETableSpecification *specification, const gchar *filename) { xmlDoc *doc; gint ret; g_return_val_if_fail (E_IS_TABLE_SPECIFICATION (specification), -1); g_return_val_if_fail (filename != NULL, -1); if ((doc = xmlNewDoc ((const guchar *)"1.0")) == NULL) return -1; xmlDocSetRootElement (doc, e_table_specification_save_to_node (specification, doc)); ret = e_xml_save_file (filename, doc); xmlFreeDoc (doc); return ret; } /** * e_table_specification_save_to_string: * @specification: An %ETableSpecification that you want to stringify * * Saves the state of @specification to a string. * * Returns: an g_alloc() allocated string containing the stringified * representation of @specification. This stringified representation * uses XML as a convenience. */ gchar * e_table_specification_save_to_string (ETableSpecification *specification) { gchar *ret_val; xmlChar *string; gint length; xmlDoc *doc; g_return_val_if_fail (E_IS_TABLE_SPECIFICATION (specification), NULL); doc = xmlNewDoc ((const guchar *)"1.0"); xmlDocSetRootElement (doc, e_table_specification_save_to_node (specification, doc)); xmlDocDumpMemory (doc, &string, &length); ret_val = g_strdup ((gchar *) string); xmlFree (string); return ret_val; } /** * e_table_specification_save_to_node: * @specification: An ETableSpecification that you want to store. * @doc: Node where the specification is saved * * This routine saves the %ETableSpecification state in the object @specification * into the xmlDoc represented by @doc. * * Returns: The node that has been attached to @doc with the contents * of the ETableSpecification. */ xmlNode * e_table_specification_save_to_node (ETableSpecification *specification, xmlDoc *doc) { xmlNode *node; const gchar *s; g_return_val_if_fail (E_IS_TABLE_SPECIFICATION (specification), NULL); g_return_val_if_fail (doc != NULL, NULL); node = xmlNewNode (NULL, (const guchar *)"ETableSpecification"); e_xml_set_bool_prop_by_name (node, (const guchar *)"no-headers", specification->no_headers); e_xml_set_bool_prop_by_name (node, (const guchar *)"click-to-add", specification->click_to_add); e_xml_set_bool_prop_by_name (node, (const guchar *)"click-to-add-end", specification->click_to_add_end && specification->click_to_add); e_xml_set_bool_prop_by_name (node, (const guchar *)"alternating-row-colors", specification->alternating_row_colors); e_xml_set_bool_prop_by_name (node, (const guchar *)"horizontal-draw-grid", specification->horizontal_draw_grid); e_xml_set_bool_prop_by_name (node, (const guchar *)"vertical-draw-grid", specification->vertical_draw_grid); e_xml_set_bool_prop_by_name (node, (const guchar *)"draw-focus", specification->draw_focus); e_xml_set_bool_prop_by_name (node, (const guchar *)"horizontal-scrolling", specification->horizontal_scrolling); e_xml_set_bool_prop_by_name (node, (const guchar *)"horizontal-resize", specification->horizontal_resize); e_xml_set_bool_prop_by_name (node, (const guchar *)"allow-grouping", specification->allow_grouping); switch (specification->selection_mode) { case GTK_SELECTION_SINGLE: s = "single"; break; case GTK_SELECTION_BROWSE: s = "browse"; break; default: case GTK_SELECTION_MULTIPLE: s = "extended"; } xmlSetProp (node, (const guchar *)"selection-mode", (guchar *) s); if (specification->cursor_mode == E_CURSOR_LINE) s = "line"; else s = "cell"; xmlSetProp (node, (const guchar *)"cursor-mode", (guchar *) s); xmlSetProp (node, (const guchar *)"_click-to-add-message", (guchar *) specification->click_to_add_message); xmlSetProp (node, (const guchar *)"gettext-domain", (guchar *) specification->domain); if (specification->columns) { gint i; for (i = 0; specification->columns[i]; i++) e_table_column_specification_save_to_node ( specification->columns[i], node); } if (specification->state) e_table_state_save_to_node (specification->state, node); return node; } /** * e_table_specification_duplicate: * @specification: specification to duplicate * * This creates a copy of the %ETableSpecification @specification. * * Returns: The duplicated %ETableSpecification. */ ETableSpecification * e_table_specification_duplicate (ETableSpecification *specification) { ETableSpecification *new_spec; gchar *spec_str; g_return_val_if_fail (E_IS_TABLE_SPECIFICATION (specification), NULL); new_spec = e_table_specification_new (); spec_str = e_table_specification_save_to_string (specification); if (!e_table_specification_load_from_string (new_spec, spec_str)) { g_warning ("Unable to duplicate ETable specification"); g_object_unref (new_spec); new_spec = NULL; } g_free (spec_str); return new_spec; }