2 * gtkappchooserwidget.c: an app-chooser widget
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>
27 #include "gtkappchooserwidget.h"
30 #include "gtkmarshalers.h"
31 #include "gtkappchooserwidget.h"
32 #include "gtkappchooserprivate.h"
33 #include "gtkliststore.h"
34 #include "gtkcellrenderertext.h"
35 #include "gtkcellrendererpixbuf.h"
36 #include "gtktreeview.h"
37 #include "gtktreeselection.h"
38 #include "gtktreemodelsort.h"
39 #include "gtkorientable.h"
40 #include "gtkscrolledwindow.h"
43 #include <glib/gi18n-lib.h>
47 * SECTION:gtkappchooserwidget
48 * @Title: GtkAppChooserWidget
49 * @Short_description: Application chooser widget that can be embedded in other widgets
51 * #GtkAppChooserWidget is a widget for selecting applications.
52 * It is the main building block for #GtkAppChooserDialog. Most
53 * applications only need to use the latter; but you can use
54 * this widget as part of a larger widget if you have special needs.
56 * #GtkAppChooserWidget offers detailed control over what applications
57 * are shown, using the
58 * #GtkAppChooserWidget:show-default,
59 * #GtkAppChooserWidget:show-recommended,
60 * #GtkAppChooserWidget:show-fallback,
61 * #GtkAppChooserWidget:show-other and
62 * #GtkAppChooserWidget:show-all
63 * properties. See the #GtkAppChooser documentation for more information
64 * about these groups of applications.
66 * To keep track of the selected application, use the
67 * #GtkAppChooserWidget::application-selected and #GtkAppChooserWidget::application-activated signals.
70 struct _GtkAppChooserWidgetPrivate {
71 GAppInfo *selected_app_info;
76 guint show_default : 1;
77 guint show_recommended : 1;
78 guint show_fallback : 1;
82 GtkWidget *program_list;
83 GtkListStore *program_list_store;
85 GtkCellRenderer *padding_renderer;
104 PROP_CONTENT_TYPE = 1,
107 PROP_SHOW_RECOMMENDED,
116 SIGNAL_APPLICATION_SELECTED,
117 SIGNAL_APPLICATION_ACTIVATED,
118 SIGNAL_POPULATE_POPUP,
122 static guint signals[N_SIGNALS] = { 0, };
124 static void gtk_app_chooser_widget_iface_init (GtkAppChooserIface *iface);
126 G_DEFINE_TYPE_WITH_CODE (GtkAppChooserWidget, gtk_app_chooser_widget, GTK_TYPE_BOX,
127 G_IMPLEMENT_INTERFACE (GTK_TYPE_APP_CHOOSER,
128 gtk_app_chooser_widget_iface_init));
131 refresh_and_emit_app_selected (GtkAppChooserWidget *self,
132 GtkTreeSelection *selection)
136 GAppInfo *info = NULL;
137 gboolean should_emit = FALSE;
139 if (gtk_tree_selection_get_selected (selection, &model, &iter))
140 gtk_tree_model_get (model, &iter, COLUMN_APP_INFO, &info, -1);
145 if (self->priv->selected_app_info)
147 if (!g_app_info_equal (self->priv->selected_app_info, info))
150 g_object_unref (self->priv->selected_app_info);
152 self->priv->selected_app_info = info;
158 self->priv->selected_app_info = info;
162 g_signal_emit (self, signals[SIGNAL_APPLICATION_SELECTED], 0,
163 self->priv->selected_app_info);
167 get_app_info_for_event (GtkAppChooserWidget *self,
168 GdkEventButton *event)
170 GtkTreePath *path = NULL;
174 gboolean recommended;
176 if (!gtk_tree_view_get_path_at_pos (GTK_TREE_VIEW (self->priv->program_list),
182 model = gtk_tree_view_get_model (GTK_TREE_VIEW (self->priv->program_list));
184 if (!gtk_tree_model_get_iter (model, &iter, path))
186 gtk_tree_path_free (path);
190 /* we only allow interaction with recommended applications */
191 gtk_tree_model_get (model, &iter,
192 COLUMN_APP_INFO, &info,
193 COLUMN_RECOMMENDED, &recommended,
197 g_clear_object (&info);
203 widget_button_press_event_cb (GtkWidget *widget,
204 GdkEventButton *event,
207 GtkAppChooserWidget *self = user_data;
209 if (event->button == GDK_BUTTON_SECONDARY && event->type == GDK_BUTTON_PRESS)
216 info = get_app_info_for_event (self, event);
221 menu = gtk_menu_new ();
223 g_signal_emit (self, signals[SIGNAL_POPULATE_POPUP], 0,
226 g_object_unref (info);
228 /* see if clients added menu items to this container */
229 children = gtk_container_get_children (GTK_CONTAINER (menu));
230 n_children = g_list_length (children);
234 /* actually popup the menu */
235 gtk_menu_attach_to_widget (GTK_MENU (menu), self->priv->program_list, NULL);
236 gtk_menu_popup (GTK_MENU (menu), NULL, NULL, NULL, NULL,
237 event->button, event->time);
240 g_list_free (children);
247 path_is_heading (GtkTreeView *view,
254 model = gtk_tree_view_get_model (view);
255 gtk_tree_model_get_iter (model, &iter, path);
256 gtk_tree_model_get (model, &iter,
257 COLUMN_HEADING, &res,
264 program_list_selection_activated (GtkTreeView *view,
266 GtkTreeViewColumn *column,
269 GtkAppChooserWidget *self = user_data;
270 GtkTreeSelection *selection;
272 if (path_is_heading (view, path))
275 selection = gtk_tree_view_get_selection (GTK_TREE_VIEW (self->priv->program_list));
277 refresh_and_emit_app_selected (self, selection);
279 g_signal_emit (self, signals[SIGNAL_APPLICATION_ACTIVATED], 0,
280 self->priv->selected_app_info);
284 gtk_app_chooser_search_equal_func (GtkTreeModel *model,
290 gchar *normalized_key;
291 gchar *name, *normalized_name;
292 gchar *path, *normalized_path;
293 gchar *basename, *normalized_basename;
298 normalized_key = g_utf8_casefold (key, -1);
299 g_assert (normalized_key != NULL);
303 gtk_tree_model_get (model, iter,
310 normalized_name = g_utf8_casefold (name, -1);
311 g_assert (normalized_name != NULL);
313 if (strncmp (normalized_name, normalized_key, strlen (normalized_key)) == 0)
316 g_free (normalized_name);
319 if (ret && path != NULL)
321 normalized_path = g_utf8_casefold (path, -1);
322 g_assert (normalized_path != NULL);
324 basename = g_path_get_basename (path);
325 g_assert (basename != NULL);
327 normalized_basename = g_utf8_casefold (basename, -1);
328 g_assert (normalized_basename != NULL);
330 if (strncmp (normalized_path, normalized_key, strlen (normalized_key)) == 0 ||
331 strncmp (normalized_basename, normalized_key, strlen (normalized_key)) == 0)
335 g_free (normalized_basename);
336 g_free (normalized_path);
341 g_free (normalized_key);
352 gtk_app_chooser_sort_func (GtkTreeModel *model,
357 gboolean a_recommended, b_recommended;
358 gboolean a_fallback, b_fallback;
359 gboolean a_heading, b_heading;
360 gboolean a_default, b_default;
361 gchar *a_name, *b_name, *a_casefold, *b_casefold;
365 * - <0 if a should show before b
366 * - =0 if a is the same as b
367 * - >0 if a should show after b
370 gtk_tree_model_get (model, a,
371 COLUMN_NAME, &a_name,
372 COLUMN_RECOMMENDED, &a_recommended,
373 COLUMN_FALLBACK, &a_fallback,
374 COLUMN_HEADING, &a_heading,
375 COLUMN_DEFAULT, &a_default,
378 gtk_tree_model_get (model, b,
379 COLUMN_NAME, &b_name,
380 COLUMN_RECOMMENDED, &b_recommended,
381 COLUMN_FALLBACK, &b_fallback,
382 COLUMN_HEADING, &b_heading,
383 COLUMN_DEFAULT, &b_default,
386 /* the default one always wins */
387 if (a_default && !b_default)
393 if (b_default && !a_default)
399 /* the recommended one always wins */
400 if (a_recommended && !b_recommended)
406 if (b_recommended && !a_recommended)
412 /* the recommended one always wins */
413 if (a_fallback && !b_fallback)
419 if (b_fallback && !a_fallback)
425 /* they're both recommended/falback or not, so if one is a heading, wins */
438 /* don't order by name recommended applications, but use GLib's ordering */
441 a_casefold = a_name != NULL ?
442 g_utf8_casefold (a_name, -1) : NULL;
443 b_casefold = b_name != NULL ?
444 g_utf8_casefold (b_name, -1) : NULL;
446 retval = g_strcmp0 (a_casefold, b_casefold);
460 padding_cell_renderer_func (GtkTreeViewColumn *column,
461 GtkCellRenderer *cell,
468 gtk_tree_model_get (model, iter,
469 COLUMN_HEADING, &heading,
486 gtk_app_chooser_selection_func (GtkTreeSelection *selection,
489 gboolean path_currently_selected,
495 gtk_tree_model_get_iter (model, &iter, path);
496 gtk_tree_model_get (model, &iter,
497 COLUMN_HEADING, &heading,
504 compare_apps_func (gconstpointer a,
507 return !g_app_info_equal (G_APP_INFO (a), G_APP_INFO (b));
511 gtk_app_chooser_widget_add_section (GtkAppChooserWidget *self,
512 const gchar *heading_title,
513 gboolean show_headings,
514 gboolean recommended,
519 gboolean heading_added, unref_icon;
522 gchar *app_string, *bold_string;
528 heading_added = FALSE;
529 bold_string = g_strdup_printf ("<b>%s</b>", heading_title);
531 for (l = applications; l != NULL; l = l->next)
535 if (!g_app_info_supports_uris (app) &&
536 !g_app_info_supports_files (app))
539 if (g_list_find_custom (exclude_apps, app,
540 (GCompareFunc) compare_apps_func))
543 if (!heading_added && show_headings)
545 gtk_list_store_append (self->priv->program_list_store, &iter);
546 gtk_list_store_set (self->priv->program_list_store, &iter,
547 COLUMN_HEADING_TEXT, bold_string,
548 COLUMN_HEADING, TRUE,
549 COLUMN_RECOMMENDED, recommended,
550 COLUMN_FALLBACK, fallback,
553 heading_added = TRUE;
556 app_string = g_markup_printf_escaped ("%s",
557 g_app_info_get_name (app) != NULL ?
558 g_app_info_get_name (app) : "");
560 icon = g_app_info_get_icon (app);
564 icon = g_themed_icon_new ("application-x-executable");
568 gtk_list_store_append (self->priv->program_list_store, &iter);
569 gtk_list_store_set (self->priv->program_list_store, &iter,
570 COLUMN_APP_INFO, app,
572 COLUMN_NAME, g_app_info_get_name (app),
573 COLUMN_DESC, app_string,
574 COLUMN_EXEC, g_app_info_get_executable (app),
575 COLUMN_HEADING, FALSE,
576 COLUMN_RECOMMENDED, recommended,
577 COLUMN_FALLBACK, fallback,
584 g_object_unref (icon);
587 g_free (bold_string);
594 gtk_app_chooser_add_default (GtkAppChooserWidget *self,
603 string = g_strdup_printf ("<b>%s</b>", _("Default Application"));
605 gtk_list_store_append (self->priv->program_list_store, &iter);
606 gtk_list_store_set (self->priv->program_list_store, &iter,
607 COLUMN_HEADING_TEXT, string,
608 COLUMN_HEADING, TRUE,
609 COLUMN_DEFAULT, TRUE,
614 string = g_markup_printf_escaped ("%s",
615 g_app_info_get_name (app) != NULL ?
616 g_app_info_get_name (app) : "");
618 icon = g_app_info_get_icon (app);
621 icon = g_themed_icon_new ("application-x-executable");
625 gtk_list_store_append (self->priv->program_list_store, &iter);
626 gtk_list_store_set (self->priv->program_list_store, &iter,
627 COLUMN_APP_INFO, app,
629 COLUMN_NAME, g_app_info_get_name (app),
631 COLUMN_EXEC, g_app_info_get_executable (app),
632 COLUMN_HEADING, FALSE,
633 COLUMN_DEFAULT, TRUE,
639 g_object_unref (icon);
643 add_no_applications_label (GtkAppChooserWidget *self)
645 gchar *text = NULL, *desc = NULL;
649 if (self->priv->default_text == NULL)
651 if (self->priv->content_type)
652 desc = g_content_type_get_description (self->priv->content_type);
654 string = text = g_strdup_printf (_("No applications available to open \"%s\""),
660 string = self->priv->default_text;
663 gtk_list_store_append (self->priv->program_list_store, &iter);
664 gtk_list_store_set (self->priv->program_list_store, &iter,
665 COLUMN_HEADING_TEXT, string,
666 COLUMN_HEADING, TRUE,
673 gtk_app_chooser_widget_select_first (GtkAppChooserWidget *self)
676 GAppInfo *info = NULL;
679 model = gtk_tree_view_get_model (GTK_TREE_VIEW (self->priv->program_list));
680 gtk_tree_model_get_iter_first (model, &iter);
684 gtk_tree_model_get (model, &iter,
685 COLUMN_APP_INFO, &info,
691 if (!gtk_tree_model_iter_next (model, &iter))
697 GtkTreeSelection *selection;
699 selection = gtk_tree_view_get_selection (GTK_TREE_VIEW (self->priv->program_list));
700 gtk_tree_selection_select_iter (selection, &iter);
702 g_object_unref (info);
707 gtk_app_chooser_widget_real_add_items (GtkAppChooserWidget *self)
709 GList *all_applications = NULL;
710 GList *recommended_apps = NULL;
711 GList *fallback_apps = NULL;
712 GList *exclude_apps = NULL;
713 GAppInfo *default_app = NULL;
714 gboolean show_headings;
717 show_headings = TRUE;
720 if (self->priv->show_all)
721 show_headings = FALSE;
723 if (self->priv->show_default && self->priv->content_type)
725 default_app = g_app_info_get_default_for_type (self->priv->content_type, FALSE);
727 if (default_app != NULL)
729 gtk_app_chooser_add_default (self, default_app);
731 exclude_apps = g_list_prepend (exclude_apps, default_app);
736 if ((self->priv->content_type && self->priv->show_recommended) || self->priv->show_all)
738 if (self->priv->content_type)
739 recommended_apps = g_app_info_get_recommended_for_type (self->priv->content_type);
741 apps_added |= gtk_app_chooser_widget_add_section (self, _("Recommended Applications"),
743 !self->priv->show_all, /* mark as recommended */
744 FALSE, /* mark as fallback */
745 recommended_apps, exclude_apps);
747 exclude_apps = g_list_concat (exclude_apps,
748 g_list_copy (recommended_apps));
751 if ((self->priv->content_type && self->priv->show_fallback) || self->priv->show_all)
753 if (self->priv->content_type)
754 fallback_apps = g_app_info_get_fallback_for_type (self->priv->content_type);
756 apps_added |= gtk_app_chooser_widget_add_section (self, _("Related Applications"),
758 FALSE, /* mark as recommended */
759 !self->priv->show_all, /* mark as fallback */
760 fallback_apps, exclude_apps);
761 exclude_apps = g_list_concat (exclude_apps,
762 g_list_copy (fallback_apps));
766 if (self->priv->show_other || self->priv->show_all)
768 all_applications = g_app_info_get_all ();
770 apps_added |= gtk_app_chooser_widget_add_section (self, _("Other Applications"),
774 all_applications, exclude_apps);
778 add_no_applications_label (self);
780 gtk_app_chooser_widget_select_first (self);
782 if (default_app != NULL)
783 g_object_unref (default_app);
785 if (all_applications != NULL)
786 g_list_free_full (all_applications, g_object_unref);
788 if (recommended_apps != NULL)
789 g_list_free_full (recommended_apps, g_object_unref);
791 if (fallback_apps != NULL)
792 g_list_free_full (fallback_apps, g_object_unref);
794 if (exclude_apps != NULL)
795 g_list_free (exclude_apps);
799 gtk_app_chooser_widget_add_items (GtkAppChooserWidget *self)
801 GtkCellRenderer *renderer;
802 GtkTreeViewColumn *column;
805 /* create list store */
806 self->priv->program_list_store = gtk_list_store_new (NUM_COLUMNS,
817 sort = gtk_tree_model_sort_new_with_model (GTK_TREE_MODEL (self->priv->program_list_store));
819 gtk_tree_view_set_model (GTK_TREE_VIEW (self->priv->program_list),
820 GTK_TREE_MODEL (sort));
821 gtk_tree_sortable_set_sort_column_id (GTK_TREE_SORTABLE (sort),
824 gtk_tree_sortable_set_sort_func (GTK_TREE_SORTABLE (sort),
826 gtk_app_chooser_sort_func,
828 gtk_tree_view_set_search_column (GTK_TREE_VIEW (self->priv->program_list),
830 gtk_tree_view_set_search_equal_func (GTK_TREE_VIEW (self->priv->program_list),
831 gtk_app_chooser_search_equal_func,
834 column = gtk_tree_view_column_new ();
836 /* initial padding */
837 renderer = gtk_cell_renderer_text_new ();
838 gtk_tree_view_column_pack_start (column, renderer, FALSE);
839 g_object_set (renderer,
840 "xpad", self->priv->show_all ? 0 : 6,
842 self->priv->padding_renderer = renderer;
844 /* heading text renderer */
845 renderer = gtk_cell_renderer_text_new ();
846 gtk_tree_view_column_pack_start (column, renderer, FALSE);
847 gtk_tree_view_column_set_attributes (column, renderer,
848 "markup", COLUMN_HEADING_TEXT,
849 "visible", COLUMN_HEADING,
851 g_object_set (renderer,
855 "wrap-mode", PANGO_WRAP_WORD,
858 /* padding renderer for non-heading cells */
859 renderer = gtk_cell_renderer_text_new ();
860 gtk_tree_view_column_pack_start (column, renderer, FALSE);
861 gtk_tree_view_column_set_cell_data_func (column, renderer,
862 padding_cell_renderer_func,
865 /* app icon renderer */
866 renderer = gtk_cell_renderer_pixbuf_new ();
867 gtk_tree_view_column_pack_start (column, renderer, FALSE);
868 gtk_tree_view_column_set_attributes (column, renderer,
869 "gicon", COLUMN_GICON,
871 g_object_set (renderer,
872 "stock-size", GTK_ICON_SIZE_MENU,
875 /* app name renderer */
876 renderer = gtk_cell_renderer_text_new ();
877 gtk_tree_view_column_pack_start (column, renderer, TRUE);
878 gtk_tree_view_column_set_attributes (column, renderer,
879 "markup", COLUMN_DESC,
881 g_object_set (renderer,
882 "ellipsize", PANGO_ELLIPSIZE_END,
883 "ellipsize-set", TRUE,
886 gtk_tree_view_column_set_sort_column_id (column, COLUMN_NAME);
887 gtk_tree_view_append_column (GTK_TREE_VIEW (self->priv->program_list), column);
889 /* populate the widget */
890 gtk_app_chooser_widget_real_add_items (self);
894 gtk_app_chooser_widget_set_property (GObject *object,
899 GtkAppChooserWidget *self = GTK_APP_CHOOSER_WIDGET (object);
903 case PROP_CONTENT_TYPE:
904 self->priv->content_type = g_value_dup_string (value);
906 case PROP_SHOW_DEFAULT:
907 gtk_app_chooser_widget_set_show_default (self, g_value_get_boolean (value));
909 case PROP_SHOW_RECOMMENDED:
910 gtk_app_chooser_widget_set_show_recommended (self, g_value_get_boolean (value));
912 case PROP_SHOW_FALLBACK:
913 gtk_app_chooser_widget_set_show_fallback (self, g_value_get_boolean (value));
915 case PROP_SHOW_OTHER:
916 gtk_app_chooser_widget_set_show_other (self, g_value_get_boolean (value));
919 gtk_app_chooser_widget_set_show_all (self, g_value_get_boolean (value));
921 case PROP_DEFAULT_TEXT:
922 gtk_app_chooser_widget_set_default_text (self, g_value_get_string (value));
925 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
931 gtk_app_chooser_widget_get_property (GObject *object,
936 GtkAppChooserWidget *self = GTK_APP_CHOOSER_WIDGET (object);
940 case PROP_CONTENT_TYPE:
941 g_value_set_string (value, self->priv->content_type);
943 case PROP_SHOW_DEFAULT:
944 g_value_set_boolean (value, self->priv->show_default);
946 case PROP_SHOW_RECOMMENDED:
947 g_value_set_boolean (value, self->priv->show_recommended);
949 case PROP_SHOW_FALLBACK:
950 g_value_set_boolean (value, self->priv->show_fallback);
952 case PROP_SHOW_OTHER:
953 g_value_set_boolean (value, self->priv->show_other);
956 g_value_set_boolean (value, self->priv->show_all);
958 case PROP_DEFAULT_TEXT:
959 g_value_set_string (value, self->priv->default_text);
962 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
968 gtk_app_chooser_widget_constructed (GObject *object)
970 GtkAppChooserWidget *self = GTK_APP_CHOOSER_WIDGET (object);
972 if (G_OBJECT_CLASS (gtk_app_chooser_widget_parent_class)->constructed != NULL)
973 G_OBJECT_CLASS (gtk_app_chooser_widget_parent_class)->constructed (object);
975 gtk_app_chooser_widget_add_items (self);
979 gtk_app_chooser_widget_finalize (GObject *object)
981 GtkAppChooserWidget *self = GTK_APP_CHOOSER_WIDGET (object);
983 g_free (self->priv->content_type);
984 g_free (self->priv->default_text);
986 G_OBJECT_CLASS (gtk_app_chooser_widget_parent_class)->finalize (object);
990 gtk_app_chooser_widget_dispose (GObject *object)
992 GtkAppChooserWidget *self = GTK_APP_CHOOSER_WIDGET (object);
994 g_clear_object (&self->priv->selected_app_info);
996 G_OBJECT_CLASS (gtk_app_chooser_widget_parent_class)->dispose (object);
1000 gtk_app_chooser_widget_class_init (GtkAppChooserWidgetClass *klass)
1002 GObjectClass *gobject_class;
1005 gobject_class = G_OBJECT_CLASS (klass);
1006 gobject_class->dispose = gtk_app_chooser_widget_dispose;
1007 gobject_class->finalize = gtk_app_chooser_widget_finalize;
1008 gobject_class->set_property = gtk_app_chooser_widget_set_property;
1009 gobject_class->get_property = gtk_app_chooser_widget_get_property;
1010 gobject_class->constructed = gtk_app_chooser_widget_constructed;
1012 g_object_class_override_property (gobject_class, PROP_CONTENT_TYPE, "content-type");
1015 * GtkAppChooserWidget:show-default:
1017 * The ::show-default property determines whether the app chooser
1018 * should show the default handler for the content type in a
1019 * separate section. If %FALSE, the default handler is listed
1020 * among the recommended applications.
1022 pspec = g_param_spec_boolean ("show-default",
1023 P_("Show default app"),
1024 P_("Whether the widget should show the default application"),
1026 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS);
1027 g_object_class_install_property (gobject_class, PROP_SHOW_DEFAULT, pspec);
1030 * GtkAppChooserWidget:show-recommended:
1032 * The #GtkAppChooserWidget:show-recommended property determines
1033 * whether the app chooser should show a section for recommended
1034 * applications. If %FALSE, the recommended applications are listed
1035 * among the other applications.
1037 pspec = g_param_spec_boolean ("show-recommended",
1038 P_("Show recommended apps"),
1039 P_("Whether the widget should show recommended applications"),
1041 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS);
1042 g_object_class_install_property (gobject_class, PROP_SHOW_RECOMMENDED, pspec);
1045 * GtkAppChooserWidget:show-fallback:
1047 * The #GtkAppChooserWidget:show-fallback property determines whether
1048 * the app chooser should show a section for fallback applications.
1049 * If %FALSE, the fallback applications are listed among the other
1052 pspec = g_param_spec_boolean ("show-fallback",
1053 P_("Show fallback apps"),
1054 P_("Whether the widget should show fallback applications"),
1056 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS);
1057 g_object_class_install_property (gobject_class, PROP_SHOW_FALLBACK, pspec);
1060 * GtkAppChooserWidget:show-other:
1062 * The #GtkAppChooserWidget:show-other property determines whether
1063 * the app chooser should show a section for other applications.
1065 pspec = g_param_spec_boolean ("show-other",
1066 P_("Show other apps"),
1067 P_("Whether the widget should show other applications"),
1069 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS);
1070 g_object_class_install_property (gobject_class, PROP_SHOW_OTHER, pspec);
1073 * GtkAppChooserWidget:show-all:
1075 * If the #GtkAppChooserWidget:show-all property is %TRUE, the app
1076 * chooser presents all applications in a single list, without
1077 * subsections for default, recommended or related applications.
1079 pspec = g_param_spec_boolean ("show-all",
1080 P_("Show all apps"),
1081 P_("Whether the widget should show all applications"),
1083 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS);
1084 g_object_class_install_property (gobject_class, PROP_SHOW_ALL, pspec);
1087 * GtkAppChooserWidget:default-text:
1089 * The #GtkAppChooserWidget:default-text property determines the text
1090 * that appears in the widget when there are no applications for the
1091 * given content type.
1092 * See also gtk_app_chooser_widget_set_default_text().
1094 pspec = g_param_spec_string ("default-text",
1095 P_("Widget's default text"),
1096 P_("The default text appearing when there are no applications"),
1098 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
1099 g_object_class_install_property (gobject_class, PROP_DEFAULT_TEXT, pspec);
1102 * GtkAppChooserWidget::application-selected:
1103 * @self: the object which received the signal
1104 * @application: the selected #GAppInfo
1106 * Emitted when an application item is selected from the widget's list.
1108 signals[SIGNAL_APPLICATION_SELECTED] =
1109 g_signal_new ("application-selected",
1110 GTK_TYPE_APP_CHOOSER_WIDGET,
1112 G_STRUCT_OFFSET (GtkAppChooserWidgetClass, application_selected),
1114 _gtk_marshal_VOID__OBJECT,
1116 1, G_TYPE_APP_INFO);
1119 * GtkAppChooserWidget::application-activated:
1120 * @self: the object which received the signal
1121 * @application: the activated #GAppInfo
1123 * Emitted when an application item is activated from the widget's list.
1125 * This usually happens when the user double clicks an item, or an item
1126 * is selected and the user presses one of the keys Space, Shift+Space,
1129 signals[SIGNAL_APPLICATION_ACTIVATED] =
1130 g_signal_new ("application-activated",
1131 GTK_TYPE_APP_CHOOSER_WIDGET,
1133 G_STRUCT_OFFSET (GtkAppChooserWidgetClass, application_activated),
1135 _gtk_marshal_VOID__OBJECT,
1137 1, G_TYPE_APP_INFO);
1140 * GtkAppChooserWidget::populate-popup:
1141 * @self: the object which received the signal
1142 * @menu: the #GtkMenu to populate
1143 * @application: the current #GAppInfo
1145 * Emitted when a context menu is about to popup over an application item.
1146 * Clients can insert menu items into the provided #GtkMenu object in the
1147 * callback of this signal; the context menu will be shown over the item
1148 * if at least one item has been added to the menu.
1150 signals[SIGNAL_POPULATE_POPUP] =
1151 g_signal_new ("populate-popup",
1152 GTK_TYPE_APP_CHOOSER_WIDGET,
1154 G_STRUCT_OFFSET (GtkAppChooserWidgetClass, populate_popup),
1156 _gtk_marshal_VOID__OBJECT_OBJECT,
1158 2, GTK_TYPE_MENU, G_TYPE_APP_INFO);
1160 g_type_class_add_private (klass, sizeof (GtkAppChooserWidgetPrivate));
1164 gtk_app_chooser_widget_init (GtkAppChooserWidget *self)
1166 GtkWidget *scrolled_window;
1167 GtkTreeSelection *selection;
1169 self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, GTK_TYPE_APP_CHOOSER_WIDGET,
1170 GtkAppChooserWidgetPrivate);
1171 gtk_orientable_set_orientation (GTK_ORIENTABLE (self), GTK_ORIENTATION_VERTICAL);
1173 scrolled_window = gtk_scrolled_window_new (NULL, NULL);
1174 gtk_widget_set_size_request (scrolled_window, 400, 300);
1175 gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (scrolled_window),
1177 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),
1179 GTK_POLICY_AUTOMATIC);
1180 gtk_widget_show (scrolled_window);
1182 self->priv->program_list = gtk_tree_view_new ();
1183 gtk_tree_view_set_headers_visible (GTK_TREE_VIEW (self->priv->program_list),
1185 gtk_container_add (GTK_CONTAINER (scrolled_window), self->priv->program_list);
1186 gtk_box_pack_start (GTK_BOX (self), scrolled_window, TRUE, TRUE, 0);
1187 gtk_widget_show (self->priv->program_list);
1189 selection = gtk_tree_view_get_selection (GTK_TREE_VIEW (self->priv->program_list));
1190 gtk_tree_selection_set_mode (selection, GTK_SELECTION_BROWSE);
1191 gtk_tree_selection_set_select_function (selection, gtk_app_chooser_selection_func,
1193 g_signal_connect_swapped (selection, "changed",
1194 G_CALLBACK (refresh_and_emit_app_selected),
1196 g_signal_connect (self->priv->program_list, "row-activated",
1197 G_CALLBACK (program_list_selection_activated),
1199 g_signal_connect (self->priv->program_list, "button-press-event",
1200 G_CALLBACK (widget_button_press_event_cb),
1205 gtk_app_chooser_widget_get_app_info (GtkAppChooser *object)
1207 GtkAppChooserWidget *self = GTK_APP_CHOOSER_WIDGET (object);
1209 if (self->priv->selected_app_info == NULL)
1212 return g_object_ref (self->priv->selected_app_info);
1216 gtk_app_chooser_widget_refresh (GtkAppChooser *object)
1218 GtkAppChooserWidget *self = GTK_APP_CHOOSER_WIDGET (object);
1220 if (self->priv->program_list_store != NULL)
1222 gtk_list_store_clear (self->priv->program_list_store);
1224 /* don't add additional xpad if we don't have headings */
1225 g_object_set (self->priv->padding_renderer,
1226 "visible", !self->priv->show_all,
1229 gtk_app_chooser_widget_real_add_items (self);
1234 gtk_app_chooser_widget_iface_init (GtkAppChooserIface *iface)
1236 iface->get_app_info = gtk_app_chooser_widget_get_app_info;
1237 iface->refresh = gtk_app_chooser_widget_refresh;
1241 * gtk_app_chooser_widget_new:
1242 * @content_type: the content type to show applications for
1244 * Creates a new #GtkAppChooserWidget for applications
1245 * that can handle content of the given type.
1247 * Returns: a newly created #GtkAppChooserWidget
1252 gtk_app_chooser_widget_new (const gchar *content_type)
1254 return g_object_new (GTK_TYPE_APP_CHOOSER_WIDGET,
1255 "content-type", content_type,
1260 * gtk_app_chooser_widget_set_show_default:
1261 * @self: a #GtkAppChooserWidget
1262 * @setting: the new value for #GtkAppChooserWidget:show-default
1264 * Sets whether the app chooser should show the default handler
1265 * for the content type in a separate section.
1270 gtk_app_chooser_widget_set_show_default (GtkAppChooserWidget *self,
1273 g_return_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self));
1275 if (self->priv->show_default != setting)
1277 self->priv->show_default = setting;
1279 g_object_notify (G_OBJECT (self), "show-default");
1281 gtk_app_chooser_refresh (GTK_APP_CHOOSER (self));
1286 * gtk_app_chooser_widget_get_show_default:
1287 * @self: a #GtkAppChooserWidget
1289 * Returns the current value of the #GtkAppChooserWidget:show-default
1292 * Returns: the value of #GtkAppChooserWidget:show-default
1297 gtk_app_chooser_widget_get_show_default (GtkAppChooserWidget *self)
1299 g_return_val_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self), FALSE);
1301 return self->priv->show_default;
1305 * gtk_app_chooser_widget_set_show_recommended:
1306 * @self: a #GtkAppChooserWidget
1307 * @setting: the new value for #GtkAppChooserWidget:show-recommended
1309 * Sets whether the app chooser should show recommended applications
1310 * for the content type in a separate section.
1315 gtk_app_chooser_widget_set_show_recommended (GtkAppChooserWidget *self,
1318 g_return_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self));
1320 if (self->priv->show_recommended != setting)
1322 self->priv->show_recommended = setting;
1324 g_object_notify (G_OBJECT (self), "show-recommended");
1326 gtk_app_chooser_refresh (GTK_APP_CHOOSER (self));
1331 * gtk_app_chooser_widget_get_show_recommended:
1332 * @self: a #GtkAppChooserWidget
1334 * Returns the current value of the #GtkAppChooserWidget:show-recommended
1337 * Returns: the value of #GtkAppChooserWidget:show-recommended
1342 gtk_app_chooser_widget_get_show_recommended (GtkAppChooserWidget *self)
1344 g_return_val_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self), FALSE);
1346 return self->priv->show_recommended;
1350 * gtk_app_chooser_widget_set_show_fallback:
1351 * @self: a #GtkAppChooserWidget
1352 * @setting: the new value for #GtkAppChooserWidget:show-fallback
1354 * Sets whether the app chooser should show related applications
1355 * for the content type in a separate section.
1360 gtk_app_chooser_widget_set_show_fallback (GtkAppChooserWidget *self,
1363 g_return_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self));
1365 if (self->priv->show_fallback != setting)
1367 self->priv->show_fallback = setting;
1369 g_object_notify (G_OBJECT (self), "show-fallback");
1371 gtk_app_chooser_refresh (GTK_APP_CHOOSER (self));
1376 * gtk_app_chooser_widget_get_show_fallback:
1377 * @self: a #GtkAppChooserWidget
1379 * Returns the current value of the #GtkAppChooserWidget:show-fallback
1382 * Returns: the value of #GtkAppChooserWidget:show-fallback
1387 gtk_app_chooser_widget_get_show_fallback (GtkAppChooserWidget *self)
1389 g_return_val_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self), FALSE);
1391 return self->priv->show_fallback;
1395 * gtk_app_chooser_widget_set_show_other:
1396 * @self: a #GtkAppChooserWidget
1397 * @setting: the new value for #GtkAppChooserWidget:show-other
1399 * Sets whether the app chooser should show applications
1400 * which are unrelated to the content type.
1405 gtk_app_chooser_widget_set_show_other (GtkAppChooserWidget *self,
1408 g_return_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self));
1410 if (self->priv->show_other != setting)
1412 self->priv->show_other = setting;
1414 g_object_notify (G_OBJECT (self), "show-other");
1416 gtk_app_chooser_refresh (GTK_APP_CHOOSER (self));
1421 * gtk_app_chooser_widget_get_show_other:
1422 * @self: a #GtkAppChooserWidget
1424 * Returns the current value of the #GtkAppChooserWidget:show-other
1427 * Returns: the value of #GtkAppChooserWidget:show-other
1432 gtk_app_chooser_widget_get_show_other (GtkAppChooserWidget *self)
1434 g_return_val_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self), FALSE);
1436 return self->priv->show_other;
1440 * gtk_app_chooser_widget_set_show_all:
1441 * @self: a #GtkAppChooserWidget
1442 * @setting: the new value for #GtkAppChooserWidget:show-all
1444 * Sets whether the app chooser should show all applications
1450 gtk_app_chooser_widget_set_show_all (GtkAppChooserWidget *self,
1453 g_return_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self));
1455 if (self->priv->show_all != setting)
1457 self->priv->show_all = setting;
1459 g_object_notify (G_OBJECT (self), "show-all");
1461 gtk_app_chooser_refresh (GTK_APP_CHOOSER (self));
1466 * gtk_app_chooser_widget_get_show_all:
1467 * @self: a #GtkAppChooserWidget
1469 * Returns the current value of the #GtkAppChooserWidget:show-all
1472 * Returns: the value of #GtkAppChooserWidget:show-all
1477 gtk_app_chooser_widget_get_show_all (GtkAppChooserWidget *self)
1479 g_return_val_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self), FALSE);
1481 return self->priv->show_all;
1485 * gtk_app_chooser_widget_set_default_text:
1486 * @self: a #GtkAppChooserWidget
1487 * @text: the new value for #GtkAppChooserWidget:default-text
1489 * Sets the text that is shown if there are not applications
1490 * that can handle the content type.
1493 gtk_app_chooser_widget_set_default_text (GtkAppChooserWidget *self,
1496 g_return_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self));
1498 if (g_strcmp0 (text, self->priv->default_text) != 0)
1500 g_free (self->priv->default_text);
1501 self->priv->default_text = g_strdup (text);
1503 g_object_notify (G_OBJECT (self), "default-text");
1505 gtk_app_chooser_refresh (GTK_APP_CHOOSER (self));
1510 * gtk_app_chooser_widget_get_default_text:
1511 * @self: a #GtkAppChooserWidget
1513 * Returns the text that is shown if there are not applications
1514 * that can handle the content type.
1516 * Returns: the value of #GtkAppChooserWidget:default-text
1521 gtk_app_chooser_widget_get_default_text (GtkAppChooserWidget *self)
1523 g_return_val_if_fail (GTK_IS_APP_CHOOSER_WIDGET (self), NULL);
1525 return self->priv->default_text;