/* * e-table-specification.c * * 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 * */ #include "e-table-specification.h" #include #include #include #include #include #include #include "e-xml-utils.h" #define E_TABLE_SPECIFICATION_GET_PRIVATE(obj) \ (G_TYPE_INSTANCE_GET_PRIVATE \ ((obj), E_TYPE_TABLE_SPECIFICATION, ETableSpecificationPrivate)) struct _ETableSpecificationPrivate { GPtrArray *columns; }; G_DEFINE_TYPE ( ETableSpecification, e_table_specification, G_TYPE_OBJECT) static void table_specification_dispose (GObject *object) { ETableSpecification *specification; specification = E_TABLE_SPECIFICATION (object); g_clear_object (&specification->state); g_ptr_array_set_size (specification->priv->columns, 0); /* Chain up to parent's dispose() method. */ G_OBJECT_CLASS (e_table_specification_parent_class)->dispose (object); } static void table_specification_finalize (GObject *object) { ETableSpecification *specification; specification = E_TABLE_SPECIFICATION (object); g_free (specification->click_to_add_message); g_free (specification->domain); g_ptr_array_unref (specification->priv->columns); /* Chain up to parent's finalize() method. */ G_OBJECT_CLASS (e_table_specification_parent_class)->finalize (object); } static void e_table_specification_class_init (ETableSpecificationClass *class) { GObjectClass *object_class; g_type_class_add_private (class, sizeof (ETableSpecificationPrivate)); object_class = G_OBJECT_CLASS (class); object_class->dispose = table_specification_dispose; object_class->finalize = table_specification_finalize; } static void e_table_specification_init (ETableSpecification *specification) { specification->priv = E_TABLE_SPECIFICATION_GET_PRIVATE (specification); specification->priv->columns = g_ptr_array_new_with_free_func ( (GDestroyNotify) g_object_unref); specification->alternating_row_colors = TRUE; specification->no_headers = FALSE; specification->click_to_add = FALSE; specification->click_to_add_end = FALSE; specification->horizontal_draw_grid = FALSE; specification->vertical_draw_grid = FALSE; specification->draw_focus = TRUE; specification->horizontal_scrolling = FALSE; specification->horizontal_resize = FALSE; specification->allow_grouping = TRUE; specification->cursor_mode = E_CURSOR_SIMPLE; specification->selection_mode = GTK_SELECTION_MULTIPLE; } /** * e_table_specification_new: * * Creates a new #ETableSpecification. This holds the rendering information * for an #ETable. * * Returns: an #ETableSpecification */ ETableSpecification * e_table_specification_new (void) { return g_object_new (E_TYPE_TABLE_SPECIFICATION, NULL); } /** * e_table_specification_ref_columns: * @specification: an #ETableSpecification * * Returns a #GPtrArray containing #ETableColumnSpecification instances for * all columns defined by @specification. The array contents are owned by * the @specification and should not be modified. Unreference the array * with g_ptr_array_unref() when finished with it. * * Returns: a #GPtrArray of #ETableColumnSpecification instances **/ GPtrArray * e_table_specification_ref_columns (ETableSpecification *specification) { g_return_val_if_fail (E_IS_TABLE_SPECIFICATION (specification), NULL); return g_ptr_array_ref (specification->priv->columns); } /** * e_table_specification_get_column_index: * @specification: an #ETableSpecification * @column_spec: an #ETableColumnSpecification * * Returns the zero-based index of @column_spec within @specification, * or a negative value if @column_spec is not defined by @specification. * * Returns: the column index of @column_spec, or a negative value **/ gint e_table_specification_get_column_index (ETableSpecification *specification, ETableColumnSpecification *column_spec) { GPtrArray *columns; gint column_index = -1; guint ii; g_return_val_if_fail (E_IS_TABLE_SPECIFICATION (specification), -1); g_return_val_if_fail (E_IS_TABLE_COLUMN_SPECIFICATION (column_spec), -1); columns = e_table_specification_ref_columns (specification); for (ii = 0; ii < columns->len; ii++) { gboolean column_specs_equal; column_specs_equal = e_table_column_specification_equal ( column_spec, columns->pdata[ii]); if (column_specs_equal) { column_index = (gint) ii; break; } } g_ptr_array_unref (columns); return column_index; } /** * e_table_specification_load_from_file: * @specification: an #ETableSpecification * @filename: the name of a file containing an #ETable specification * * Parses the contents of @filename and configures @specification. * * Returns: TRUE on success, FALSE on failure. */ gboolean e_table_specification_load_from_file (ETableSpecification *specification, const gchar *filename) { xmlDoc *doc; gboolean success = FALSE; g_return_val_if_fail (E_IS_TABLE_SPECIFICATION (specification), FALSE); g_return_val_if_fail (filename != NULL, FALSE); doc = e_xml_parse_file (filename); if (doc != NULL) { xmlNode *node = xmlDocGetRootElement (doc); e_table_specification_load_from_node (specification, node); xmlFreeDoc (doc); success = TRUE; } return success; } /** * e_table_specification_load_from_string: * @specification: an #ETableSpecification * @xml: a string containing an #ETable specification * * Parses the contents of @xml and configures @specification. * * @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; gboolean success = FALSE; g_return_val_if_fail (E_IS_TABLE_SPECIFICATION (specification), FALSE); g_return_val_if_fail (xml != NULL, FALSE); doc = xmlParseMemory ((gchar *) xml, strlen (xml)); if (doc != NULL) { xmlNode *node = xmlDocGetRootElement (doc); e_table_specification_load_from_node (specification, node); xmlFreeDoc (doc); success = TRUE; } return success; } /** * e_table_specification_load_from_node: * @specification: an #ETableSpecification * @node: an #xmlNode containing an #ETable specification * * Parses the contents of @node and configures @specification. */ void e_table_specification_load_from_node (ETableSpecification *specification, const xmlNode *node) { gchar *temp; xmlNode *children; 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; g_ptr_array_set_size (specification->priv->columns, 0); 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); g_ptr_array_add (specification->priv->columns, col_spec); } else if (specification->state == NULL && !strcmp ((gchar *) children->name, "ETableState")) { specification->state = e_table_state_new (specification); 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) specification->state = e_table_state_vanilla (specification); }