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-selectable.h | 85 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 e-util/e-selectable.h (limited to 'e-util/e-selectable.h') diff --git a/e-util/e-selectable.h b/e-util/e-selectable.h new file mode 100644 index 0000000000..4e7faa8581 --- /dev/null +++ b/e-util/e-selectable.h @@ -0,0 +1,85 @@ +/* + * e-selectable.h + * + * 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 + * + * + * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com) + * + */ + +#if !defined (__E_UTIL_H_INSIDE__) && !defined (LIBEUTIL_COMPILATION) +#error "Only should be included directly." +#endif + +#ifndef E_SELECTABLE_H +#define E_SELECTABLE_H + +#include + +#include + +/* Standard GObject macros */ +#define E_TYPE_SELECTABLE \ + (e_selectable_get_type ()) +#define E_SELECTABLE(obj) \ + (G_TYPE_CHECK_INSTANCE_CAST \ + ((obj), E_TYPE_SELECTABLE, ESelectable)) +#define E_IS_SELECTABLE(obj) \ + (G_TYPE_CHECK_INSTANCE_TYPE \ + ((obj), E_TYPE_SELECTABLE)) +#define E_SELECTABLE_GET_INTERFACE(obj) \ + (G_TYPE_INSTANCE_GET_INTERFACE \ + ((obj), E_TYPE_SELECTABLE, ESelectableInterface)) + +G_BEGIN_DECLS + +typedef struct _ESelectable ESelectable; +typedef struct _ESelectableInterface ESelectableInterface; + +struct _ESelectableInterface { + GTypeInterface parent_iface; + + /* Required Methods */ + void (*update_actions) (ESelectable *selectable, + EFocusTracker *focus_tracker, + GdkAtom *clipboard_targets, + gint n_clipboard_targets); + + /* Optional Methods */ + void (*cut_clipboard) (ESelectable *selectable); + void (*copy_clipboard) (ESelectable *selectable); + void (*paste_clipboard) (ESelectable *selectable); + void (*delete_selection) (ESelectable *selectable); + void (*select_all) (ESelectable *selectable); +}; + +GType e_selectable_get_type (void); +void e_selectable_update_actions (ESelectable *selectable, + EFocusTracker *focus_tracker, + GdkAtom *clipboard_targets, + gint n_clipboard_targets); +void e_selectable_cut_clipboard (ESelectable *selectable); +void e_selectable_copy_clipboard (ESelectable *selectable); +void e_selectable_paste_clipboard (ESelectable *selectable); +void e_selectable_delete_selection (ESelectable *selectable); +void e_selectable_select_all (ESelectable *selectable); +GtkTargetList * e_selectable_get_copy_target_list + (ESelectable *selectable); +GtkTargetList * e_selectable_get_paste_target_list + (ESelectable *selectable); + +G_END_DECLS + +#endif /* E_SELECTABLE_H */ -- cgit v1.2.3