/*
* e-shell-utils.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 <http://www.gnu.org/licenses/>
*
*
* Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
*
*/
/**
* SECTION: e-shell-utils
* @short_description: high-level utilities with shell integration
* @include: shell/e-shell-utils.h
**/
#include "e-shell-utils.h"
#include <glib/gi18n-lib.h>
#include "e-util/e-binding.h"
#include "widgets/misc/e-import-assistant.h"
/**
* e_shell_configure_ui_manager:
* @shell: an #EShell
* @ui_manager: an #EUIManager
*
* Adds shell integration to @ui_manager. In particular, it keeps
* @ui_manager's EUIManager:express-mode property synchronized with
* @shell's EShell:express-mode property.
**/
void
e_shell_configure_ui_manager (EShell *shell,
EUIManager *ui_manager)
{
EShellSettings *shell_settings;
g_return_if_fail (E_IS_SHELL (shell));
g_return_if_fail (E_IS_UI_MANAGER (ui_manager));
shell_settings = e_shell_get_shell_settings (shell);
e_binding_new (
shell, "express-mode",
ui_manager, "express-mode");
}
/**
* e_shell_configure_web_view:
* @shell: an #EShell
* @web_view: an #EWebView
*
* Adds shell integration to @web_view. In particular, it configures
* @web_view to honor the printing and save-to-disk lockdown options.
**/
void
e_shell_configure_web_view (EShell *shell,
EWebView *web_view)
{
EShellSettings *shell_settings;
g_return_if_fail (E_IS_SHELL (shell));
g_return_if_fail (E_IS_WEB_VIEW (web_view));
shell_settings = e_shell_get_shell_settings (shell);
#ifndef G_OS_WIN32
e_binding_new (
shell_settings, "disable-printing",
web_view, "disable-printing");
e_binding_new (
shell_settings, "disable-save-to-disk",
web_view, "disable-save-to-disk");
#endif
}
/**
* e_shell_run_open_dialog:
* @shell: an #EShell
* @title: file chooser dialog title
* @customize_func: optional dialog customization function
* @customize_data: optional data to pass to @customize_func
*
* Runs a #GtkFileChooserDialog in open mode with the given title and
* returns the selected #GFile. It automatically remembers the selected
* folder. If @customize_func is provided, the function is called just
* prior to running the dialog (the file chooser is the first argument,
* @customize data is the second). If the user cancels the dialog the
* function will return %NULL.
*
* Returns: the #GFile to open, or %NULL
**/
GFile *
e_shell_run_open_dialog (EShell *shell,
const gchar *title,
GtkCallback customize_func,
gpointer customize_data)
{
EShellSettings *shell_settings;
GtkFileChooser *file_chooser;
GFile *chosen_file = NULL;
GtkWidget *dialog;
GtkWindow *parent;
const gchar *property_name;
gchar *uri;
g_return_val_if_fail (E_IS_SHELL (shell), NULL);
property_name = "file-chooser-folder";
shell_settings = e_shell_get_shell_settings (shell);
parent = e_shell_get_active_window (shell);
dialog = gtk_file_chooser_dialog_new (
title, parent,
GTK_FILE_CHOOSER_ACTION_OPEN,
GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL,
GTK_STOCK_OPEN, GTK_RESPONSE_ACCEPT, NULL);
file_chooser = GTK_FILE_CHOOSER (dialog);
gtk_dialog_set_default_response (
GTK_DIALOG (dialog), GTK_RESPONSE_ACCEPT);
gtk_file_chooser_set_local_only (file_chooser, FALSE);
/* Restore the current folder from the previous file chooser. */
uri = e_shell_settings_get_string (shell_settings, property_name);
if (uri != NULL)
gtk_file_chooser_set_current_folder_uri (file_chooser, uri);
g_free (uri);
/* Allow further customizations before running the dialog. */
if (customize_func != NULL)
customize_func (dialog, customize_data);
if (gtk_dialog_run (GTK_DIALOG (dialog)) != GTK_RESPONSE_ACCEPT)
goto exit;
chosen_file = gtk_file_chooser_get_file (file_chooser);
/* Save the current folder for subsequent file choosers. */
uri = gtk_file_chooser_get_current_folder_uri (file_chooser);
e_shell_settings_set_string (shell_settings, property_name, uri);
g_free (uri);
exit:
gtk_widget_destroy (dialog);
return chosen_file;
}
/**
* e_shell_run_save_dialog:
* @shell: an #EShell
* @title: file chooser dialog title
* @suggestion: file name suggestion, or %NULL
* @filters: Possible filters for dialog, or %NULL
* @customize_func: optional dialog customization function
* @customize_data: optional data to pass to @customize_func
*
* Runs a #GtkFileChooserDialog in save mode with the given title and
* returns the selected #GFile. It automatically remembers the selected
* folder. If @customize_func is provided, the function is called just
* prior to running the dialog (the file chooser is the first argument,
* @customize_data is the second). If the user cancels the dialog the
* function will return %NULL.
*
* With non-%NULL @filters will be added also file filters to the dialog.
* The string format is "pat1:mt1;pat2:mt2:...", where 'pat' is a pattern
* and 'mt' is a MIME type for the pattern to be used.
* There can be more than one MIME type, those are separated by comma.
*
* Returns: the #GFile to save to, or %NULL
**/
GFile *
e_shell_run_save_dialog (EShell *shell,
const gchar *title,
const gchar *suggestion,
const gchar *filters,
GtkCallback customize_func,
gpointer customize_data)
{
EShellSettings *shell_settings;
GtkFileChooser *file_chooser;
GFile *chosen_file = NULL;
GtkWidget *dialog;
GtkWindow *parent;
const gchar *property_name;
gchar *uri;
g_return_val_if_fail (E_IS_SHELL (shell), NULL);
property_name = "file-chooser-folder";
shell_settings = e_shell_get_shell_settings (shell);
parent = e_shell_get_active_window (shell);
dialog = gtk_file_chooser_dialog_new (
title, parent,
GTK_FILE_CHOOSER_ACTION_SAVE,
GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL,
GTK_STOCK_SAVE, GTK_RESPONSE_ACCEPT, NULL);
file_chooser = GTK_FILE_CHOOSER (dialog);
gtk_dialog_set_default_response (
GTK_DIALOG (dialog), GTK_RESPONSE_ACCEPT);
gtk_file_chooser_set_local_only (file_chooser, FALSE);
gtk_file_chooser_set_do_overwrite_confirmation (file_chooser, TRUE);
/* Restore the current folder from the previous file chooser. */
uri = e_shell_settings_get_string (shell_settings, property_name);
if (uri != NULL)
gtk_file_chooser_set_current_folder_uri (file_chooser, uri);
g_free (uri);
if (suggestion != NULL)
gtk_file_chooser_set_current_name (file_chooser, suggestion);
if (filters != NULL) {
gchar **flts = g_strsplit (filters, ";", -1);
gint i;
for (i = 0; flts [i]; i++) {
GtkFileFilter *filter = gtk_file_filter_new ();
gchar *flt = flts [i];
gchar *delim = strchr (flt, ':'), *next = NULL;
if (delim) {
*delim = 0;
next = strchr (delim + 1, ',');
}
gtk_file_filter_add_pattern (filter, flt);
if (g_ascii_strcasecmp (flt, "*.mbox") == 0)
gtk_file_filter_set_name (filter, _("Berkeley Mailbox (mbox)"));
else if (g_ascii_strcasecmp (flt, "*.vcf") == 0)
gtk_file_filter_set_name (filter, _("vCard (.vcf)"));
else if (g_ascii_strcasecmp (flt, "*.ics") == 0)
gtk_file_filter_set_name (filter, _("iCalendar (.ics)"));
while (delim) {
delim++;
if (next)
*next = 0;
gtk_file_filter_add_mime_type (filter, delim);
delim = next;
if (next)
next = strchr (next + 1, ',');
}
gtk_file_chooser_add_filter (file_chooser, filter);
}
if (flts && flts [0]) {
GtkFileFilter *filter = gtk_file_filter_new ();
gtk_file_filter_add_pattern (filter, "*");
gtk_file_filter_set_name (filter, _("All Files (*)"));
gtk_file_chooser_add_filter (file_chooser, filter);
}
g_strfreev (flts);
}
/* Allow further customizations before running the dialog. */
if (customize_func != NULL)
customize_func (dialog, customize_data);
if (gtk_dialog_run (GTK_DIALOG (dialog)) != GTK_RESPONSE_ACCEPT)
goto exit;
chosen_file = gtk_file_chooser_get_file (file_chooser);
/* Save the current folder for subsequent file choosers. */
uri = gtk_file_chooser_get_current_folder_uri (file_chooser);
e_shell_settings_set_string (shell_settings, property_name, uri);
g_free (uri);
exit:
gtk_widget_destroy (dialog);
return chosen_file;
}
/**
* e_shell_utils_import_uris:
* @shell: The #EShell instance
* @uris: %NULL-terminated list of URIs to import or preview
* @preview: rather preview than import given URIs
*
* Imports given URIs to Evolution, giving user a choice what to import
* if more than one importer can be applied, and where to import it, if
* the importer itself is configurable. It can preview data, instead of
* importing if requested and the imported has that implemented.
*
* URIs should be either a filename or URI of form file://.
* All others are skipped.
*
* Returns: the number of URIs successfully handled
**/
guint
e_shell_utils_import_uris (EShell *shell, gchar **uris, gboolean preview)
{
GtkWindow *parent;
GtkWidget *assistant;
g_return_val_if_fail (shell != NULL, 0);
g_return_val_if_fail (uris != NULL, 0);
parent = e_shell_get_active_window (shell);
assistant = e_import_assistant_new_simple (parent, uris, preview);
if (assistant) {
g_signal_connect_after (
assistant, "cancel",
G_CALLBACK (gtk_widget_destroy), NULL);
g_signal_connect_after (
assistant, "finished",
G_CALLBACK (gtk_widget_destroy), NULL);
e_shell_watch_window (shell, GTK_WINDOW (assistant));
gtk_widget_show (assistant);
} else {
g_warning (
"%s: Cannot %s any of the given URIs",
G_STRFUNC, preview ? "preview" : "import");
}
return g_strv_length (uris);
}
/**
* e_shell_hide_widgets_for_express_mode:
* @shell: an #EShell
* @builder: a #GtkBuilder
* @key_with_widget_names: The name of a GConf key; see below.
*
* If Evolution is running in Express mode (i.e. if the specified @shell is in
* Express mode), then this function will first read the specified GConf key.
* This key must contain a string list, and each element of that list must be
* the name of a widget present in @builder. Those widgets will then get
* hidden.
*
* This can be used to simplify preference dialogs and such in an easy fashion, for use
* in Express mode.
*
* If Evolution is not running in Express mode, this function does nothing.
*/
void
e_shell_hide_widgets_for_express_mode (EShell *shell,
GtkBuilder *builder,
const char *key_with_widget_names)
{
GConfClient *client;
GSList *names;
GSList *l;
g_return_if_fail (E_IS_SHELL (shell));
g_return_if_fail (GTK_IS_BUILDER (builder));
g_return_if_fail (key_with_widget_names != NULL);
if (!e_shell_get_express_mode (shell))
return;
client = e_shell_get_gconf_client (shell);
names = gconf_client_get_list (client, key_with_widget_names, GCONF_VALUE_STRING, NULL); /* NULL-GError */
if (!names)
return;
for (l = names; l; l = l->next) {
const char *name;
GObject *object;
name = l->data;
object = gtk_builder_get_object (builder, name);
if (!object || !GTK_IS_WIDGET (object)) {
g_error ("Object '%s' was not found in the builder file, or it is not a GtkWidget", name);
g_assert_not_reached ();
}
gtk_widget_hide (GTK_WIDGET (object));
}
g_slist_foreach (names, (GFunc) g_free, NULL);
g_slist_free (names);
}
