/*
* 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.
*
* 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 General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program; if not, see <http://www.gnu.org/licenses/>.
*
*
* Authors:
* Chris Lahey <clahey@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_MISC_UTILS_H
#define E_MISC_UTILS_H
#include <sys/types.h>
#include <gtk/gtk.h>
#include <limits.h>
#include <libedataserver/libedataserver.h>
#include <e-util/e-marshal.h>
#include <e-util/e-util-enums.h>
G_BEGIN_DECLS
typedef enum {
E_FOCUS_NONE,
E_FOCUS_CURRENT,
E_FOCUS_START,
E_FOCUS_END
} EFocus;
typedef enum {
E_RESTORE_WINDOW_SIZE = 1 << 0,
E_RESTORE_WINDOW_POSITION = 1 << 1
} ERestoreWindowFlags;
typedef void (*EForeachFunc) (gint model_row,
gpointer closure);
const gchar * e_get_accels_filename (void);
void e_show_uri (GtkWindow *parent,
const gchar *uri);
void e_display_help (GtkWindow *parent,
const gchar *link_id);
void e_restore_window (GtkWindow *window,
const gchar *settings_path,
ERestoreWindowFlags flags);
GtkAction * e_lookup_action (GtkUIManager *ui_manager,
const gchar *action_name);
GtkActionGroup *e_lookup_action_group (GtkUIManager *ui_manager,
const gchar *group_name);
gint e_action_compare_by_label (GtkAction *action1,
GtkAction *action2);
void e_action_group_remove_all_actions
(GtkActionGroup *action_group);
GtkRadioAction *e_radio_action_get_current_action
(GtkRadioAction *radio_action);
void e_action_group_add_actions_localized
(GtkActionGroup *action_group,
const gchar *translation_domain,
const GtkActionEntry *entries,
guint n_entries,
gpointer user_data);
GtkWidget * e_builder_get_widget (GtkBuilder *builder,
const gchar *widget_name);
void e_load_ui_builder_definition (GtkBuilder *builder,
const gchar *basename);
guint e_load_ui_manager_definition (GtkUIManager *ui_manager,
const gchar *basename);
void e_categories_add_change_hook (GHookFunc func,
gpointer object);
/* String to/from double conversion functions */
gdouble e_flexible_strtod (const gchar *nptr,
gchar **endptr);
/* 29 bytes should enough for all possible values that
* g_ascii_dtostr can produce with the %.17g format.
* Then add 10 for good measure */
#define E_ASCII_DTOSTR_BUF_SIZE (DBL_DIG + 12 + 10)
gchar * e_ascii_dtostr (gchar *buffer,
gint buf_len,
const gchar *format,
gdouble d);
gchar * e_str_without_underscores (const gchar *string);
GString * e_str_replace_string (const gchar *text,
const gchar *find,
const gchar *replace);
gint e_str_compare (gconstpointer x,
gconstpointer y);
gint e_str_case_compare (gconstpointer x,
gconstpointer y);
gint e_collate_compare (gconstpointer x,
gconstpointer y);
gint e_int_compare (gconstpointer x,
gconstpointer y);
guint32 e_color_to_value (const GdkColor *color);
guint32 e_rgba_to_value (const GdkRGBA *rgba);
/* This only makes a filename safe for usage as a filename.
* It still may have shell meta-characters in it. */
gchar * e_format_number (gint number);
typedef gint (*ESortCompareFunc) (gconstpointer first,
gconstpointer second,
gpointer closure);
void e_bsearch (gconstpointer key,
gconstpointer base,
gsize nmemb,
gsize size,
ESortCompareFunc compare,
gpointer closure,
gsize *start,
gsize *end);
gsize e_strftime_fix_am_pm (gchar *str,
gsize max,
const gchar *fmt,
const struct tm *tm);
gsize e_utf8_strftime_fix_am_pm (gchar *str,
gsize max,
const gchar *fmt,
const struct tm *tm);
const gchar * e_get_month_name (GDateMonth month,
gboolean abbreviated);
const gchar * e_get_weekday_name (GDateWeekday weekday,
gboolean abbreviated);
GDateWeekday e_weekday_get_next (GDateWeekday weekday);
GDateWeekday e_weekday_get_prev (GDateWeekday weekday);
GDateWeekday e_weekday_add_days (GDateWeekday weekday,
guint n_days);
GDateWeekday e_weekday_subtract_days (GDateWeekday weekday,
guint n_days);
guint e_weekday_get_days_between (GDateWeekday weekday1,
GDateWeekday weekday2);
gint e_weekday_to_tm_wday (GDateWeekday weekday);
GDateWeekday e_weekday_from_tm_wday (gint tm_wday);
gboolean e_file_lock_create (void);
void e_file_lock_destroy (void);
gboolean e_file_lock_exists (void);
gchar * e_util_guess_mime_type (const gchar *filename,
gboolean localfile);
GSList * e_util_get_category_filter_options
(void);
GList * e_util_dup_searchable_categories (void);
gboolean e_util_allow_auth_prompt_and_refresh_client_sync
(EClient *client,
GCancellable *cancellable,
GError **error);
void e_util_allow_auth_prompt_and_refresh_client
(EClient *client,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
gboolean e_util_allow_auth_prompt_and_refresh_client_finish
(EClient *client,
GAsyncResult *result,
GError **error);
/* Useful GBinding transform functions */
gboolean e_binding_transform_color_to_string
(GBinding *binding,
const GValue *source_value,
GValue *target_value,
gpointer not_used);
gboolean e_binding_transform_string_to_color
(GBinding *binding,
const GValue *source_value,
GValue *target_value,
gpointer not_used);
gboolean e_binding_transform_source_to_uid
(GBinding *binding,
const GValue *source_value,
GValue *target_value,
ESourceRegistry *registry);
gboolean e_binding_transform_uid_to_source
(GBinding *binding,
const GValue *source_value,
GValue *target_value,
ESourceRegistry *registry);
gboolean e_binding_transform_text_non_null
(GBinding *binding,
const GValue *source_value,
GValue *target_value,
gpointer user_data);
GBinding * e_binding_bind_object_text_property
(gpointer source,
const gchar *source_property,
gpointer target,
const gchar *target_property,
GBindingFlags flags);
gulong e_signal_connect_notify (gpointer instance,
const gchar *notify_name,
GCallback c_handler,
gpointer user_data);
gulong e_signal_connect_notify_after (gpointer instance,
const gchar *notify_name,
GCallback c_handler,
gpointer user_data);
gulong e_signal_connect_notify_swapped (gpointer instance,
const gchar *notify_name,
GCallback c_handler,
gpointer user_data);
gulong e_signal_connect_notify_object (gpointer instance,
const gchar *notify_name,
GCallback c_handler,
gpointer gobject,
GConnectFlags connect_flags);
void e_signal_disconnect_notify_handler
(gpointer instance,
gulong *handler_id);
G_END_DECLS
#endif /* E_MISC_UTILS_H */
