aboutsummaryrefslogtreecommitdiffstats
path: root/e-util/e-table-header.h
diff options
context:
space:
mode:
authorMatthew Barnes <mbarnes@redhat.com>2012-12-10 21:09:59 +0800
committerMatthew Barnes <mbarnes@redhat.com>2012-12-13 03:33:43 +0800
commitd09d8de870b6697c8a8b262e7e077b871a69b315 (patch)
tree3b718882e7a0bb0a996daf2967a033d91714c9b5 /e-util/e-table-header.h
parentb61331ed03ac1c7a9b8614e25510040b9c60ae02 (diff)
downloadgsoc2013-evolution-d09d8de870b6697c8a8b262e7e077b871a69b315.tar
gsoc2013-evolution-d09d8de870b6697c8a8b262e7e077b871a69b315.tar.gz
gsoc2013-evolution-d09d8de870b6697c8a8b262e7e077b871a69b315.tar.bz2
gsoc2013-evolution-d09d8de870b6697c8a8b262e7e077b871a69b315.tar.lz
gsoc2013-evolution-d09d8de870b6697c8a8b262e7e077b871a69b315.tar.xz
gsoc2013-evolution-d09d8de870b6697c8a8b262e7e077b871a69b315.tar.zst
gsoc2013-evolution-d09d8de870b6697c8a8b262e7e077b871a69b315.zip
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.
Diffstat (limited to 'e-util/e-table-header.h')
-rw-r--r--e-util/e-table-header.h144
1 files changed, 144 insertions, 0 deletions
diff --git a/e-util/e-table-header.h b/e-util/e-table-header.h
new file mode 100644
index 0000000000..298131eeed
--- /dev/null
+++ b/e-util/e-table-header.h
@@ -0,0 +1,144 @@
+/*
+ *
+ * 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 <http://www.gnu.org/licenses/>
+ *
+ *
+ * Authors:
+ * Chris Lahey <clahey@ximian.com>
+ * Miguel de Icaza <miguel@ximian.com>
+ *
+ * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
+ *
+ */
+
+#if !defined (__E_UTIL_H_INSIDE__) && !defined (LIBEUTIL_COMPILATION)
+#error "Only <e-util/e-util.h> should be included directly."
+#endif
+
+#ifndef _E_TABLE_COLUMN_H_
+#define _E_TABLE_COLUMN_H_
+
+#include <gdk/gdk.h>
+
+#include <e-util/e-table-col.h>
+#include <e-util/e-table-sort-info.h>
+
+/* Standard GObject macros */
+#define E_TYPE_TABLE_HEADER \
+ (e_table_header_get_type ())
+#define E_TABLE_HEADER(obj) \
+ (G_TYPE_CHECK_INSTANCE_CAST \
+ ((obj), E_TYPE_TABLE_HEADER, ETableHeader))
+#define E_TABLE_HEADER_CLASS(cls) \
+ (G_TYPE_CHECK_CLASS_CAST \
+ ((cls), E_TYPE_TABLE_HEADER, ETableHeaderClass))
+#define E_IS_TABLE_HEADER(obj) \
+ (G_TYPE_CHECK_INSTANCE_TYPE \
+ ((obj), E_TYPE_TABLE_HEADER))
+#define E_IS_TABLE_HEADER_CLASS(cls) \
+ (G_TYPE_CHECK_CLASS_TYPE \
+ ((cls), E_TYPE_TABLE_HEADER))
+#define E_TABLE_HEADER_GET_CLASS(obj) \
+ (G_TYPE_INSTANCE_GET_CLASS \
+ ((obj), E_TYPE_TABLE_HEADER, ETableHeaderClass))
+
+G_BEGIN_DECLS
+
+typedef struct _ETableHeader ETableHeader;
+typedef struct _ETableHeaderClass ETableHeaderClass;
+
+typedef gboolean (*ETableColCheckFunc) (ETableCol *col, gpointer user_data);
+
+/*
+ * A Column header.
+ */
+struct _ETableHeader {
+ GObject parent;
+
+ gint col_count;
+ gint width;
+ gint nominal_width;
+ gint width_extras;
+
+ ETableSortInfo *sort_info;
+ gint sort_info_group_change_id;
+
+ ETableCol **columns;
+
+ GSList *change_queue, *change_tail;
+ gint idle;
+};
+
+struct _ETableHeaderClass {
+ GObjectClass parent_class;
+
+ void (*structure_change) (ETableHeader *eth);
+ void (*dimension_change) (ETableHeader *eth,
+ gint width);
+ void (*expansion_change) (ETableHeader *eth);
+ gint (*request_width) (ETableHeader *eth,
+ gint col);
+};
+
+GType e_table_header_get_type (void) G_GNUC_CONST;
+ETableHeader * e_table_header_new (void);
+
+void e_table_header_add_column (ETableHeader *eth,
+ ETableCol *tc,
+ gint pos);
+ETableCol * e_table_header_get_column (ETableHeader *eth,
+ gint column);
+ETableCol * e_table_header_get_column_by_col_idx
+ (ETableHeader *eth,
+ gint col_idx);
+gint e_table_header_count (ETableHeader *eth);
+gint e_table_header_index (ETableHeader *eth,
+ gint col);
+gint e_table_header_get_index_at (ETableHeader *eth,
+ gint x_offset);
+ETableCol ** e_table_header_get_columns (ETableHeader *eth);
+gint e_table_header_get_selected (ETableHeader *eth);
+
+gint e_table_header_total_width (ETableHeader *eth);
+gint e_table_header_min_width (ETableHeader *eth);
+void e_table_header_move (ETableHeader *eth,
+ gint source_index,
+ gint target_index);
+void e_table_header_remove (ETableHeader *eth,
+ gint idx);
+void e_table_header_set_size (ETableHeader *eth,
+ gint idx,
+ gint size);
+void e_table_header_set_selection (ETableHeader *eth,
+ gboolean allow_selection);
+gint e_table_header_col_diff (ETableHeader *eth,
+ gint start_col,
+ gint end_col);
+
+void e_table_header_calc_widths (ETableHeader *eth);
+GList * e_table_header_get_selected_indexes
+ (ETableHeader *eth);
+void e_table_header_update_horizontal
+ (ETableHeader *eth);
+gint e_table_header_prioritized_column
+ (ETableHeader *eth);
+ETableCol * e_table_header_prioritized_column_selected
+ (ETableHeader *eth,
+ ETableColCheckFunc check_func,
+ gpointer user_data);
+
+G_END_DECLS
+
+#endif /* _E_TABLE_HEADER_H_ */
+