2 * gtkappchooserdialog.c: an app-chooser dialog
4 * Copyright (C) 2004 Novell, Inc.
5 * Copyright (C) 2007, 2010 Red Hat, Inc.
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public License as
9 * published by the Free Software Foundation; either version 2 of the
10 * License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
20 * Authors: Dave Camp <dave@novell.com>
21 * Alexander Larsson <alexl@redhat.com>
22 * Cosimo Cecchi <ccecchi@redhat.com>
26 * SECTION:gtkappchooserdialog
27 * @Title: GtkAppChooserDialog
28 * @Short_description: An application chooser dialog
30 * #GtkAppChooserDialog shows a #GtkAppChooserWidget inside a #GtkDialog.
32 * Note that #GtkAppChooserDialog does not have any interesting methods
33 * of its own. Instead, you should get the embedded #GtkAppChooserWidget
34 * using gtk_app_chooser_dialog_get_widget() and call its methods if
35 * the generic #GtkAppChooser interface is not sufficient for your needs.
37 * To set the heading that is shown above the #GtkAppChooserWidget,
38 * use gtk_app_chooser_dialog_set_heading().
42 #include "gtkappchooserdialog.h"
45 #include "gtkappchooser.h"
46 #include "gtkappchooseronline.h"
47 #include "gtkappchooserprivate.h"
48 #include "gtkappchooserprivate.h"
50 #include "gtkmessagedialog.h"
53 #include "gtkbutton.h"
54 #include "gtkmenuitem.h"
58 #include <glib/gi18n-lib.h>
61 #define sure_string(s) ((const char *) ((s) != NULL ? (s) : ""))
63 struct _GtkAppChooserDialogPrivate {
70 GtkWidget *online_button;
72 GtkWidget *open_label;
74 GtkWidget *app_chooser_widget;
75 GtkWidget *show_more_button;
77 GtkAppChooserOnline *online;
78 GCancellable *online_cancellable;
80 gboolean show_more_clicked;
90 static void gtk_app_chooser_dialog_iface_init (GtkAppChooserIface *iface);
91 G_DEFINE_TYPE_WITH_CODE (GtkAppChooserDialog, gtk_app_chooser_dialog, GTK_TYPE_DIALOG,
92 G_IMPLEMENT_INTERFACE (GTK_TYPE_APP_CHOOSER,
93 gtk_app_chooser_dialog_iface_init));
96 show_error_dialog (const gchar *primary,
97 const gchar *secondary,
100 GtkWidget *message_dialog;
102 message_dialog = gtk_message_dialog_new (parent, 0,
106 g_object_set (message_dialog,
108 "secondary-text", secondary,
110 gtk_dialog_set_default_response (GTK_DIALOG (message_dialog), GTK_RESPONSE_OK);
112 gtk_widget_show (message_dialog);
114 g_signal_connect (message_dialog, "response",
115 G_CALLBACK (gtk_widget_destroy), NULL);
119 search_for_mimetype_ready_cb (GObject *source,
123 GtkAppChooserOnline *online = GTK_APP_CHOOSER_ONLINE (source);
124 GtkAppChooserDialog *self = user_data;
125 GError *error = NULL;
127 gdk_threads_enter ();
129 _gtk_app_chooser_online_search_for_mimetype_finish (online, res, &error);
131 if (self->priv->dismissed)
135 !g_error_matches (error, G_IO_ERROR, G_IO_ERROR_CANCELLED))
137 show_error_dialog (_("Failed to look for applications online"),
138 error->message, GTK_WINDOW (self));
142 gtk_widget_set_sensitive (self->priv->online_button, TRUE);
143 gtk_app_chooser_refresh (GTK_APP_CHOOSER (self->priv->app_chooser_widget));
147 g_clear_object (&self->priv->online_cancellable);
148 g_clear_error (&error);
149 g_object_unref (self);
151 gdk_threads_leave ();
155 online_button_clicked_cb (GtkButton *b,
158 GtkAppChooserDialog *self = user_data;
160 self->priv->online_cancellable = g_cancellable_new ();
161 gtk_widget_set_sensitive (self->priv->online_button, FALSE);
163 _gtk_app_chooser_online_search_for_mimetype_async (self->priv->online,
164 self->priv->content_type,
166 self->priv->online_cancellable,
167 search_for_mimetype_ready_cb,
168 g_object_ref (self));
172 app_chooser_online_get_default_ready_cb (GObject *source,
176 GtkAppChooserDialog *self = user_data;
178 gdk_threads_enter ();
180 self->priv->online = _gtk_app_chooser_online_get_default_finish (source, res);
182 if (self->priv->online != NULL &&
183 !self->priv->dismissed)
185 GtkWidget *action_area;
187 action_area = gtk_dialog_get_action_area (GTK_DIALOG (self));
188 self->priv->online_button = gtk_button_new_with_mnemonic (_("_Find applications online"));
189 gtk_box_pack_start (GTK_BOX (action_area), self->priv->online_button,
191 gtk_button_box_set_child_secondary (GTK_BUTTON_BOX (action_area), self->priv->online_button,
193 g_signal_connect (self->priv->online_button, "clicked",
194 G_CALLBACK (online_button_clicked_cb), self);
197 if (!self->priv->content_type)
198 gtk_widget_set_sensitive (self->priv->online_button, FALSE);
200 gtk_widget_show (self->priv->online_button);
203 g_object_unref (self);
205 gdk_threads_leave ();
209 ensure_online_button (GtkAppChooserDialog *self)
211 _gtk_app_chooser_online_get_default_async (app_chooser_online_get_default_ready_cb,
212 g_object_ref (self));
216 add_or_find_application (GtkAppChooserDialog *self)
220 app = gtk_app_chooser_get_app_info (GTK_APP_CHOOSER (self));
224 /* we don't care about reporting errors here */
225 if (self->priv->content_type)
226 g_app_info_set_as_last_used_for_type (app,
227 self->priv->content_type,
229 g_object_unref (app);
234 cancel_and_clear_cancellable (GtkAppChooserDialog *self)
236 if (self->priv->online_cancellable != NULL)
238 g_cancellable_cancel (self->priv->online_cancellable);
239 g_clear_object (&self->priv->online_cancellable);
244 gtk_app_chooser_dialog_response (GtkDialog *dialog,
248 GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (dialog);
252 case GTK_RESPONSE_OK:
253 add_or_find_application (self);
255 case GTK_RESPONSE_CANCEL:
256 case GTK_RESPONSE_DELETE_EVENT:
257 cancel_and_clear_cancellable (self);
258 self->priv->dismissed = TRUE;
265 widget_application_selected_cb (GtkAppChooserWidget *widget,
269 GtkAppChooserDialog *self = user_data;
271 gtk_widget_set_sensitive (self->priv->button, TRUE);
275 widget_application_activated_cb (GtkAppChooserWidget *widget,
279 GtkAppChooserDialog *self = user_data;
281 gtk_dialog_response (GTK_DIALOG (self), GTK_RESPONSE_OK);
285 get_extension (const char *basename)
289 p = strrchr (basename, '.');
291 if (p && *(p + 1) != '\0')
292 return g_strdup (p + 1);
298 set_dialog_properties (GtkAppChooserDialog *self)
307 PangoFontDescription *font_desc;
315 if (self->priv->gfile != NULL)
317 name = g_file_get_basename (self->priv->gfile);
318 extension = get_extension (name);
321 if (self->priv->content_type)
323 description = g_content_type_get_description (self->priv->content_type);
324 unknown = g_content_type_is_unknown (self->priv->content_type);
327 gtk_window_set_title (GTK_WINDOW (self), "");
331 /* Translators: %s is a filename */
332 label = g_strdup_printf (_("Select an application to open \"%s\""), name);
333 string = g_strdup_printf (_("No applications available to open \"%s\""),
338 /* Translators: %s is a file type description */
339 label = g_strdup_printf (_("Select an application for \"%s\" files"),
340 unknown ? self->priv->content_type : description);
341 string = g_strdup_printf (_("No applications available to open \"%s\" files"),
342 unknown ? self->priv->content_type : description);
345 font_desc = pango_font_description_new ();
346 pango_font_description_set_weight (font_desc, PANGO_WEIGHT_BOLD);
347 gtk_widget_override_font (self->priv->label, font_desc);
348 pango_font_description_free (font_desc);
350 if (self->priv->heading != NULL)
351 gtk_label_set_markup (GTK_LABEL (self->priv->label), self->priv->heading);
353 gtk_label_set_markup (GTK_LABEL (self->priv->label), label);
355 default_text = g_strdup_printf ("<big><b>%s</b></big>\n%s",
357 _("Click \"Show other applications\", for more options, or "
358 "\"Find applications online\" to install a new application"));
360 gtk_app_chooser_widget_set_default_text (GTK_APP_CHOOSER_WIDGET (self->priv->app_chooser_widget),
366 g_free (description);
368 g_free (default_text);
372 show_more_button_clicked_cb (GtkButton *button,
375 GtkAppChooserDialog *self = user_data;
377 g_object_set (self->priv->app_chooser_widget,
378 "show-recommended", TRUE,
379 "show-fallback", TRUE,
383 gtk_widget_hide (self->priv->show_more_button);
384 self->priv->show_more_clicked = TRUE;
388 widget_notify_for_button_cb (GObject *source,
392 GtkAppChooserDialog *self = user_data;
393 GtkAppChooserWidget *widget = GTK_APP_CHOOSER_WIDGET (source);
394 gboolean should_hide;
396 should_hide = gtk_app_chooser_widget_get_show_other (widget) ||
397 self->priv->show_more_clicked;
400 gtk_widget_hide (self->priv->show_more_button);
404 forget_menu_item_activate_cb (GtkMenuItem *item,
407 GtkAppChooserDialog *self = user_data;
410 info = gtk_app_chooser_get_app_info (GTK_APP_CHOOSER (self));
414 g_app_info_remove_supports_type (info, self->priv->content_type, NULL);
416 gtk_app_chooser_refresh (GTK_APP_CHOOSER (self));
418 g_object_unref (info);
423 build_forget_menu_item (GtkAppChooserDialog *self)
427 retval = gtk_menu_item_new_with_label (_("Forget association"));
428 gtk_widget_show (retval);
430 g_signal_connect (retval, "activate",
431 G_CALLBACK (forget_menu_item_activate_cb), self);
437 widget_populate_popup_cb (GtkAppChooserWidget *widget,
442 GtkAppChooserDialog *self = user_data;
443 GtkWidget *menu_item;
445 if (g_app_info_can_remove_supports_type (info))
447 menu_item = build_forget_menu_item (self);
448 gtk_menu_shell_append (GTK_MENU_SHELL (menu), menu_item);
453 build_dialog_ui (GtkAppChooserDialog *self)
457 GtkWidget *button, *w;
460 gtk_container_set_border_width (GTK_CONTAINER (self), 5);
462 vbox = gtk_box_new (GTK_ORIENTATION_VERTICAL, 12);
463 gtk_container_set_border_width (GTK_CONTAINER (vbox), 5);
464 gtk_box_pack_start (GTK_BOX (gtk_dialog_get_content_area (GTK_DIALOG (self))), vbox, TRUE, TRUE, 0);
465 gtk_widget_show (vbox);
467 vbox2 = gtk_box_new (GTK_ORIENTATION_VERTICAL, 6);
468 gtk_box_pack_start (GTK_BOX (vbox), vbox2, TRUE, TRUE, 0);
469 gtk_widget_show (vbox2);
471 self->priv->label = gtk_label_new ("");
472 gtk_widget_set_halign (self->priv->label, GTK_ALIGN_START);
473 gtk_widget_set_valign (self->priv->label, GTK_ALIGN_CENTER);
474 gtk_label_set_line_wrap (GTK_LABEL (self->priv->label), TRUE);
475 gtk_box_pack_start (GTK_BOX (vbox2), self->priv->label,
477 gtk_widget_show (self->priv->label);
479 self->priv->app_chooser_widget =
480 gtk_app_chooser_widget_new (self->priv->content_type);
481 gtk_box_pack_start (GTK_BOX (vbox2), self->priv->app_chooser_widget, TRUE, TRUE, 0);
482 gtk_widget_show (self->priv->app_chooser_widget);
484 g_signal_connect (self->priv->app_chooser_widget, "application-selected",
485 G_CALLBACK (widget_application_selected_cb), self);
486 g_signal_connect (self->priv->app_chooser_widget, "application-activated",
487 G_CALLBACK (widget_application_activated_cb), self);
488 g_signal_connect (self->priv->app_chooser_widget, "notify::show-other",
489 G_CALLBACK (widget_notify_for_button_cb), self);
490 g_signal_connect (self->priv->app_chooser_widget, "populate-popup",
491 G_CALLBACK (widget_populate_popup_cb), self);
493 button = gtk_button_new_with_label (_("Show other applications"));
494 self->priv->show_more_button = button;
495 w = gtk_image_new_from_stock (GTK_STOCK_ADD,
496 GTK_ICON_SIZE_BUTTON);
497 gtk_button_set_image (GTK_BUTTON (button), w);
498 gtk_box_pack_start (GTK_BOX (self->priv->app_chooser_widget), button, FALSE, FALSE, 6);
499 gtk_widget_show_all (button);
501 g_signal_connect (button, "clicked",
502 G_CALLBACK (show_more_button_clicked_cb), self);
504 gtk_dialog_add_button (GTK_DIALOG (self),
506 GTK_RESPONSE_CANCEL);
508 self->priv->button = gtk_dialog_add_button (GTK_DIALOG (self),
512 info = gtk_app_chooser_get_app_info (GTK_APP_CHOOSER (self->priv->app_chooser_widget));
513 gtk_widget_set_sensitive (self->priv->button, info != NULL);
515 g_object_unref (info);
517 gtk_dialog_set_default_response (GTK_DIALOG (self),
522 set_gfile_and_content_type (GtkAppChooserDialog *self,
530 self->priv->gfile = g_object_ref (file);
532 info = g_file_query_info (self->priv->gfile,
533 G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE,
535 self->priv->content_type = g_strdup (g_file_info_get_content_type (info));
537 g_object_unref (info);
541 gtk_app_chooser_dialog_get_app_info (GtkAppChooser *object)
543 GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
544 return gtk_app_chooser_get_app_info (GTK_APP_CHOOSER (self->priv->app_chooser_widget));
548 gtk_app_chooser_dialog_refresh (GtkAppChooser *object)
550 GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
552 gtk_app_chooser_refresh (GTK_APP_CHOOSER (self->priv->app_chooser_widget));
556 gtk_app_chooser_dialog_constructed (GObject *object)
558 GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
560 if (G_OBJECT_CLASS (gtk_app_chooser_dialog_parent_class)->constructed != NULL)
561 G_OBJECT_CLASS (gtk_app_chooser_dialog_parent_class)->constructed (object);
563 build_dialog_ui (self);
564 set_dialog_properties (self);
565 ensure_online_button (self);
569 gtk_app_chooser_dialog_dispose (GObject *object)
571 GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
573 g_clear_object (&self->priv->gfile);
574 cancel_and_clear_cancellable (self);
575 g_clear_object (&self->priv->online);
577 G_OBJECT_CLASS (gtk_app_chooser_dialog_parent_class)->dispose (object);
581 gtk_app_chooser_dialog_finalize (GObject *object)
583 GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
585 g_free (self->priv->content_type);
587 G_OBJECT_CLASS (gtk_app_chooser_dialog_parent_class)->finalize (object);
591 gtk_app_chooser_dialog_set_property (GObject *object,
596 GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
601 set_gfile_and_content_type (self, g_value_get_object (value));
603 case PROP_CONTENT_TYPE:
604 /* don't try to override a value previously set with the GFile */
605 if (self->priv->content_type == NULL)
606 self->priv->content_type = g_value_dup_string (value);
609 gtk_app_chooser_dialog_set_heading (self, g_value_get_string (value));
612 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
618 gtk_app_chooser_dialog_get_property (GObject *object,
623 GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
628 if (self->priv->gfile != NULL)
629 g_value_set_object (value, self->priv->gfile);
631 case PROP_CONTENT_TYPE:
632 g_value_set_string (value, self->priv->content_type);
635 g_value_set_string (value, self->priv->heading);
638 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
644 gtk_app_chooser_dialog_iface_init (GtkAppChooserIface *iface)
646 iface->get_app_info = gtk_app_chooser_dialog_get_app_info;
647 iface->refresh = gtk_app_chooser_dialog_refresh;
651 gtk_app_chooser_dialog_class_init (GtkAppChooserDialogClass *klass)
653 GObjectClass *gobject_class;
656 gobject_class = G_OBJECT_CLASS (klass);
657 gobject_class->dispose = gtk_app_chooser_dialog_dispose;
658 gobject_class->finalize = gtk_app_chooser_dialog_finalize;
659 gobject_class->set_property = gtk_app_chooser_dialog_set_property;
660 gobject_class->get_property = gtk_app_chooser_dialog_get_property;
661 gobject_class->constructed = gtk_app_chooser_dialog_constructed;
663 g_object_class_override_property (gobject_class, PROP_CONTENT_TYPE, "content-type");
666 * GtkAppChooserDialog:gfile:
668 * The GFile used by the #GtkAppChooserDialog.
669 * The dialog's #GtkAppChooserWidget content type will be guessed from the
672 pspec = g_param_spec_object ("gfile",
674 P_("The GFile used by the app chooser dialog"),
676 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE |
677 G_PARAM_STATIC_STRINGS);
678 g_object_class_install_property (gobject_class, PROP_GFILE, pspec);
681 * GtkAppChooserDialog:heading:
683 * The text to show at the top of the dialog.
684 * The string may contain Pango markup.
686 pspec = g_param_spec_string ("heading",
688 P_("The text to show at the top of the dialog"),
690 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
691 g_object_class_install_property (gobject_class, PROP_HEADING, pspec);
694 g_type_class_add_private (klass, sizeof (GtkAppChooserDialogPrivate));
698 gtk_app_chooser_dialog_init (GtkAppChooserDialog *self)
700 self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, GTK_TYPE_APP_CHOOSER_DIALOG,
701 GtkAppChooserDialogPrivate);
703 /* we can't override the class signal handler here, as it's a RUN_LAST;
704 * we want our signal handler instead to be executed before any user code.
706 g_signal_connect (self, "response",
707 G_CALLBACK (gtk_app_chooser_dialog_response), NULL);
711 set_parent_and_flags (GtkWidget *dialog,
713 GtkDialogFlags flags)
716 gtk_window_set_transient_for (GTK_WINDOW (dialog), parent);
718 if (flags & GTK_DIALOG_MODAL)
719 gtk_window_set_modal (GTK_WINDOW (dialog), TRUE);
721 if (flags & GTK_DIALOG_DESTROY_WITH_PARENT)
722 gtk_window_set_destroy_with_parent (GTK_WINDOW (dialog), TRUE);
726 * gtk_app_chooser_dialog_new:
727 * @parent: (allow-none): a #GtkWindow, or %NULL
728 * @flags: flags for this dialog
731 * Creates a new #GtkAppChooserDialog for the provided #GFile,
732 * to allow the user to select an application for it.
734 * Returns: a newly created #GtkAppChooserDialog
739 gtk_app_chooser_dialog_new (GtkWindow *parent,
740 GtkDialogFlags flags,
745 g_return_val_if_fail (G_IS_FILE (file), NULL);
747 retval = g_object_new (GTK_TYPE_APP_CHOOSER_DIALOG,
751 set_parent_and_flags (retval, parent, flags);
757 * gtk_app_chooser_dialog_new_for_content_type:
758 * @parent: (allow-none): a #GtkWindow, or %NULL
759 * @flags: flags for this dialog
760 * @content_type: a content type string
762 * Creates a new #GtkAppChooserDialog for the provided content type,
763 * to allow the user to select an application for it.
765 * Returns: a newly created #GtkAppChooserDialog
770 gtk_app_chooser_dialog_new_for_content_type (GtkWindow *parent,
771 GtkDialogFlags flags,
772 const gchar *content_type)
776 g_return_val_if_fail (content_type != NULL, NULL);
778 retval = g_object_new (GTK_TYPE_APP_CHOOSER_DIALOG,
779 "content-type", content_type,
782 set_parent_and_flags (retval, parent, flags);
788 * gtk_app_chooser_dialog_get_widget:
789 * @self: a #GtkAppChooserDialog
791 * Returns the #GtkAppChooserWidget of this dialog.
793 * Returns: (transfer none): the #GtkAppChooserWidget of @self
798 gtk_app_chooser_dialog_get_widget (GtkAppChooserDialog *self)
800 g_return_val_if_fail (GTK_IS_APP_CHOOSER_DIALOG (self), NULL);
802 return self->priv->app_chooser_widget;
806 * gtk_app_chooser_dialog_set_heading:
807 * @self: a #GtkAppChooserDialog
808 * @heading: a string containing Pango markup
810 * Sets the text to display at the top of the dialog.
811 * If the heading is not set, the dialog displays a default text.
814 gtk_app_chooser_dialog_set_heading (GtkAppChooserDialog *self,
815 const gchar *heading)
817 g_return_if_fail (GTK_IS_APP_CHOOSER_DIALOG (self));
819 g_free (self->priv->heading);
820 self->priv->heading = g_strdup (heading);
822 if (self->priv->label && self->priv->heading)
823 gtk_label_set_markup (GTK_LABEL (self->priv->label), self->priv->heading);
825 g_object_notify (G_OBJECT (self), "heading");
829 * gtk_app_chooser_dialog_get_heading:
830 * @self: a #GtkAppChooserDialog
832 * Returns the text to display at the top of the dialog.
834 * Returns: the text to display at the top of the dialog, or %NULL, in which
835 * case a default text is displayed
838 gtk_app_chooser_dialog_get_heading (GtkAppChooserDialog *self)
840 g_return_val_if_fail (GTK_IS_APP_CHOOSER_DIALOG (self), NULL);
842 return self->priv->heading;