Pileus Git - ~andy/gtk/blob - gtk/gtkappchooserdialog.c

   1 /*
   2  * gtkappchooserdialog.c: an app-chooser dialog
   3  *
   4  * Copyright (C) 2004 Novell, Inc.
   5  * Copyright (C) 2007, 2010 Red Hat, Inc.
   6  *
   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.
  11  *
  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.
  16  *
  17  * You should have received a copy of the GNU Library General Public
  18  * License along with the Gnome Library; see the file COPYING.LIB.  If not,
  19  * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  20  * Boston, MA 02111-1307, USA.
  21  *
  22  * Authors: Dave Camp <dave@novell.com>
  23  *          Alexander Larsson <alexl@redhat.com>
  24  *          Cosimo Cecchi <ccecchi@redhat.com>
  25  */
  26
  27 /**
  28  * SECTION:gtkappchooserdialog
  29  * @Title: GtkAppChooserDialog
  30  * @Short_description: An application chooser dialog
  31  *
  32  * #GtkAppChooserDialog shows a #GtkAppChooserWidget inside a #GtkDialog.
  33  *
  34  * Note that #GtkAppChooserDialog does not have any interesting methods
  35  * of its own. Instead, you should get the embedded #GtkAppChooserWidget
  36  * using gtk_app_chooser_dialog_get_widget() and call its methods if
  37  * the generic #GtkAppChooser interface is not sufficient for your needs.
  38  */
  39 #include "config.h"
  40
  41 #include "gtkappchooserdialog.h"
  42
  43 #include "gtkintl.h"
  44 #include "gtkappchooser.h"
  45 #include "gtkappchooseronline.h"
  46 #include "gtkappchooserprivate.h"
  47 #include "gtkappchooserprivate.h"
  48
  49 #include "gtkmessagedialog.h"
  50 #include "gtklabel.h"
  51 #include "gtkbbox.h"
  52 #include "gtkbutton.h"
  53 #include "gtkmenuitem.h"
  54 #include "gtkstock.h"
  55
  56 #include <string.h>
  57 #include <glib/gi18n-lib.h>
  58 #include <gio/gio.h>
  59
  60 #define sure_string(s) ((const char *) ((s) != NULL ? (s) : ""))
  61
  62 struct _GtkAppChooserDialogPrivate {
  63   char *content_type;
  64   GFile *gfile;
  65   char *heading;
  66
  67   GtkWidget *label;
  68   GtkWidget *button;
  69   GtkWidget *online_button;
  70
  71   GtkWidget *open_label;
  72
  73   GtkWidget *app_chooser_widget;
  74   GtkWidget *show_more_button;
  75
  76   GtkAppChooserOnline *online;
  77
  78   gboolean show_more_clicked;
  79 };
  80
  81 enum {
  82   PROP_GFILE = 1,
  83   PROP_CONTENT_TYPE,
  84   PROP_HEADING
  85 };
  86
  87 static void gtk_app_chooser_dialog_iface_init (GtkAppChooserIface *iface);
  88 G_DEFINE_TYPE_WITH_CODE (GtkAppChooserDialog, gtk_app_chooser_dialog, GTK_TYPE_DIALOG,
  89                          G_IMPLEMENT_INTERFACE (GTK_TYPE_APP_CHOOSER,
  90                                                 gtk_app_chooser_dialog_iface_init));
  91
  92 static void
  93 show_error_dialog (const gchar *primary,
  94                    const gchar *secondary,
  95                    GtkWindow   *parent)
  96 {
  97   GtkWidget *message_dialog;
  98
  99   message_dialog = gtk_message_dialog_new (parent, 0,
 100                                            GTK_MESSAGE_ERROR,
 101                                            GTK_BUTTONS_OK,
 102                                            NULL);
 103   g_object_set (message_dialog,
 104                 "text", primary,
 105                 "secondary-text", secondary,
 106                 NULL);
 107   gtk_dialog_set_default_response (GTK_DIALOG (message_dialog), GTK_RESPONSE_OK);
 108
 109   gtk_widget_show (message_dialog);
 110
 111   g_signal_connect (message_dialog, "response",
 112                     G_CALLBACK (gtk_widget_destroy), NULL);
 113 }
 114
 115 static void
 116 search_for_mimetype_ready_cb (GObject      *source,
 117                               GAsyncResult *res,
 118                               gpointer      user_data)
 119 {
 120   GtkAppChooserOnline *online = GTK_APP_CHOOSER_ONLINE (source);
 121   GtkAppChooserDialog *self = user_data;
 122   GError *error = NULL;
 123
 124   gdk_threads_enter ();
 125
 126   _gtk_app_chooser_online_search_for_mimetype_finish (online, res, &error);
 127
 128   if (error != NULL)
 129     {
 130       show_error_dialog (_("Failed to look for applications online"),
 131                          error->message, GTK_WINDOW (self));
 132       g_error_free (error);
 133     }
 134   else
 135     {
 136       gtk_app_chooser_refresh (GTK_APP_CHOOSER (self->priv->app_chooser_widget));
 137     }
 138
 139   gdk_threads_leave ();
 140 }
 141
 142 static void
 143 online_button_clicked_cb (GtkButton *b,
 144                           gpointer   user_data)
 145 {
 146   GtkAppChooserDialog *self = user_data;
 147
 148   _gtk_app_chooser_online_search_for_mimetype_async (self->priv->online,
 149                                                      self->priv->content_type,
 150                                                      GTK_WINDOW (self),
 151                                                      search_for_mimetype_ready_cb,
 152                                                      self);
 153 }
 154
 155 static void
 156 app_chooser_online_get_default_ready_cb (GObject *source,
 157                                          GAsyncResult *res,
 158                                          gpointer user_data)
 159 {
 160   GtkAppChooserDialog *self = user_data;
 161
 162   gdk_threads_enter ();
 163
 164   self->priv->online = _gtk_app_chooser_online_get_default_finish (source, res);
 165
 166   if (self->priv->online != NULL)
 167     {
 168       GtkWidget *action_area;
 169
 170       action_area = gtk_dialog_get_action_area (GTK_DIALOG (self));
 171       self->priv->online_button = gtk_button_new_with_label (_("Find applications online"));
 172       gtk_box_pack_start (GTK_BOX (action_area), self->priv->online_button,
 173                           FALSE, FALSE, 0);
 174       gtk_button_box_set_child_secondary (GTK_BUTTON_BOX (action_area), self->priv->online_button,
 175                                           TRUE);
 176       g_signal_connect (self->priv->online_button, "clicked",
 177                         G_CALLBACK (online_button_clicked_cb), self);
 178
 179
 180       if (!self->priv->content_type)
 181         gtk_widget_set_sensitive (self->priv->online_button, FALSE);
 182
 183       gtk_widget_show (self->priv->online_button);
 184     }
 185
 186   gdk_threads_leave ();
 187 }
 188
 189 static void
 190 ensure_online_button (GtkAppChooserDialog *self)
 191 {
 192   _gtk_app_chooser_online_get_default_async (app_chooser_online_get_default_ready_cb, self);
 193 }
 194
 195 /* An application is valid if:
 196  *
 197  * 1) The file exists
 198  * 2) The user has permissions to run the file
 199  */
 200 static gboolean
 201 check_application (GtkAppChooserDialog  *self,
 202                    GAppInfo            **app_out)
 203 {
 204   const char *command;
 205   char *path = NULL;
 206   char **argv = NULL;
 207   int argc;
 208   GError *error = NULL;
 209   gint retval = TRUE;
 210   GAppInfo *info;
 211
 212   command = NULL;
 213
 214   info = gtk_app_chooser_get_app_info (GTK_APP_CHOOSER (self->priv->app_chooser_widget));
 215   if (info == NULL)
 216     {
 217       *app_out = NULL;
 218       return FALSE;
 219     }
 220
 221   command = g_app_info_get_executable (info);
 222
 223   g_shell_parse_argv (command, &argc, &argv, &error);
 224
 225   if (error)
 226     {
 227       show_error_dialog (_("Could not run application"),
 228                          error->message,
 229                          GTK_WINDOW (self));
 230       g_error_free (error);
 231       retval = FALSE;
 232       goto cleanup;
 233     }
 234
 235   path = g_find_program_in_path (argv[0]);
 236   if (!path)
 237     {
 238       char *error_message;
 239
 240       error_message = g_strdup_printf (_("Could not find '%s'"),
 241                                        argv[0]);
 242
 243       show_error_dialog (_("Could not find application"),
 244                          error_message,
 245                          GTK_WINDOW (self));
 246       g_free (error_message);
 247       retval = FALSE;
 248       goto cleanup;
 249     }
 250
 251   *app_out = info;
 252
 253  cleanup:
 254   g_strfreev (argv);
 255   g_free (path);
 256
 257   return retval;
 258 }
 259
 260 static void
 261 add_or_find_application (GtkAppChooserDialog *self)
 262 {
 263   GAppInfo *app;
 264
 265   app = gtk_app_chooser_get_app_info (GTK_APP_CHOOSER (self));
 266
 267   if (app)
 268     {
 269       /* we don't care about reporting errors here */
 270       if (self->priv->content_type)
 271         g_app_info_set_as_last_used_for_type (app,
 272                                               self->priv->content_type,
 273                                               NULL);
 274       g_object_unref (app);
 275     }
 276 }
 277
 278 static void
 279 gtk_app_chooser_dialog_response (GtkDialog *dialog,
 280                                  gint       response_id,
 281                                  gpointer   user_data)
 282 {
 283   GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (dialog);
 284
 285   switch (response_id)
 286     {
 287     case GTK_RESPONSE_OK:
 288       add_or_find_application (self);
 289       break;
 290     default :
 291       break;
 292     }
 293 }
 294
 295 static void
 296 widget_application_selected_cb (GtkAppChooserWidget *widget,
 297                                 GAppInfo            *app_info,
 298                                 gpointer             user_data)
 299 {
 300   GtkAppChooserDialog *self = user_data;
 301
 302   gtk_widget_set_sensitive (self->priv->button, TRUE);
 303 }
 304
 305 static void
 306 widget_application_activated_cb (GtkAppChooserWidget *widget,
 307                                  GAppInfo            *app_info,
 308                                  gpointer             user_data)
 309 {
 310   GtkAppChooserDialog *self = user_data;
 311
 312   gtk_dialog_response (GTK_DIALOG (self), GTK_RESPONSE_OK);
 313 }
 314
 315 static char *
 316 get_extension (const char *basename)
 317 {
 318   char *p;
 319
 320   p = strrchr (basename, '.');
 321
 322   if (p && *(p + 1) != '\0')
 323     return g_strdup (p + 1);
 324
 325   return NULL;
 326 }
 327
 328 static void
 329 set_dialog_properties (GtkAppChooserDialog *self)
 330 {
 331   gchar *label;
 332   gchar *name;
 333   gchar *extension;
 334   gchar *description;
 335   gchar *default_text;
 336   gchar *string;
 337   gboolean unknown;
 338   PangoFontDescription *font_desc;
 339
 340   name = NULL;
 341   extension = NULL;
 342   label = NULL;
 343   description = NULL;
 344   unknown = TRUE;
 345
 346   if (self->priv->gfile != NULL)
 347     {
 348       name = g_file_get_basename (self->priv->gfile);
 349       extension = get_extension (name);
 350     }
 351
 352   if (self->priv->content_type)
 353     {
 354       description = g_content_type_get_description (self->priv->content_type);
 355       unknown = g_content_type_is_unknown (self->priv->content_type);
 356     }
 357
 358   gtk_window_set_title (GTK_WINDOW (self), "");
 359
 360   if (name != NULL)
 361     {
 362       /* Translators: %s is a filename */
 363       label = g_strdup_printf (_("Select an application to open \"%s\""), name);
 364       string = g_strdup_printf (_("No applications available to open \"%s\""),
 365                                 name);
 366     }
 367   else
 368     {
 369       /* Translators: %s is a file type description */
 370       label = g_strdup_printf (_("Select an application for \"%s\" files"),
 371                                unknown ? self->priv->content_type : description);
 372       string = g_strdup_printf (_("No applications available to open \"%s\" files"),
 373                                unknown ? self->priv->content_type : description);
 374     }
 375
 376   font_desc = pango_font_description_new ();
 377   pango_font_description_set_weight (font_desc, PANGO_WEIGHT_BOLD);
 378   gtk_widget_override_font (self->priv->label, font_desc);
 379   pango_font_description_free (font_desc);
 380
 381   if (self->priv->heading != NULL)
 382     gtk_label_set_markup (GTK_LABEL (self->priv->label), self->priv->heading);
 383   else
 384     gtk_label_set_markup (GTK_LABEL (self->priv->label), label);
 385
 386   default_text = g_strdup_printf ("<big><b>%s</b></big>\n%s",
 387                                   string,
 388                                   _("Click \"Show other applications\", for more options, or "
 389                                     "\"Find applications online\" to install a new application"));
 390
 391   gtk_app_chooser_widget_set_default_text (GTK_APP_CHOOSER_WIDGET (self->priv->app_chooser_widget),
 392                                            default_text);
 393
 394   g_free (label);
 395   g_free (name);
 396   g_free (extension);
 397   g_free (description);
 398   g_free (string);
 399   g_free (default_text);
 400 }
 401
 402 static void
 403 show_more_button_clicked_cb (GtkButton *button,
 404                              gpointer   user_data)
 405 {
 406   GtkAppChooserDialog *self = user_data;
 407
 408   g_object_set (self->priv->app_chooser_widget,
 409                 "show-recommended", TRUE,
 410                 "show-fallback", TRUE,
 411                 "show-other", TRUE,
 412                 NULL);
 413
 414   gtk_widget_hide (self->priv->show_more_button);
 415   self->priv->show_more_clicked = TRUE;
 416 }
 417
 418 static void
 419 widget_notify_for_button_cb (GObject    *source,
 420                              GParamSpec *pspec,
 421                              gpointer    user_data)
 422 {
 423   GtkAppChooserDialog *self = user_data;
 424   GtkAppChooserWidget *widget = GTK_APP_CHOOSER_WIDGET (source);
 425   gboolean should_hide;
 426
 427   should_hide = gtk_app_chooser_widget_get_show_other (widget) ||
 428     self->priv->show_more_clicked;
 429
 430   if (should_hide)
 431     gtk_widget_hide (self->priv->show_more_button);
 432 }
 433
 434 static void
 435 forget_menu_item_activate_cb (GtkMenuItem *item,
 436                               gpointer     user_data)
 437 {
 438   GtkAppChooserDialog *self = user_data;
 439   GAppInfo *info;
 440
 441   info = gtk_app_chooser_get_app_info (GTK_APP_CHOOSER (self));
 442
 443   if (info != NULL)
 444     {
 445       g_app_info_remove_supports_type (info, self->priv->content_type, NULL);
 446
 447       gtk_app_chooser_refresh (GTK_APP_CHOOSER (self));
 448
 449       g_object_unref (info);
 450     }
 451 }
 452
 453 static GtkWidget *
 454 build_forget_menu_item (GtkAppChooserDialog *self)
 455 {
 456   GtkWidget *retval;
 457
 458   retval = gtk_menu_item_new_with_label (_("Forget association"));
 459   gtk_widget_show (retval);
 460
 461   g_signal_connect (retval, "activate",
 462                     G_CALLBACK (forget_menu_item_activate_cb), self);
 463
 464   return retval;
 465 }
 466
 467 static void
 468 widget_populate_popup_cb (GtkAppChooserWidget *widget,
 469                           GtkMenu             *menu,
 470                           GAppInfo            *info,
 471                           gpointer             user_data)
 472 {
 473   GtkAppChooserDialog *self = user_data;
 474   GtkWidget *menu_item;
 475
 476   if (g_app_info_can_remove_supports_type (info))
 477     {
 478       menu_item = build_forget_menu_item (self);
 479       gtk_menu_shell_append (GTK_MENU_SHELL (menu), menu_item);
 480     }
 481 }
 482
 483 static void
 484 build_dialog_ui (GtkAppChooserDialog *self)
 485 {
 486   GtkWidget *vbox;
 487   GtkWidget *vbox2;
 488   GtkWidget *button, *w;
 489
 490   gtk_container_set_border_width (GTK_CONTAINER (self), 5);
 491
 492   vbox = gtk_box_new (GTK_ORIENTATION_VERTICAL, 12);
 493   gtk_container_set_border_width (GTK_CONTAINER (vbox), 5);
 494   gtk_box_pack_start (GTK_BOX (gtk_dialog_get_content_area (GTK_DIALOG (self))), vbox, TRUE, TRUE, 0);
 495   gtk_widget_show (vbox);
 496
 497   vbox2 = gtk_box_new (GTK_ORIENTATION_VERTICAL, 6);
 498   gtk_box_pack_start (GTK_BOX (vbox), vbox2, TRUE, TRUE, 0);
 499   gtk_widget_show (vbox2);
 500
 501   self->priv->label = gtk_label_new ("");
 502   gtk_widget_set_halign (self->priv->label, GTK_ALIGN_START);
 503   gtk_widget_set_valign (self->priv->label, GTK_ALIGN_CENTER);
 504   gtk_label_set_line_wrap (GTK_LABEL (self->priv->label), TRUE);
 505   gtk_box_pack_start (GTK_BOX (vbox2), self->priv->label,
 506                       FALSE, FALSE, 0);
 507   gtk_widget_show (self->priv->label);
 508
 509   self->priv->app_chooser_widget =
 510     gtk_app_chooser_widget_new (self->priv->content_type);
 511   gtk_box_pack_start (GTK_BOX (vbox2), self->priv->app_chooser_widget, TRUE, TRUE, 0);
 512   gtk_widget_show (self->priv->app_chooser_widget);
 513
 514   g_signal_connect (self->priv->app_chooser_widget, "application-selected",
 515                     G_CALLBACK (widget_application_selected_cb), self);
 516   g_signal_connect (self->priv->app_chooser_widget, "application-activated",
 517                     G_CALLBACK (widget_application_activated_cb), self);
 518   g_signal_connect (self->priv->app_chooser_widget, "notify::show-other",
 519                     G_CALLBACK (widget_notify_for_button_cb), self);
 520   g_signal_connect (self->priv->app_chooser_widget, "populate-popup",
 521                     G_CALLBACK (widget_populate_popup_cb), self);
 522
 523   button = gtk_button_new_with_label (_("Show other applications"));
 524   self->priv->show_more_button = button;
 525   w = gtk_image_new_from_stock (GTK_STOCK_ADD,
 526                                 GTK_ICON_SIZE_BUTTON);
 527   gtk_button_set_image (GTK_BUTTON (button), w);
 528   gtk_box_pack_start (GTK_BOX (self->priv->app_chooser_widget), button, FALSE, FALSE, 6);
 529   gtk_widget_show_all (button);
 530
 531   g_signal_connect (button, "clicked",
 532                     G_CALLBACK (show_more_button_clicked_cb), self);
 533
 534   gtk_dialog_add_button (GTK_DIALOG (self),
 535                          GTK_STOCK_CANCEL,
 536                          GTK_RESPONSE_CANCEL);
 537
 538   self->priv->button = gtk_dialog_add_button (GTK_DIALOG (self),
 539                                               _("_Select"),
 540                                               GTK_RESPONSE_OK);
 541
 542   gtk_dialog_set_default_response (GTK_DIALOG (self),
 543                                    GTK_RESPONSE_OK);
 544 }
 545
 546 static void
 547 set_gfile_and_content_type (GtkAppChooserDialog *self,
 548                             GFile *file)
 549 {
 550   GFileInfo *info;
 551
 552   if (file == NULL)
 553     return;
 554
 555   self->priv->gfile = g_object_ref (file);
 556
 557   info = g_file_query_info (self->priv->gfile,
 558                             G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE,
 559                             0, NULL, NULL);
 560   self->priv->content_type = g_strdup (g_file_info_get_content_type (info));
 561
 562   g_object_unref (info);
 563 }
 564
 565 static GAppInfo *
 566 gtk_app_chooser_dialog_get_app_info (GtkAppChooser *object)
 567 {
 568   GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
 569   GAppInfo *app = NULL;
 570
 571   if (!check_application (self, &app))
 572     return NULL;
 573
 574   return app;
 575 }
 576
 577 static void
 578 gtk_app_chooser_dialog_refresh (GtkAppChooser *object)
 579 {
 580   GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
 581
 582   gtk_app_chooser_refresh (GTK_APP_CHOOSER (self->priv->app_chooser_widget));
 583 }
 584
 585 static void
 586 gtk_app_chooser_dialog_constructed (GObject *object)
 587 {
 588   GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
 589
 590   if (G_OBJECT_CLASS (gtk_app_chooser_dialog_parent_class)->constructed != NULL)
 591     G_OBJECT_CLASS (gtk_app_chooser_dialog_parent_class)->constructed (object);
 592
 593   build_dialog_ui (self);
 594   set_dialog_properties (self);
 595   ensure_online_button (self);
 596 }
 597
 598 static void
 599 gtk_app_chooser_dialog_dispose (GObject *object)
 600 {
 601   GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
 602
 603   g_clear_object (&self->priv->gfile);
 604   g_clear_object (&self->priv->online);
 605
 606   G_OBJECT_CLASS (gtk_app_chooser_dialog_parent_class)->dispose (object);
 607 }
 608
 609 static void
 610 gtk_app_chooser_dialog_finalize (GObject *object)
 611 {
 612   GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
 613
 614   g_free (self->priv->content_type);
 615
 616   G_OBJECT_CLASS (gtk_app_chooser_dialog_parent_class)->finalize (object);
 617 }
 618
 619 static void
 620 gtk_app_chooser_dialog_set_property (GObject      *object,
 621                                      guint         property_id,
 622                                      const GValue *value,
 623                                      GParamSpec   *pspec)
 624 {
 625   GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
 626
 627   switch (property_id)
 628     {
 629     case PROP_GFILE:
 630       set_gfile_and_content_type (self, g_value_get_object (value));
 631       break;
 632     case PROP_CONTENT_TYPE:
 633       /* don't try to override a value previously set with the GFile */
 634       if (self->priv->content_type == NULL)
 635         self->priv->content_type = g_value_dup_string (value);
 636       break;
 637     case PROP_HEADING:
 638       gtk_app_chooser_dialog_set_heading (self, g_value_get_string (value));
 639       break;
 640     default:
 641       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
 642       break;
 643     }
 644 }
 645
 646 static void
 647 gtk_app_chooser_dialog_get_property (GObject    *object,
 648                                      guint       property_id,
 649                                      GValue     *value,
 650                                      GParamSpec *pspec)
 651 {
 652   GtkAppChooserDialog *self = GTK_APP_CHOOSER_DIALOG (object);
 653
 654   switch (property_id)
 655     {
 656     case PROP_GFILE:
 657       if (self->priv->gfile != NULL)
 658         g_value_set_object (value, self->priv->gfile);
 659       break;
 660     case PROP_CONTENT_TYPE:
 661       g_value_set_string (value, self->priv->content_type);
 662       break;
 663     case PROP_HEADING:
 664       g_value_set_string (value, self->priv->heading);
 665       break;
 666     default:
 667       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
 668       break;
 669     }
 670 }
 671
 672 static void
 673 gtk_app_chooser_dialog_iface_init (GtkAppChooserIface *iface)
 674 {
 675   iface->get_app_info = gtk_app_chooser_dialog_get_app_info;
 676   iface->refresh = gtk_app_chooser_dialog_refresh;
 677 }
 678
 679 static void
 680 gtk_app_chooser_dialog_class_init (GtkAppChooserDialogClass *klass)
 681 {
 682   GObjectClass *gobject_class;
 683   GParamSpec *pspec;
 684
 685   gobject_class = G_OBJECT_CLASS (klass);
 686   gobject_class->dispose = gtk_app_chooser_dialog_dispose;
 687   gobject_class->finalize = gtk_app_chooser_dialog_finalize;
 688   gobject_class->set_property = gtk_app_chooser_dialog_set_property;
 689   gobject_class->get_property = gtk_app_chooser_dialog_get_property;
 690   gobject_class->constructed = gtk_app_chooser_dialog_constructed;
 691
 692   g_object_class_override_property (gobject_class, PROP_CONTENT_TYPE, "content-type");
 693
 694   /**
 695    * GtkAppChooserDialog:gfile:
 696    *
 697    * The GFile used by the #GtkAppChooserDialog.
 698    * The dialog's #GtkAppChooserWidget content type will be guessed from the
 699    * file, if present.
 700    */
 701   pspec = g_param_spec_object ("gfile",
 702                                P_("GFile"),
 703                                P_("The GFile used by the app chooser dialog"),
 704                                G_TYPE_FILE,
 705                                G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE |
 706                                G_PARAM_STATIC_STRINGS);
 707   g_object_class_install_property (gobject_class, PROP_GFILE, pspec);
 708
 709   /**
 710    * GtkAppChooserDialog:heading:
 711    *
 712    * The text to show at the top of the dialog.
 713    * The string may contain Pango markup.
 714    */
 715   pspec = g_param_spec_string ("heading",
 716                                P_("Heading"),
 717                                P_("The text to show at the top of the dialog"),
 718                                NULL,
 719                                G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
 720   g_object_class_install_property (gobject_class, PROP_HEADING, pspec);
 721
 722
 723   g_type_class_add_private (klass, sizeof (GtkAppChooserDialogPrivate));
 724 }
 725
 726 static void
 727 gtk_app_chooser_dialog_init (GtkAppChooserDialog *self)
 728 {
 729   self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, GTK_TYPE_APP_CHOOSER_DIALOG,
 730                                             GtkAppChooserDialogPrivate);
 731
 732   /* we can't override the class signal handler here, as it's a RUN_LAST;
 733    * we want our signal handler instead to be executed before any user code.
 734    */
 735   g_signal_connect (self, "response",
 736                     G_CALLBACK (gtk_app_chooser_dialog_response), NULL);
 737 }
 738
 739 static void
 740 set_parent_and_flags (GtkWidget      *dialog,
 741                       GtkWindow      *parent,
 742                       GtkDialogFlags  flags)
 743 {
 744   if (parent != NULL)
 745     gtk_window_set_transient_for (GTK_WINDOW (dialog), parent);
 746
 747   if (flags & GTK_DIALOG_MODAL)
 748     gtk_window_set_modal (GTK_WINDOW (dialog), TRUE);
 749
 750   if (flags & GTK_DIALOG_DESTROY_WITH_PARENT)
 751     gtk_window_set_destroy_with_parent (GTK_WINDOW (dialog), TRUE);
 752 }
 753
 754 /**
 755  * gtk_app_chooser_dialog_new:
 756  * @parent: (allow-none): a #GtkWindow, or %NULL
 757  * @flags: flags for this dialog
 758  * @file: a #GFile
 759  *
 760  * Creates a new #GtkAppChooserDialog for the provided #GFile,
 761  * to allow the user to select an application for it.
 762  *
 763  * Returns: a newly created #GtkAppChooserDialog
 764  *
 765  * Since: 3.0
 766  **/
 767 GtkWidget *
 768 gtk_app_chooser_dialog_new (GtkWindow      *parent,
 769                             GtkDialogFlags  flags,
 770                             GFile          *file)
 771 {
 772   GtkWidget *retval;
 773
 774   g_return_val_if_fail (G_IS_FILE (file), NULL);
 775
 776   retval = g_object_new (GTK_TYPE_APP_CHOOSER_DIALOG,
 777                          "gfile", file,
 778                          NULL);
 779
 780   set_parent_and_flags (retval, parent, flags);
 781
 782   return retval;
 783 }
 784
 785 /**
 786  * gtk_app_chooser_dialog_new_for_content_type:
 787  * @parent: (allow-none): a #GtkWindow, or %NULL
 788  * @flags: flags for this dialog
 789  * @content_type: a content type string
 790  *
 791  * Creates a new #GtkAppChooserDialog for the provided content type,
 792  * to allow the user to select an application for it.
 793  *
 794  * Returns: a newly created #GtkAppChooserDialog
 795  *
 796  * Since: 3.0
 797  **/
 798 GtkWidget *
 799 gtk_app_chooser_dialog_new_for_content_type (GtkWindow      *parent,
 800                                              GtkDialogFlags  flags,
 801                                              const gchar    *content_type)
 802 {
 803   GtkWidget *retval;
 804
 805   g_return_val_if_fail (content_type != NULL, NULL);
 806
 807   retval = g_object_new (GTK_TYPE_APP_CHOOSER_DIALOG,
 808                          "content-type", content_type,
 809                          NULL);
 810
 811   set_parent_and_flags (retval, parent, flags);
 812
 813   return retval;
 814 }
 815
 816 /**
 817  * gtk_app_chooser_dialog_get_widget:
 818  * @self: a #GtkAppChooserDialog
 819  *
 820  * Returns the #GtkAppChooserWidget of this dialog.
 821  *
 822  * Returns: (transfer none): the #GtkAppChooserWidget of @self
 823  *
 824  * Since: 3.0
 825  */
 826 GtkWidget *
 827 gtk_app_chooser_dialog_get_widget (GtkAppChooserDialog *self)
 828 {
 829   g_return_val_if_fail (GTK_IS_APP_CHOOSER_DIALOG (self), NULL);
 830
 831   return self->priv->app_chooser_widget;
 832 }
 833
 834 /**
 835  * gtk_app_chooser_dialog_set_heading:
 836  * @self: a #GtkAppChooserDialog
 837  * @heading: a string containing Pango markup
 838  *
 839  * Sets the text to display at the top of the dialog.
 840  * If the heading is not set, the dialog displays a default text.
 841  */
 842 void
 843 gtk_app_chooser_dialog_set_heading (GtkAppChooserDialog *self,
 844                                     const gchar         *heading)
 845 {
 846   g_return_if_fail (GTK_IS_APP_CHOOSER_DIALOG (self));
 847
 848   g_free (self->priv->heading);
 849   self->priv->heading = g_strdup (heading);
 850
 851   if (self->priv->label && self->priv->heading)
 852     gtk_label_set_markup (GTK_LABEL (self->priv->label), self->priv->heading);
 853
 854   g_object_notify (G_OBJECT (self), "heading");
 855 }
 856
 857 /**
 858  * gtk_app_chooser_dialog_get_heading:
 859  * @self: a #GtkAppChooserDialog
 860  *
 861  * Returns the text to display at the top of the dialog.
 862  *
 863  * Returns: the text to display at the top of the dialog, or %NULL, in which
 864  *     case a default text is displayed
 865  */
 866 const gchar *
 867 gtk_app_chooser_dialog_get_heading (GtkAppChooserDialog *self)
 868 {
 869   g_return_val_if_fail (GTK_IS_APP_CHOOSER_DIALOG (self), NULL);
 870
 871   return self->priv->heading;
 872 }