diff options
author | Stefano Karapetsas <stefano@karapetsas.com> | 2014-04-23 21:59:06 +0200 |
---|---|---|
committer | Stefano Karapetsas <stefano@karapetsas.com> | 2014-04-23 21:59:06 +0200 |
commit | 018dc694f53f4d87337212cc46fd719ecbc6967e (patch) | |
tree | dd9e9b3dd1b3b4bdac80bf3a41c4ac30734b6df7 /libmate-desktop/mate-aboutdialog.c | |
parent | d5f84c22d8b1917ea29a90c44fe7154d5a549a5c (diff) | |
download | mate-desktop-018dc694f53f4d87337212cc46fd719ecbc6967e.tar.bz2 mate-desktop-018dc694f53f4d87337212cc46fd719ecbc6967e.tar.xz |
libmate-desktop: Add MateAboutDialog class
This will allow MATE applications to use traditional About dialogs with GTK 3
(unfortunately completely different starting from GTK 3.12).
This is just a fork of GtkAboutDialog of GTK 2.24, adapted to work with GTK 3 too.
Diffstat (limited to 'libmate-desktop/mate-aboutdialog.c')
-rw-r--r-- | libmate-desktop/mate-aboutdialog.c | 2264 |
1 files changed, 2264 insertions, 0 deletions
diff --git a/libmate-desktop/mate-aboutdialog.c b/libmate-desktop/mate-aboutdialog.c new file mode 100644 index 0000000..08bd2cb --- /dev/null +++ b/libmate-desktop/mate-aboutdialog.c @@ -0,0 +1,2264 @@ +/* + * mate-aboutdialog.c: Traditional GTK+ About Dialog + * + * Copyright (C) 2001 CodeFactory AB + * Copyright (C) 2001, 2002 Anders Carlsson + * Copyright (C) 2003, 2004 Matthias Clasen <mclasen@redhat.com> + * Copyright (C) 2014 Stefano Karapetsas <stefano@karapetsas.com> + * + * This file is part of the Mate Library. + * + * The Mate Library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public License as + * published by the Free Software Foundation; either version 2 of the + * License, or (at your option) any later version. + * + * The Mate Library 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 + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with the Mate Library; see the file COPYING.LIB. If not, + * write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + * Boston, MA 02110-1301, USA. + * + * Author: Stefano Karapetsas <stefano@karapetsas.com> + */ + +#include "config.h" + +#include "mate-aboutdialog.h" + +#include <string.h> + +#include <gdk/gdkkeysyms.h> +#if GTK_CHECK_VERSION (3, 0, 0) +#include <gdk/gdkkeysyms-compat.h> +#endif +#include <gtk/gtk.h> +#include <glib/gi18n-lib.h> + + +/** + * The #MateAboutDialog offers a simple way to display information about + * a program like its logo, name, copyright, website and license. It is + * also possible to give credits to the authors, documenters, translators + * and artists who have worked on the program. An about dialog is typically + * opened when the user selects the <literal>About</literal> option from + * the <literal>Help</literal> menu. All parts of the dialog are optional. + * + * To make constructing a #MateAboutDialog as convenient as possible, you can + * use the function mate_show_about_dialog() which constructs and shows a dialog + * and keeps it around so that it can be shown again. + * + * Note that GTK+ sets a default title of <literal>_("About %s")</literal> + * on the dialog window (where %s is replaced by the name of the + * application, but in order to ensure proper translation of the title, + * applications should set the title property explicitly when constructing + * a #MateAboutDialog, as shown in the following example: + * <informalexample><programlisting> + * mate_show_about_dialog (NULL, + * "program-name", "ExampleCode", + * "logo", example_logo, + * "title" _("About ExampleCode"), + * NULL); + * </programlisting></informalexample> + */ + + +static GdkColor default_link_color = { 0, 0, 0, 0xeeee }; +static GdkColor default_visited_link_color = { 0, 0x5555, 0x1a1a, 0x8b8b }; + +typedef struct _MateAboutDialogPrivate MateAboutDialogPrivate; +struct _MateAboutDialogPrivate +{ + gchar *name; + gchar *version; + gchar *copyright; + gchar *comments; + gchar *website_url; + gchar *website_text; + gchar *translator_credits; + gchar *license; + + gchar **authors; + gchar **documenters; + gchar **artists; + + GtkWidget *logo_image; + GtkWidget *name_label; + GtkWidget *comments_label; + GtkWidget *copyright_label; + GtkWidget *website_label; + + GtkWidget *credits_button; + GtkWidget *credits_dialog; + GtkWidget *license_button; + GtkWidget *license_dialog; + + GdkCursor *hand_cursor; + GdkCursor *regular_cursor; + + GSList *visited_links; + + guint hovering_over_link : 1; + guint wrap_license : 1; +}; + +#define MATE_ABOUT_DIALOG_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), MATE_TYPE_ABOUT_DIALOG, MateAboutDialogPrivate)) + + +enum +{ + PROP_0, + PROP_NAME, + PROP_VERSION, + PROP_COPYRIGHT, + PROP_COMMENTS, + PROP_WEBSITE, + PROP_WEBSITE_LABEL, + PROP_LICENSE, + PROP_AUTHORS, + PROP_DOCUMENTERS, + PROP_TRANSLATOR_CREDITS, + PROP_ARTISTS, + PROP_LOGO, + PROP_LOGO_ICON_NAME, + PROP_WRAP_LICENSE +}; + +static void mate_about_dialog_finalize (GObject *object); +static void mate_about_dialog_get_property (GObject *object, + guint prop_id, + GValue *value, + GParamSpec *pspec); +static void mate_about_dialog_set_property (GObject *object, + guint prop_id, + const GValue *value, + GParamSpec *pspec); +static void mate_about_dialog_show (GtkWidget *widge); +static void update_name_version (MateAboutDialog *about); +static GtkIconSet * icon_set_new_from_pixbufs (GList *pixbufs); +static void follow_if_link (MateAboutDialog *about, + GtkTextView *text_view, + GtkTextIter *iter); +static void set_cursor_if_appropriate (MateAboutDialog *about, + GtkTextView *text_view, + gint x, + gint y); +static void display_credits_dialog (GtkWidget *button, + gpointer data); +static void display_license_dialog (GtkWidget *button, + gpointer data); +static void close_cb (MateAboutDialog *about); +static gboolean mate_about_dialog_activate_link (MateAboutDialog *about, + const gchar *uri); + +static void default_url_hook (MateAboutDialog *about, + const gchar *uri, + gpointer user_data); +static void default_email_hook (MateAboutDialog *about, + const gchar *email_address, + gpointer user_data); + +static void +default_url_hook (MateAboutDialog *about, + const gchar *uri, + gpointer user_data) +{ + GdkScreen *screen; + GError *error = NULL; + + screen = gtk_widget_get_screen (GTK_WIDGET (about)); + + if (!gtk_show_uri (screen, uri, gtk_get_current_event_time (), &error)) + { + GtkWidget *dialog; + + dialog = gtk_message_dialog_new (GTK_WINDOW (about), + GTK_DIALOG_DESTROY_WITH_PARENT | + GTK_DIALOG_MODAL, + GTK_MESSAGE_ERROR, + GTK_BUTTONS_CLOSE, + "%s", _("Could not show link")); + gtk_message_dialog_format_secondary_text (GTK_MESSAGE_DIALOG (dialog), + "%s", error->message); + g_error_free (error); + + g_signal_connect (dialog, "response", + G_CALLBACK (gtk_widget_destroy), NULL); + + gtk_window_present (GTK_WINDOW (dialog)); + } +} + +static void +default_email_hook (MateAboutDialog *about, + const gchar *email_address, + gpointer user_data) +{ + char *escaped, *uri; + + escaped = g_uri_escape_string (email_address, NULL, FALSE); + uri = g_strdup_printf ("mailto:%s", escaped); + g_free (escaped); + + default_url_hook (about, uri, user_data); + g_free (uri); +} + +G_DEFINE_TYPE (MateAboutDialog, mate_about_dialog, GTK_TYPE_DIALOG) + +static void +mate_about_dialog_class_init (MateAboutDialogClass *klass) +{ + GObjectClass *object_class; + GtkWidgetClass *widget_class; + + object_class = (GObjectClass *)klass; + widget_class = (GtkWidgetClass *)klass; + + object_class->set_property = mate_about_dialog_set_property; + object_class->get_property = mate_about_dialog_get_property; + + object_class->finalize = mate_about_dialog_finalize; + + widget_class->show = mate_about_dialog_show; + + /** + * MateAboutDialog:program-name: + * + * The name of the program. + * If this is not set, it defaults to g_get_application_name(). + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_NAME, + g_param_spec_string ("program-name", + N_("Program name"), + N_("The name of the program. If this is not set, it defaults to g_get_application_name()"), + NULL, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:version: + * + * The version of the program. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_VERSION, + g_param_spec_string ("version", + N_("Program version"), + N_("The version of the program"), + NULL, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:copyright: + * + * Copyright information for the program. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_COPYRIGHT, + g_param_spec_string ("copyright", + N_("Copyright string"), + N_("Copyright information for the program"), + NULL, + G_PARAM_READWRITE)); + + + /** + * MateAboutDialog:comments: + * + * Comments about the program. This string is displayed in a label + * in the main dialog, thus it should be a short explanation of + * the main purpose of the program, not a detailed list of features. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_COMMENTS, + g_param_spec_string ("comments", + N_("Comments string"), + N_("Comments about the program"), + NULL, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:license: + * + * The license of the program. This string is displayed in a + * text view in a secondary dialog, therefore it is fine to use + * a long multi-paragraph text. Note that the text is only wrapped + * in the text view if the "wrap-license" property is set to %TRUE; + * otherwise the text itself must contain the intended linebreaks. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_LICENSE, + g_param_spec_string ("license", + _("License"), + _("The license of the program"), + NULL, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:website: + * + * The URL for the link to the website of the program. + * This should be a string starting with "http://. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_WEBSITE, + g_param_spec_string ("website", + N_("Website URL"), + N_("The URL for the link to the website of the program"), + NULL, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:website-label: + * + * The label for the link to the website of the program. If this is not set, + * it defaults to the URL specified in the #MateAboutDialog:website property. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_WEBSITE_LABEL, + g_param_spec_string ("website-label", + N_("Website label"), + N_("The label for the link to the website of the program. If this is not set, it defaults to the URL"), + NULL, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:authors: + * + * The authors of the program, as a %NULL-terminated array of strings. + * Each string may contain email addresses and URLs, which will be displayed + * as links, see the introduction for more details. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_AUTHORS, + g_param_spec_boxed ("authors", + N_("Authors"), + N_("List of authors of the program"), + G_TYPE_STRV, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:documenters: + * + * The people documenting the program, as a %NULL-terminated array of strings. + * Each string may contain email addresses and URLs, which will be displayed + * as links, see the introduction for more details. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_DOCUMENTERS, + g_param_spec_boxed ("documenters", + N_("Documenters"), + N_("List of people documenting the program"), + G_TYPE_STRV, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:artists: + * + * The people who contributed artwork to the program, as a %NULL-terminated + * array of strings. Each string may contain email addresses and URLs, which + * will be displayed as links, see the introduction for more details. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_ARTISTS, + g_param_spec_boxed ("artists", + N_("Artists"), + N_("List of people who have contributed artwork to the program"), + G_TYPE_STRV, + G_PARAM_READWRITE)); + + + /** + * MateAboutDialog:translator-credits: + * + * Credits to the translators. This string should be marked as translatable. + * The string may contain email addresses and URLs, which will be displayed + * as links, see the introduction for more details. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_TRANSLATOR_CREDITS, + g_param_spec_string ("translator-credits", + N_("Translator credits"), + N_("Credits to the translators. This string should be marked as translatable"), + NULL, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:logo: + * + * A logo for the about box. If this is not set, it defaults to + * gtk_window_get_default_icon_list(). + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_LOGO, + g_param_spec_object ("logo", + N_("Logo"), + N_("A logo for the about box. If this is not set, it defaults to gtk_window_get_default_icon_list()"), + GDK_TYPE_PIXBUF, + G_PARAM_READWRITE)); + + /** + * MateAboutDialog:logo-icon-name: + * + * A named icon to use as the logo for the about box. This property + * overrides the #MateAboutDialog:logo property. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_LOGO_ICON_NAME, + g_param_spec_string ("logo-icon-name", + N_("Logo Icon Name"), + N_("A named icon to use as the logo for the about box."), + NULL, + G_PARAM_READWRITE)); + /** + * MateAboutDialog:wrap-license: + * + * Whether to wrap the text in the license dialog. + * + * Since: 1.9 + */ + g_object_class_install_property (object_class, + PROP_WRAP_LICENSE, + g_param_spec_boolean ("wrap-license", + N_("Wrap license"), + N_("Whether to wrap the license text."), + FALSE, + G_PARAM_READWRITE)); + + + g_type_class_add_private (object_class, sizeof (MateAboutDialogPrivate)); +} + +static void +mate_about_dialog_init (MateAboutDialog *about) +{ + GtkDialog *dialog = GTK_DIALOG (about); + MateAboutDialogPrivate *priv; + GtkWidget *vbox, *hbox, *button, *close_button, *image; + + /* Data */ + priv = MATE_ABOUT_DIALOG_GET_PRIVATE (about); + about->private_data = priv; + + priv->name = NULL; + priv->version = NULL; + priv->copyright = NULL; + priv->comments = NULL; + priv->website_url = NULL; + priv->website_text = NULL; + priv->translator_credits = NULL; + priv->license = NULL; + priv->authors = NULL; + priv->documenters = NULL; + priv->artists = NULL; + + priv->hand_cursor = gdk_cursor_new (GDK_HAND2); + priv->regular_cursor = gdk_cursor_new (GDK_XTERM); + priv->hovering_over_link = FALSE; + priv->wrap_license = FALSE; + + gtk_container_set_border_width (GTK_CONTAINER (dialog), 5); + gtk_box_set_spacing (GTK_BOX (gtk_dialog_get_content_area (dialog)), 2); /* 2 * 5 + 2 = 12 */ + gtk_container_set_border_width (GTK_CONTAINER (gtk_dialog_get_action_area (dialog)), 5); + + /* Widgets */ + gtk_widget_push_composite_child (); + + vbox = gtk_vbox_new (FALSE, 8); + gtk_container_set_border_width (GTK_CONTAINER (vbox), 5); + gtk_box_pack_start (GTK_BOX (gtk_dialog_get_content_area (dialog)), vbox, TRUE, TRUE, 0); + + priv->logo_image = gtk_image_new (); + gtk_box_pack_start (GTK_BOX (vbox), priv->logo_image, FALSE, FALSE, 0); + + priv->name_label = gtk_label_new (NULL); + gtk_label_set_selectable (GTK_LABEL (priv->name_label), TRUE); + gtk_label_set_justify (GTK_LABEL (priv->name_label), GTK_JUSTIFY_CENTER); + gtk_box_pack_start (GTK_BOX (vbox), priv->name_label, FALSE, FALSE, 0); + + priv->comments_label = gtk_label_new (NULL); + gtk_label_set_selectable (GTK_LABEL (priv->comments_label), TRUE); + gtk_label_set_justify (GTK_LABEL (priv->comments_label), GTK_JUSTIFY_CENTER); + gtk_label_set_line_wrap (GTK_LABEL (priv->comments_label), TRUE); + gtk_box_pack_start (GTK_BOX (vbox), priv->comments_label, FALSE, FALSE, 0); + + priv->copyright_label = gtk_label_new (NULL); + gtk_label_set_selectable (GTK_LABEL (priv->copyright_label), TRUE); + gtk_label_set_justify (GTK_LABEL (priv->copyright_label), GTK_JUSTIFY_CENTER); + gtk_box_pack_start (GTK_BOX (vbox), priv->copyright_label, FALSE, FALSE, 0); + + hbox = gtk_hbox_new (TRUE, 0); + gtk_box_pack_start (GTK_BOX (vbox), hbox, TRUE, FALSE, 0); + + priv->website_label = button = gtk_label_new (""); + gtk_widget_set_no_show_all (button, TRUE); + gtk_label_set_selectable (GTK_LABEL (button), TRUE); + gtk_box_pack_start (GTK_BOX (hbox), button, FALSE, FALSE, 0); + g_signal_connect_swapped (button, "activate-link", + G_CALLBACK (mate_about_dialog_activate_link), about); + + gtk_widget_show (vbox); + gtk_widget_show (priv->logo_image); + gtk_widget_show (priv->name_label); + gtk_widget_show (hbox); + + /* Add the close button */ + close_button = gtk_dialog_add_button (GTK_DIALOG (about), GTK_STOCK_CLOSE, + GTK_RESPONSE_CANCEL); + gtk_dialog_set_default_response (GTK_DIALOG (about), GTK_RESPONSE_CANCEL); + + /* Add the credits button */ + button = gtk_button_new_with_mnemonic (_("C_redits")); + gtk_widget_set_can_default (button, TRUE); + image = gtk_image_new_from_stock (GTK_STOCK_ABOUT, GTK_ICON_SIZE_BUTTON); + gtk_button_set_image (GTK_BUTTON (button), image); + gtk_widget_set_no_show_all (button, TRUE); + gtk_box_pack_end (GTK_BOX (gtk_dialog_get_action_area (GTK_DIALOG (about))), + button, FALSE, TRUE, 0); + gtk_button_box_set_child_secondary (GTK_BUTTON_BOX (gtk_dialog_get_action_area (GTK_DIALOG (about))), button, TRUE); + g_signal_connect (button, "clicked", + G_CALLBACK (display_credits_dialog), about); + priv->credits_button = button; + priv->credits_dialog = NULL; + + /* Add the license button */ + button = gtk_button_new_from_stock (_("_License")); + gtk_widget_set_can_default (button, TRUE); + gtk_widget_set_no_show_all (button, TRUE); + gtk_box_pack_end (GTK_BOX (gtk_dialog_get_action_area (GTK_DIALOG (about))), + button, FALSE, TRUE, 0); + gtk_button_box_set_child_secondary (GTK_BUTTON_BOX (gtk_dialog_get_action_area (GTK_DIALOG (about))), button, TRUE); + g_signal_connect (button, "clicked", + G_CALLBACK (display_license_dialog), about); + priv->license_button = button; + priv->license_dialog = NULL; + + gtk_window_set_resizable (GTK_WINDOW (about), FALSE); + + gtk_widget_pop_composite_child (); + + gtk_widget_grab_default (close_button); + gtk_widget_grab_focus (close_button); + + /* force defaults */ + mate_about_dialog_set_program_name (about, NULL); + mate_about_dialog_set_logo (about, NULL); +} + +static void +mate_about_dialog_finalize (GObject *object) +{ + MateAboutDialog *about = MATE_ABOUT_DIALOG (object); + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + + g_free (priv->name); + g_free (priv->version); + g_free (priv->copyright); + g_free (priv->comments); + g_free (priv->license); + g_free (priv->website_url); + g_free (priv->website_text); + g_free (priv->translator_credits); + + g_strfreev (priv->authors); + g_strfreev (priv->documenters); + g_strfreev (priv->artists); + + g_slist_foreach (priv->visited_links, (GFunc)g_free, NULL); + g_slist_free (priv->visited_links); + + gdk_cursor_unref (priv->hand_cursor); + gdk_cursor_unref (priv->regular_cursor); + + G_OBJECT_CLASS (mate_about_dialog_parent_class)->finalize (object); +} + +static void +mate_about_dialog_set_property (GObject *object, + guint prop_id, + const GValue *value, + GParamSpec *pspec) +{ + MateAboutDialog *about = MATE_ABOUT_DIALOG (object); + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + + switch (prop_id) + { + case PROP_NAME: + mate_about_dialog_set_program_name (about, g_value_get_string (value)); + break; + case PROP_VERSION: + mate_about_dialog_set_version (about, g_value_get_string (value)); + break; + case PROP_COMMENTS: + mate_about_dialog_set_comments (about, g_value_get_string (value)); + break; + case PROP_WEBSITE: + mate_about_dialog_set_website (about, g_value_get_string (value)); + break; + case PROP_WEBSITE_LABEL: + mate_about_dialog_set_website_label (about, g_value_get_string (value)); + break; + case PROP_LICENSE: + mate_about_dialog_set_license (about, g_value_get_string (value)); + break; + case PROP_COPYRIGHT: + mate_about_dialog_set_copyright (about, g_value_get_string (value)); + break; + case PROP_LOGO: + mate_about_dialog_set_logo (about, g_value_get_object (value)); + break; + case PROP_AUTHORS: + mate_about_dialog_set_authors (about, (const gchar**)g_value_get_boxed (value)); + break; + case PROP_DOCUMENTERS: + mate_about_dialog_set_documenters (about, (const gchar**)g_value_get_boxed (value)); + break; + case PROP_ARTISTS: + mate_about_dialog_set_artists (about, (const gchar**)g_value_get_boxed (value)); + break; + case PROP_TRANSLATOR_CREDITS: + mate_about_dialog_set_translator_credits (about, g_value_get_string (value)); + break; + case PROP_LOGO_ICON_NAME: + mate_about_dialog_set_logo_icon_name (about, g_value_get_string (value)); + break; + case PROP_WRAP_LICENSE: + priv->wrap_license = g_value_get_boolean (value); + break; + default: + G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); + break; + } +} + +static void +mate_about_dialog_get_property (GObject *object, + guint prop_id, + GValue *value, + GParamSpec *pspec) +{ + MateAboutDialog *about = MATE_ABOUT_DIALOG (object); + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + + switch (prop_id) + { + case PROP_NAME: + g_value_set_string (value, priv->name); + break; + case PROP_VERSION: + g_value_set_string (value, priv->version); + break; + case PROP_COPYRIGHT: + g_value_set_string (value, priv->copyright); + break; + case PROP_COMMENTS: + g_value_set_string (value, priv->comments); + break; + case PROP_WEBSITE: + g_value_set_string (value, priv->website_url); + break; + case PROP_WEBSITE_LABEL: + g_value_set_string (value, priv->website_text); + break; + case PROP_LICENSE: + g_value_set_string (value, priv->license); + break; + case PROP_TRANSLATOR_CREDITS: + g_value_set_string (value, priv->translator_credits); + break; + case PROP_AUTHORS: + g_value_set_boxed (value, priv->authors); + break; + case PROP_DOCUMENTERS: + g_value_set_boxed (value, priv->documenters); + break; + case PROP_ARTISTS: + g_value_set_boxed (value, priv->artists); + break; + case PROP_LOGO: + if (gtk_image_get_storage_type (GTK_IMAGE (priv->logo_image)) == GTK_IMAGE_PIXBUF) + g_value_set_object (value, gtk_image_get_pixbuf (GTK_IMAGE (priv->logo_image))); + else + g_value_set_object (value, NULL); + break; + case PROP_LOGO_ICON_NAME: + if (gtk_image_get_storage_type (GTK_IMAGE (priv->logo_image)) == GTK_IMAGE_ICON_NAME) + { + const gchar *icon_name; + + gtk_image_get_icon_name (GTK_IMAGE (priv->logo_image), &icon_name, NULL); + g_value_set_string (value, icon_name); + } + else + g_value_set_string (value, NULL); + break; + case PROP_WRAP_LICENSE: + g_value_set_boolean (value, priv->wrap_license); + break; + default: + G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); + break; + } +} + +static gboolean +mate_about_dialog_activate_link (MateAboutDialog *about, + const gchar *uri) +{ + if (g_str_has_prefix (uri, "mailto:")) + { + gchar *email; + + email = g_uri_unescape_string (uri + strlen ("mailto:"), NULL); + + default_email_hook (about, email, NULL); + + g_free (email); + } + else + { + default_url_hook (about, uri, NULL); + } + + return TRUE; +} + +static void +update_website (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + + gtk_widget_show (priv->website_label); + + if (priv->website_url) + { + gchar *markup; + + if (priv->website_text) + { + gchar *escaped; + + escaped = g_markup_escape_text (priv->website_text, -1); + markup = g_strdup_printf ("<a href=\"%s\">%s</a>", + priv->website_url, escaped); + g_free (escaped); + } + else + { + markup = g_strdup_printf ("<a href=\"%s\">%s</a>", + priv->website_url, priv->website_url); + } + + gtk_label_set_markup (GTK_LABEL (priv->website_label), markup); + g_free (markup); + } + else + { + gtk_widget_hide (priv->website_label); + } +} + +static void +mate_about_dialog_show (GtkWidget *widget) +{ + update_website (MATE_ABOUT_DIALOG (widget)); + + GTK_WIDGET_CLASS (mate_about_dialog_parent_class)->show (widget); +} + +/** + * mate_about_dialog_get_program_name: + * @about: a #MateAboutDialog + * + * Returns the program name displayed in the about dialog. + * + * Return value: The program name. The string is owned by the about + * dialog and must not be modified. + * + * Since: 1.9 */ +const gchar * +mate_about_dialog_get_program_name (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return priv->name; +} + +static void +update_name_version (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + gchar *title_string, *name_string; + + priv = (MateAboutDialogPrivate *)about->private_data; + + title_string = g_strdup_printf (_("About %s"), priv->name); + gtk_window_set_title (GTK_WINDOW (about), title_string); + g_free (title_string); + + if (priv->version != NULL) + name_string = g_markup_printf_escaped ("<span size=\"xx-large\" weight=\"bold\">%s %s</span>", + priv->name, priv->version); + else + name_string = g_markup_printf_escaped ("<span size=\"xx-large\" weight=\"bold\">%s</span>", + priv->name); + + gtk_label_set_markup (GTK_LABEL (priv->name_label), name_string); + + g_free (name_string); +} + +/** + * mate_about_dialog_set_program_name: + * @about: a #MateAboutDialog + * @name: the program name + * + * Sets the name to display in the about dialog. + * If this is not set, it defaults to g_get_application_name(). + * + * Since: 1.9 + */ +void +mate_about_dialog_set_program_name (MateAboutDialog *about, + const gchar *name) +{ + MateAboutDialogPrivate *priv; + gchar *tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + tmp = priv->name; + priv->name = g_strdup (name ? name : g_get_application_name ()); + g_free (tmp); + + update_name_version (about); + + g_object_notify (G_OBJECT (about), "program-name"); +} + + +/** + * mate_about_dialog_get_version: + * @about: a #MateAboutDialog + * + * Returns the version string. + * + * Return value: The version string. The string is owned by the about + * dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * +mate_about_dialog_get_version (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return priv->version; +} + +/** + * mate_about_dialog_set_version: + * @about: a #MateAboutDialog + * @version: (allow-none): the version string + * + * Sets the version string to display in the about dialog. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_version (MateAboutDialog *about, + const gchar *version) +{ + MateAboutDialogPrivate *priv; + gchar *tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->version; + priv->version = g_strdup (version); + g_free (tmp); + + update_name_version (about); + + g_object_notify (G_OBJECT (about), "version"); +} + +/** + * mate_about_dialog_get_copyright: + * @about: a #MateAboutDialog + * + * Returns the copyright string. + * + * Return value: The copyright string. The string is owned by the about + * dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * +mate_about_dialog_get_copyright (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return priv->copyright; +} + +/** + * mate_about_dialog_set_copyright: + * @about: a #MateAboutDialog + * @copyright: (allow-none) the copyright string + * + * Sets the copyright string to display in the about dialog. + * This should be a short string of one or two lines. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_copyright (MateAboutDialog *about, + const gchar *copyright) +{ + MateAboutDialogPrivate *priv; + gchar *copyright_string, *tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->copyright; + priv->copyright = g_strdup (copyright); + g_free (tmp); + + if (priv->copyright != NULL) + { + copyright_string = g_markup_printf_escaped ("<span size=\"small\">%s</span>", + priv->copyright); + gtk_label_set_markup (GTK_LABEL (priv->copyright_label), copyright_string); + g_free (copyright_string); + + gtk_widget_show (priv->copyright_label); + } + else + gtk_widget_hide (priv->copyright_label); + + g_object_notify (G_OBJECT (about), "copyright"); +} + +/** + * mate_about_dialog_get_comments: + * @about: a #MateAboutDialog + * + * Returns the comments string. + * + * Return value: The comments. The string is owned by the about + * dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * +mate_about_dialog_get_comments (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return priv->comments; +} + +/** + * mate_about_dialog_set_comments: + * @about: a #MateAboutDialog + * @comments: (allow-none): a comments string + * + * Sets the comments string to display in the about dialog. + * This should be a short string of one or two lines. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_comments (MateAboutDialog *about, + const gchar *comments) +{ + MateAboutDialogPrivate *priv; + gchar *tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->comments; + if (comments) + { + priv->comments = g_strdup (comments); + gtk_label_set_text (GTK_LABEL (priv->comments_label), priv->comments); + gtk_widget_show (priv->comments_label); + } + else + { + priv->comments = NULL; + gtk_widget_hide (priv->comments_label); + } + g_free (tmp); + + g_object_notify (G_OBJECT (about), "comments"); +} + +/** + * mate_about_dialog_get_license: + * @about: a #MateAboutDialog + * + * Returns the license information. + * + * Return value: The license information. The string is owned by the about + * dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * +mate_about_dialog_get_license (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return priv->license; +} + +/** + * mate_about_dialog_set_license: + * @about: a #MateAboutDialog + * @license: (allow-none): the license information or %NULL + * + * Sets the license information to be displayed in the secondary + * license dialog. If @license is %NULL, the license button is + * hidden. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_license (MateAboutDialog *about, + const gchar *license) +{ + MateAboutDialogPrivate *priv; + gchar *tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->license; + if (license) + { + priv->license = g_strdup (license); + gtk_widget_show (priv->license_button); + } + else + { + priv->license = NULL; + gtk_widget_hide (priv->license_button); + } + g_free (tmp); + + g_object_notify (G_OBJECT (about), "license"); +} + +/** + * mate_about_dialog_get_wrap_license: + * @about: a #MateAboutDialog + * + * Returns whether the license text in @about is + * automatically wrapped. + * + * Returns: %TRUE if the license text is wrapped + * + * Since: 1.9 + */ +gboolean +mate_about_dialog_get_wrap_license (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), FALSE); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return priv->wrap_license; +} + +/** + * mate_about_dialog_set_wrap_license: + * @about: a #MateAboutDialog + * @wrap_license: whether to wrap the license + * + * Sets whether the license text in @about is + * automatically wrapped. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_wrap_license (MateAboutDialog *about, + gboolean wrap_license) +{ + MateAboutDialogPrivate *priv; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + wrap_license = wrap_license != FALSE; + + if (priv->wrap_license != wrap_license) + { + priv->wrap_license = wrap_license; + + g_object_notify (G_OBJECT (about), "wrap-license"); + } +} + +/** + * mate_about_dialog_get_website: + * @about: a #MateAboutDialog + * + * Returns the website URL. + * + * Return value: The website URL. The string is owned by the about + * dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * +mate_about_dialog_get_website (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return priv->website_url; +} + +/** + * mate_about_dialog_set_website: + * @about: a #MateAboutDialog + * @website: (allow-none): a URL string starting with "http://" + * + * Sets the URL to use for the website link. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_website (MateAboutDialog *about, + const gchar *website) +{ + MateAboutDialogPrivate *priv; + gchar *tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->website_url; + priv->website_url = g_strdup (website); + g_free (tmp); + + update_website (about); + + g_object_notify (G_OBJECT (about), "website"); +} + +/** + * mate_about_dialog_get_website_label: + * @about: a #MateAboutDialog + * + * Returns the label used for the website link. + * + * Return value: The label used for the website link. The string is + * owned by the about dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * +mate_about_dialog_get_website_label (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return priv->website_text; +} + +/** + * mate_about_dialog_set_website_label: + * @about: a #MateAboutDialog + * @website_label: the label used for the website link + * + * Sets the label to be used for the website link. + * It defaults to the website URL. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_website_label (MateAboutDialog *about, + const gchar *website_label) +{ + MateAboutDialogPrivate *priv; + gchar *tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->website_text; + priv->website_text = g_strdup (website_label); + g_free (tmp); + + update_website (about); + + g_object_notify (G_OBJECT (about), "website-label"); +} + +/** + * mate_about_dialog_get_authors: + * @about: a #MateAboutDialog + * + * Returns the string which are displayed in the authors tab + * of the secondary credits dialog. + * + * Return value: (array zero-terminated=1) (transfer none): A + * %NULL-terminated string array containing the authors. The array is + * owned by the about dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * const * +mate_about_dialog_get_authors (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return (const gchar * const *) priv->authors; +} + +static void +update_credits_button_visibility (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv = about->private_data; + gboolean show; + + show = priv->authors != NULL || + priv->documenters != NULL || + priv->artists != NULL || + (priv->translator_credits != NULL && + strcmp (priv->translator_credits, "translator_credits") && + strcmp (priv->translator_credits, "translator-credits")); + if (show) + gtk_widget_show (priv->credits_button); + else + gtk_widget_hide (priv->credits_button); +} + +/** + * mate_about_dialog_set_authors: + * @about: a #MateAboutDialog + * @authors: a %NULL-terminated array of strings + * + * Sets the strings which are displayed in the authors tab + * of the secondary credits dialog. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_authors (MateAboutDialog *about, + const gchar **authors) +{ + MateAboutDialogPrivate *priv; + gchar **tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->authors; + priv->authors = g_strdupv ((gchar **)authors); + g_strfreev (tmp); + + update_credits_button_visibility (about); + + g_object_notify (G_OBJECT (about), "authors"); +} + +/** + * mate_about_dialog_get_documenters: + * @about: a #MateAboutDialog + * + * Returns the string which are displayed in the documenters + * tab of the secondary credits dialog. + * + * Return value: (array zero-terminated=1) (transfer none): A + * %NULL-terminated string array containing the documenters. The + * array is owned by the about dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * const * +mate_about_dialog_get_documenters (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return (const gchar * const *)priv->documenters; +} + +/** + * mate_about_dialog_set_documenters: + * @about: a #MateAboutDialog + * @documenters: a %NULL-terminated array of strings + * + * Sets the strings which are displayed in the documenters tab + * of the secondary credits dialog. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_documenters (MateAboutDialog *about, + const gchar **documenters) +{ + MateAboutDialogPrivate *priv; + gchar **tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->documenters; + priv->documenters = g_strdupv ((gchar **)documenters); + g_strfreev (tmp); + + update_credits_button_visibility (about); + + g_object_notify (G_OBJECT (about), "documenters"); +} + +/** + * mate_about_dialog_get_artists: + * @about: a #MateAboutDialog + * + * Returns the string which are displayed in the artists tab + * of the secondary credits dialog. + * + * Return value: (array zero-terminated=1) (transfer none): A + * %NULL-terminated string array containing the artists. The array is + * owned by the about dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * const * +mate_about_dialog_get_artists (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return (const gchar * const *)priv->artists; +} + +/** + * mate_about_dialog_set_artists: + * @about: a #MateAboutDialog + * @artists: a %NULL-terminated array of strings + * + * Sets the strings which are displayed in the artists tab + * of the secondary credits dialog. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_artists (MateAboutDialog *about, + const gchar **artists) +{ + MateAboutDialogPrivate *priv; + gchar **tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->artists; + priv->artists = g_strdupv ((gchar **)artists); + g_strfreev (tmp); + + update_credits_button_visibility (about); + + g_object_notify (G_OBJECT (about), "artists"); +} + +/** + * mate_about_dialog_get_translator_credits: + * @about: a #MateAboutDialog + * + * Returns the translator credits string which is displayed + * in the translators tab of the secondary credits dialog. + * + * Return value: The translator credits string. The string is + * owned by the about dialog and must not be modified. + * + * Since: 1.9 + */ +const gchar * +mate_about_dialog_get_translator_credits (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + return priv->translator_credits; +} + +/** + * mate_about_dialog_set_translator_credits: + * @about: a #MateAboutDialog + * @translator_credits: (allow-none): the translator credits + * + * Sets the translator credits string which is displayed in + * the translators tab of the secondary credits dialog. + * + * The intended use for this string is to display the translator + * of the language which is currently used in the user interface. + * Using gettext(), a simple way to achieve that is to mark the + * string for translation: + * |[ + * mate_about_dialog_set_translator_credits (about, _("translator-credits")); + * ]| + * It is a good idea to use the customary msgid "translator-credits" for this + * purpose, since translators will already know the purpose of that msgid, and + * since #MateAboutDialog will detect if "translator-credits" is untranslated + * and hide the tab. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_translator_credits (MateAboutDialog *about, + const gchar *translator_credits) +{ + MateAboutDialogPrivate *priv; + gchar *tmp; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + tmp = priv->translator_credits; + priv->translator_credits = g_strdup (translator_credits); + g_free (tmp); + + update_credits_button_visibility (about); + + g_object_notify (G_OBJECT (about), "translator-credits"); +} + +/** + * mate_about_dialog_get_logo: + * @about: a #MateAboutDialog + * + * Returns the pixbuf displayed as logo in the about dialog. + * + * Return value: (transfer none): the pixbuf displayed as logo. The + * pixbuf is owned by the about dialog. If you want to keep a + * reference to it, you have to call g_object_ref() on it. + * + * Since: 1.9 + */ +GdkPixbuf * +mate_about_dialog_get_logo (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + if (gtk_image_get_storage_type (GTK_IMAGE (priv->logo_image)) == GTK_IMAGE_PIXBUF) + return gtk_image_get_pixbuf (GTK_IMAGE (priv->logo_image)); + else + return NULL; +} + +static GtkIconSet * +icon_set_new_from_pixbufs (GList *pixbufs) +{ + GtkIconSet *icon_set = gtk_icon_set_new (); + + for (; pixbufs; pixbufs = pixbufs->next) + { + GdkPixbuf *pixbuf = GDK_PIXBUF (pixbufs->data); + + GtkIconSource *icon_source = gtk_icon_source_new (); + gtk_icon_source_set_pixbuf (icon_source, pixbuf); + gtk_icon_set_add_source (icon_set, icon_source); + gtk_icon_source_free (icon_source); + } + + return icon_set; +} + +/** + * mate_about_dialog_set_logo: + * @about: a #MateAboutDialog + * @logo: (allow-none): a #GdkPixbuf, or %NULL + * + * Sets the pixbuf to be displayed as logo in the about dialog. + * If it is %NULL, the default window icon set with + * gtk_window_set_default_icon() will be used. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_logo (MateAboutDialog *about, + GdkPixbuf *logo) +{ + MateAboutDialogPrivate *priv; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + g_object_freeze_notify (G_OBJECT (about)); + + if (gtk_image_get_storage_type (GTK_IMAGE (priv->logo_image)) == GTK_IMAGE_ICON_NAME) + g_object_notify (G_OBJECT (about), "logo-icon-name"); + + if (logo != NULL) + gtk_image_set_from_pixbuf (GTK_IMAGE (priv->logo_image), logo); + else + { + GList *pixbufs = gtk_window_get_default_icon_list (); + + if (pixbufs != NULL) + { + GtkIconSet *icon_set = icon_set_new_from_pixbufs (pixbufs); + + gtk_image_set_from_icon_set (GTK_IMAGE (priv->logo_image), + icon_set, GTK_ICON_SIZE_DIALOG); + + gtk_icon_set_unref (icon_set); + g_list_free (pixbufs); + } + } + + g_object_notify (G_OBJECT (about), "logo"); + + g_object_thaw_notify (G_OBJECT (about)); +} + +/** + * mate_about_dialog_get_logo_icon_name: + * @about: a #MateAboutDialog + * + * Returns the icon name displayed as logo in the about dialog. + * + * Return value: the icon name displayed as logo. The string is + * owned by the dialog. If you want to keep a reference + * to it, you have to call g_strdup() on it. + * + * Since: 1.9 + */ +const gchar * +mate_about_dialog_get_logo_icon_name (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv; + const gchar *icon_name = NULL; + + g_return_val_if_fail (MATE_IS_ABOUT_DIALOG (about), NULL); + + priv = (MateAboutDialogPrivate *)about->private_data; + + if (gtk_image_get_storage_type (GTK_IMAGE (priv->logo_image)) == GTK_IMAGE_ICON_NAME) + gtk_image_get_icon_name (GTK_IMAGE (priv->logo_image), &icon_name, NULL); + + return icon_name; +} + +/** + * mate_about_dialog_set_logo_icon_name: + * @about: a #MateAboutDialog + * @icon_name: (allow-none): an icon name, or %NULL + * + * Sets the pixbuf to be displayed as logo in the about dialog. + * If it is %NULL, the default window icon set with + * gtk_window_set_default_icon() will be used. + * + * Since: 1.9 + */ +void +mate_about_dialog_set_logo_icon_name (MateAboutDialog *about, + const gchar *icon_name) +{ + MateAboutDialogPrivate *priv; + + g_return_if_fail (MATE_IS_ABOUT_DIALOG (about)); + + priv = (MateAboutDialogPrivate *)about->private_data; + + g_object_freeze_notify (G_OBJECT (about)); + + if (gtk_image_get_storage_type (GTK_IMAGE (priv->logo_image)) == GTK_IMAGE_PIXBUF) + g_object_notify (G_OBJECT (about), "logo"); + + gtk_image_set_from_icon_name (GTK_IMAGE (priv->logo_image), icon_name, + GTK_ICON_SIZE_DIALOG); + g_object_notify (G_OBJECT (about), "logo-icon-name"); + + g_object_thaw_notify (G_OBJECT (about)); +} + +static void +follow_if_link (MateAboutDialog *about, + GtkTextView *text_view, + GtkTextIter *iter) +{ + GSList *tags = NULL, *tagp = NULL; + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + gchar *uri = NULL; + + tags = gtk_text_iter_get_tags (iter); + for (tagp = tags; tagp != NULL && !uri; tagp = tagp->next) + { + GtkTextTag *tag = tagp->data; + + uri = g_object_get_data (G_OBJECT (tag), "uri"); + + if (uri && !g_slist_find_custom (priv->visited_links, uri, (GCompareFunc)strcmp)) + { + GdkColor *style_visited_link_color; + GdkColor color; + + gtk_widget_ensure_style (GTK_WIDGET (about)); + gtk_widget_style_get (GTK_WIDGET (about), + "visited-link-color", &style_visited_link_color, + NULL); + if (style_visited_link_color) + { + color = *style_visited_link_color; + gdk_color_free (style_visited_link_color); + } + else + color = default_visited_link_color; + + g_object_set (G_OBJECT (tag), "foreground-gdk", &color, NULL); + + priv->visited_links = g_slist_prepend (priv->visited_links, g_strdup (uri)); + } + } + + if (tags) + g_slist_free (tags); +} + +static gboolean +text_view_key_press_event (GtkWidget *text_view, + GdkEventKey *event, + MateAboutDialog *about) +{ + GtkTextIter iter; + GtkTextBuffer *buffer; + + switch (event->keyval) + { + case GDK_Return: + case GDK_ISO_Enter: + case GDK_KP_Enter: + buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (text_view)); + gtk_text_buffer_get_iter_at_mark (buffer, &iter, + gtk_text_buffer_get_insert (buffer)); + follow_if_link (about, GTK_TEXT_VIEW (text_view), &iter); + break; + + default: + break; + } + + return FALSE; +} + +static gboolean +text_view_event_after (GtkWidget *text_view, + GdkEvent *event, + MateAboutDialog *about) +{ + GtkTextIter start, end, iter; + GtkTextBuffer *buffer; + GdkEventButton *button_event; + gint x, y; + + if (event->type != GDK_BUTTON_RELEASE) + return FALSE; + + button_event = (GdkEventButton *)event; + + if (button_event->button != 1) + return FALSE; + + buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (text_view)); + + /* we shouldn't follow a link if the user has selected something */ + gtk_text_buffer_get_selection_bounds (buffer, &start, &end); + if (gtk_text_iter_get_offset (&start) != gtk_text_iter_get_offset (&end)) + return FALSE; + + gtk_text_view_window_to_buffer_coords (GTK_TEXT_VIEW (text_view), + GTK_TEXT_WINDOW_WIDGET, + button_event->x, button_event->y, &x, &y); + + gtk_text_view_get_iter_at_location (GTK_TEXT_VIEW (text_view), &iter, x, y); + + follow_if_link (about, GTK_TEXT_VIEW (text_view), &iter); + + return FALSE; +} + +static void +set_cursor_if_appropriate (MateAboutDialog *about, + GtkTextView *text_view, + gint x, + gint y) +{ + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + GSList *tags = NULL, *tagp = NULL; + GtkTextIter iter; + gboolean hovering_over_link = FALSE; + + gtk_text_view_get_iter_at_location (text_view, &iter, x, y); + + tags = gtk_text_iter_get_tags (&iter); + for (tagp = tags; tagp != NULL; tagp = tagp->next) + { + GtkTextTag *tag = tagp->data; + gchar *uri = g_object_get_data (G_OBJECT (tag), "uri"); + + if (uri != NULL) + { + hovering_over_link = TRUE; + break; + } + } + + if (hovering_over_link != priv->hovering_over_link) + { + priv->hovering_over_link = hovering_over_link; + + if (hovering_over_link) + gdk_window_set_cursor (gtk_text_view_get_window (text_view, GTK_TEXT_WINDOW_TEXT), priv->hand_cursor); + else + gdk_window_set_cursor (gtk_text_view_get_window (text_view, GTK_TEXT_WINDOW_TEXT), priv->regular_cursor); + } + + if (tags) + g_slist_free (tags); +} + +static gboolean +text_view_motion_notify_event (GtkWidget *text_view, + GdkEventMotion *event, + MateAboutDialog *about) +{ + gint x, y; + + gtk_text_view_window_to_buffer_coords (GTK_TEXT_VIEW (text_view), + GTK_TEXT_WINDOW_WIDGET, + event->x, event->y, &x, &y); + + set_cursor_if_appropriate (about, GTK_TEXT_VIEW (text_view), x, y); + + gdk_event_request_motions (event); + + return FALSE; +} + + +static gboolean +text_view_visibility_notify_event (GtkWidget *text_view, + GdkEventVisibility *event, + MateAboutDialog *about) +{ + gint wx, wy, bx, by; + + gdk_window_get_pointer (gtk_widget_get_window (text_view), &wx, &wy, NULL); + + gtk_text_view_window_to_buffer_coords (GTK_TEXT_VIEW (text_view), + GTK_TEXT_WINDOW_WIDGET, + wx, wy, &bx, &by); + + set_cursor_if_appropriate (about, GTK_TEXT_VIEW (text_view), bx, by); + + return FALSE; +} + +static GtkWidget * +text_view_new (MateAboutDialog *about, + GtkWidget *dialog, + gchar **strings, + GtkWrapMode wrap_mode) +{ + gchar **p; + gchar *q0, *q1, *q2, *r1, *r2; + GtkWidget *view; + GtkTextView *text_view; + GtkTextBuffer *buffer; + GdkColor *style_link_color; + GdkColor *style_visited_link_color; + GdkColor color; + GdkColor link_color; + GdkColor visited_link_color; + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + + gtk_widget_ensure_style (GTK_WIDGET (about)); + gtk_widget_style_get (GTK_WIDGET (about), + "link-color", &style_link_color, + "visited-link-color", &style_visited_link_color, + NULL); + if (style_link_color) + { + link_color = *style_link_color; + gdk_color_free (style_link_color); + } + else + link_color = default_link_color; + + if (style_visited_link_color) + { + visited_link_color = *style_visited_link_color; + gdk_color_free (style_visited_link_color); + } + else + visited_link_color = default_visited_link_color; + + view = gtk_text_view_new (); + text_view = GTK_TEXT_VIEW (view); + buffer = gtk_text_view_get_buffer (text_view); + gtk_text_view_set_cursor_visible (text_view, FALSE); + gtk_text_view_set_editable (text_view, FALSE); + gtk_text_view_set_wrap_mode (text_view, wrap_mode); + + gtk_text_view_set_left_margin (text_view, 8); + gtk_text_view_set_right_margin (text_view, 8); + + g_signal_connect (view, "key-press-event", + G_CALLBACK (text_view_key_press_event), about); + g_signal_connect (view, "event-after", + G_CALLBACK (text_view_event_after), about); + g_signal_connect (view, "motion-notify-event", + G_CALLBACK (text_view_motion_notify_event), about); + g_signal_connect (view, "visibility-notify-event", + G_CALLBACK (text_view_visibility_notify_event), about); + + if (strings == NULL) + { + gtk_widget_hide (view); + return view; + } + + for (p = strings; *p; p++) + { + q0 = *p; + while (*q0) + { + q1 = strchr (q0, '<'); + q2 = q1 ? strchr (q1, '>') : NULL; + r1 = strstr (q0, "http://"); + if (r1) + { + r2 = strpbrk (r1, " \n\t"); + if (!r2) + r2 = strchr (r1, '\0'); + } + else + r2 = NULL; + + if (r1 && r2 && (!q1 || !q2 || (r1 < q1))) + { + q1 = r1; + q2 = r2; + } + + if (q1 && q2) + { + GtkTextIter end; + gchar *link; + gchar *uri; + const gchar *link_type; + GtkTextTag *tag; + + if (*q1 == '<') + { + gtk_text_buffer_insert_at_cursor (buffer, q0, (q1 - q0) + 1); + gtk_text_buffer_get_end_iter (buffer, &end); + q1++; + link_type = "email"; + } + else + { + gtk_text_buffer_insert_at_cursor (buffer, q0, q1 - q0); + gtk_text_buffer_get_end_iter (buffer, &end); + link_type = "uri"; + } + + q0 = q2; + + link = g_strndup (q1, q2 - q1); + + if (g_slist_find_custom (priv->visited_links, link, (GCompareFunc)strcmp)) + color = visited_link_color; + else + color = link_color; + + tag = gtk_text_buffer_create_tag (buffer, NULL, + "foreground-gdk", &color, + "underline", PANGO_UNDERLINE_SINGLE, + NULL); + if (strcmp (link_type, "email") == 0) + { + gchar *escaped; + + escaped = g_uri_escape_string (link, NULL, FALSE); + uri = g_strconcat ("mailto:", escaped, NULL); + g_free (escaped); + } + else + { + uri = g_strdup (link); + } + g_object_set_data_full (G_OBJECT (tag), "uri", uri, g_free); + gtk_text_buffer_insert_with_tags (buffer, &end, link, -1, tag, NULL); + + g_free (link); + } + else + { + gtk_text_buffer_insert_at_cursor (buffer, q0, -1); + break; + } + } + + if (p[1]) + gtk_text_buffer_insert_at_cursor (buffer, "\n", 1); + } + + gtk_widget_show (view); + return view; +} + +static void +add_credits_page (MateAboutDialog *about, + GtkWidget *credits_dialog, + GtkWidget *notebook, + gchar *title, + gchar **people) +{ + GtkWidget *sw, *view; + + view = text_view_new (about, credits_dialog, people, GTK_WRAP_NONE); + + sw = gtk_scrolled_window_new (NULL, NULL); + gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (sw), + GTK_SHADOW_IN); + gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (sw), + GTK_POLICY_AUTOMATIC, + GTK_POLICY_AUTOMATIC); + gtk_container_add (GTK_CONTAINER (sw), view); + + gtk_notebook_append_page (GTK_NOTEBOOK (notebook), + sw, gtk_label_new (title)); +} + +static void +display_credits_dialog (GtkWidget *button, + gpointer data) +{ + MateAboutDialog *about = (MateAboutDialog *)data; + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + GtkWidget *dialog, *notebook; + GtkDialog *credits_dialog; + + if (priv->credits_dialog != NULL) + { + gtk_window_present (GTK_WINDOW (priv->credits_dialog)); + return; + } + + dialog = gtk_dialog_new_with_buttons (_("Credits"), + GTK_WINDOW (about), + GTK_DIALOG_DESTROY_WITH_PARENT, + GTK_STOCK_CLOSE, GTK_RESPONSE_CANCEL, + NULL); + credits_dialog = GTK_DIALOG (dialog); + gtk_container_set_border_width (GTK_CONTAINER (credits_dialog), 5); + gtk_box_set_spacing (GTK_BOX (gtk_dialog_get_content_area (credits_dialog)), 2); /* 2 * 5 + 2 = 12 */ + gtk_container_set_border_width (GTK_CONTAINER (gtk_dialog_get_action_area (credits_dialog)), 5); + + priv->credits_dialog = dialog; + gtk_window_set_default_size (GTK_WINDOW (dialog), 360, 260); + gtk_dialog_set_default_response (credits_dialog, GTK_RESPONSE_CANCEL); + + gtk_window_set_modal (GTK_WINDOW (dialog), + gtk_window_get_modal (GTK_WINDOW (about))); + + g_signal_connect (dialog, "response", + G_CALLBACK (gtk_widget_destroy), dialog); + g_signal_connect (dialog, "destroy", + G_CALLBACK (gtk_widget_destroyed), + &(priv->credits_dialog)); + + notebook = gtk_notebook_new (); + gtk_container_set_border_width (GTK_CONTAINER (notebook), 5); + gtk_box_pack_start (GTK_BOX (gtk_dialog_get_content_area (GTK_DIALOG (dialog))), notebook, TRUE, TRUE, 0); + + if (priv->authors != NULL) + add_credits_page (about, dialog, notebook, _("Written by"), priv->authors); + + if (priv->documenters != NULL) + add_credits_page (about, dialog, notebook, _("Documented by"), priv->documenters); + + /* Don't show an untranslated gettext msgid */ + if (priv->translator_credits != NULL && + strcmp (priv->translator_credits, "translator_credits") != 0 && + strcmp (priv->translator_credits, "translator-credits") != 0) + { + gchar *translators[2]; + + translators[0] = priv->translator_credits; + translators[1] = NULL; + + add_credits_page (about, dialog, notebook, _("Translated by"), translators); + } + + if (priv->artists != NULL) + add_credits_page (about, dialog, notebook, _("Artwork by"), priv->artists); + + gtk_widget_show_all (dialog); +} + +static void +set_policy (GtkWidget *sw) +{ + gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (sw), + GTK_POLICY_AUTOMATIC, + GTK_POLICY_AUTOMATIC); +} + +static void +display_license_dialog (GtkWidget *button, + gpointer data) +{ + MateAboutDialog *about = (MateAboutDialog *)data; + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + GtkWidget *dialog, *view, *sw; + GtkDialog *licence_dialog; + gchar *strings[2]; + + if (priv->license_dialog != NULL) + { + gtk_window_present (GTK_WINDOW (priv->license_dialog)); + return; + } + + dialog = gtk_dialog_new_with_buttons (_("License"), + GTK_WINDOW (about), + GTK_DIALOG_DESTROY_WITH_PARENT, + GTK_STOCK_CLOSE, GTK_RESPONSE_CANCEL, + NULL); + licence_dialog = GTK_DIALOG (dialog); + gtk_container_set_border_width (GTK_CONTAINER (licence_dialog), 5); + gtk_box_set_spacing (GTK_BOX (gtk_dialog_get_content_area (licence_dialog)), 2); /* 2 * 5 + 2 = 12 */ + gtk_container_set_border_width (GTK_CONTAINER (gtk_dialog_get_action_area (licence_dialog)), 5); + + priv->license_dialog = dialog; + gtk_window_set_default_size (GTK_WINDOW (dialog), 420, 320); + gtk_dialog_set_default_response (licence_dialog, GTK_RESPONSE_CANCEL); + + gtk_window_set_modal (GTK_WINDOW (dialog), + gtk_window_get_modal (GTK_WINDOW (about))); + + g_signal_connect (dialog, "response", + G_CALLBACK (gtk_widget_destroy), dialog); + g_signal_connect (dialog, "destroy", + G_CALLBACK (gtk_widget_destroyed), + &(priv->license_dialog)); + + sw = gtk_scrolled_window_new (NULL, NULL); + gtk_container_set_border_width (GTK_CONTAINER (sw), 5); + gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (sw), + GTK_SHADOW_IN); + gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (sw), + GTK_POLICY_NEVER, + GTK_POLICY_AUTOMATIC); + g_signal_connect (sw, "map", G_CALLBACK (set_policy), NULL); + gtk_box_pack_start (GTK_BOX (gtk_dialog_get_content_area (GTK_DIALOG (dialog))), sw, TRUE, TRUE, 0); + + strings[0] = priv->license; + strings[1] = NULL; + view = text_view_new (about, dialog, strings, + priv->wrap_license ? GTK_WRAP_WORD : GTK_WRAP_NONE); + + gtk_container_add (GTK_CONTAINER (sw), view); + + gtk_widget_show_all (dialog); +} + +/** + * mate_about_dialog_new: + * + * Creates a new #MateAboutDialog. + * + * Returns: a newly created #MateAboutDialog + * + * Since: 1.9 + */ +GtkWidget * +mate_about_dialog_new (void) +{ + MateAboutDialog *dialog = g_object_new (MATE_TYPE_ABOUT_DIALOG, NULL); + + return GTK_WIDGET (dialog); +} + +static void +close_cb (MateAboutDialog *about) +{ + MateAboutDialogPrivate *priv = (MateAboutDialogPrivate *)about->private_data; + + if (priv->license_dialog != NULL) + { + gtk_widget_destroy (priv->license_dialog); + priv->license_dialog = NULL; + } + + if (priv->credits_dialog != NULL) + { + gtk_widget_destroy (priv->credits_dialog); + priv->credits_dialog = NULL; + } + + gtk_widget_hide (GTK_WIDGET (about)); + +} + +/** + * gtk_show_about_dialog: + * @parent: (allow-none): transient parent, or %NULL for none + * @first_property_name: the name of the first property + * @Varargs: value of first property, followed by more properties, %NULL-terminated + * + * This is a convenience function for showing an application's about box. + * The constructed dialog is associated with the parent window and + * reused for future invocations of this function. + * + * Since: 1.9 + */ +void +mate_show_about_dialog (GtkWindow *parent, + const gchar *first_property_name, + ...) +{ + static GtkWidget *global_about_dialog = NULL; + GtkWidget *dialog = NULL; + va_list var_args; + + if (parent) + dialog = g_object_get_data (G_OBJECT (parent), "gtk-about-dialog"); + else + dialog = global_about_dialog; + + if (!dialog) + { + dialog = mate_about_dialog_new (); + + g_object_ref_sink (dialog); + + g_signal_connect (dialog, "delete-event", + G_CALLBACK (gtk_widget_hide_on_delete), NULL); + + /* Close dialog on user response */ + g_signal_connect (dialog, "response", + G_CALLBACK (close_cb), NULL); + + va_start (var_args, first_property_name); + g_object_set_valist (G_OBJECT (dialog), first_property_name, var_args); + va_end (var_args); + + if (parent) + { + gtk_window_set_transient_for (GTK_WINDOW (dialog), parent); + gtk_window_set_destroy_with_parent (GTK_WINDOW (dialog), TRUE); + g_object_set_data_full (G_OBJECT (parent), + "gtk-about-dialog", + dialog, g_object_unref); + } + else + global_about_dialog = dialog; + + } + + gtk_window_present (GTK_WINDOW (dialog)); +} |