[empathy: 5/12] Improved confirmation dialog shown to the user before discarding changes

[Cosimo Cecchi <cosimoc src gnome org>]

commit cb75a2c77a35fbf7ace246d5c45d7ecda8ae8ab1
Author: Jonathan Tellier <jonathan tellier gmail com>
Date:   Fri Aug 28 10:45:54 2009 -0400

    Improved confirmation dialog shown to the user before discarding changes
    
    - Split the confirmation dialog's text into a primary and secondary
      section.
    - Changed the button label to "Cancel" and "Discard" instead of "Yes"
      and "No".
    - Added a accounts_dialog_show_question_dialog() function to show
      question dialogs related to the accounts dialog and connect to its
      "response" signal.
    - Removed the empathy_show_yes_no_question_dialog() function since it
      was added for this specific patch but is no longer used.

 libempathy-gtk/empathy-ui-utils.c |   28 -------
 libempathy-gtk/empathy-ui-utils.h |    6 --
 src/empathy-accounts-dialog.c     |  153 +++++++++++++++++++++++--------------
 3 files changed, 94 insertions(+), 93 deletions(-)
---
diff --git a/libempathy-gtk/empathy-ui-utils.c b/libempathy-gtk/empathy-ui-utils.c
index e7b8fce..3089c46 100644
--- a/libempathy-gtk/empathy-ui-utils.c
+++ b/libempathy-gtk/empathy-ui-utils.c
@@ -1551,31 +1551,3 @@ empathy_receive_file_with_file_chooser (EmpathyFTHandler *handler)
 
 	gtk_widget_show (widget);
 }
-
-/** empathy_show_yes_no_question_dialog:
- * @parent: The parent of the message dialog
- * @message: The question message
- * @response_callback: The callback connected to the "response" signal of
- * the message dialog.
- * @user_data: User data to pass to the @response_callback.
- *
- * A simple utility function to create a modal yes/no question message dialog
- * and hooking to its "response" signal.
- */
-void empathy_show_yes_no_question_dialog (GtkWindow *parent,
-    gchar *message,
-    GCallback response_callback,
-    gpointer user_data)
-{
-  GtkWidget *message_dialog;
-
-  message_dialog = gtk_message_dialog_new (parent,
-    GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
-    GTK_MESSAGE_QUESTION,
-    GTK_BUTTONS_YES_NO,
-    message);
-
-  g_signal_connect (message_dialog, "response", response_callback, user_data);
-
-  gtk_widget_show (message_dialog);
-}
diff --git a/libempathy-gtk/empathy-ui-utils.h b/libempathy-gtk/empathy-ui-utils.h
index 2d54f98..39baeaf 100644
--- a/libempathy-gtk/empathy-ui-utils.h
+++ b/libempathy-gtk/empathy-ui-utils.h
@@ -113,12 +113,6 @@ gchar *     empathy_make_absolute_url                   (const gchar *url);
 gchar *     empathy_make_absolute_url_len               (const gchar *url,
 							 guint len);
 
-/* Message Dialogs */
-void empathy_show_yes_no_question_dialog (GtkWindow *parent,
-    gchar *message,
-    GCallback response_callback,
-    gpointer user_data);
-
 G_END_DECLS
 
 #endif /*  __EMPATHY_UI_UTILS_H__ */
diff --git a/src/empathy-accounts-dialog.c b/src/empathy-accounts-dialog.c
index 31e29b6..807c78b 100644
--- a/src/empathy-accounts-dialog.c
+++ b/src/empathy-accounts-dialog.c
@@ -57,6 +57,11 @@
 /* Flashing delay for icons (milliseconds). */
 #define FLASH_TIMEOUT 500
 
+/* The primary text of the dialog shown to the user when he is about to lose
+ * unsaved changes */
+#define PENDING_CHANGES_QUESTION_PRIMARY_TEXT \
+  "There are unsaved modification regarding your %s account."
+
 #define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyAccountsDialog)
 G_DEFINE_TYPE (EmpathyAccountsDialog, empathy_accounts_dialog, G_TYPE_OBJECT);
 
@@ -418,6 +423,46 @@ accounts_dialog_setup_ui_to_add_account (EmpathyAccountsDialog *dialog)
 }
 
 static void
+accounts_dialog_show_question_dialog (EmpathyAccountsDialog *dialog,
+    gchar *primary_text,
+    gchar *secondary_text,
+    GCallback response_callback,
+    gpointer user_data,
+    const gchar *first_button_text,
+    ...)
+{
+  va_list button_args;
+  GtkWidget *message_dialog;
+  const gchar *button_text;
+  EmpathyAccountsDialogPriv *priv = GET_PRIV (dialog);
+
+  message_dialog = gtk_message_dialog_new (GTK_WINDOW (priv->window),
+      GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
+      GTK_MESSAGE_QUESTION,
+      GTK_BUTTONS_NONE,
+      primary_text);
+
+  gtk_message_dialog_format_secondary_text (
+      GTK_MESSAGE_DIALOG (message_dialog), secondary_text);
+
+  va_start (button_args, first_button_text);
+  for (button_text = first_button_text;
+       button_text;
+       button_text = va_arg (button_args, const gchar *))
+    {
+      gint response_id;
+      response_id = va_arg (button_args, gint);
+
+      gtk_dialog_add_button (GTK_DIALOG (message_dialog), button_text, response_id);
+    }
+  va_end (button_args);
+
+  g_signal_connect (message_dialog, "response", response_callback, user_data);
+
+  gtk_widget_show (message_dialog);
+}
+
+static void
 accounts_dialog_add_pending_changes_response_cb (GtkDialog *message_dialog,
   gint response_id,
   gpointer *user_data)
@@ -440,24 +485,22 @@ accounts_dialog_button_add_clicked_cb (GtkWidget *button,
     EmpathyAccountsDialog *dialog)
 {
   EmpathyAccount *account;
-  EmpathyAccountsDialogPriv *priv = GET_PRIV (dialog);
 
   if (accounts_dialog_has_pending_change (dialog, &account))
     {
-      gchar *message;
-
-      message = g_strdup_printf (
-          _("There are unsaved modification regarding your %s account.\n"
-              "You are about to create a new account, which will discard\n"
-              "your changes. Are you sure you want to proceed?"),
-              empathy_account_get_display_name (account));
-
-      empathy_show_yes_no_question_dialog (GTK_WINDOW (priv->window),
-          message,
-          G_CALLBACK (accounts_dialog_add_pending_changes_response_cb),
-          dialog);
-
-      g_free (message);
+    gchar *question_dialog_primary_text = g_strdup_printf (
+        PENDING_CHANGES_QUESTION_PRIMARY_TEXT,
+        empathy_account_get_display_name (account));
+
+    accounts_dialog_show_question_dialog (dialog, question_dialog_primary_text,
+        "You are about to create a new account, which will discard\n"
+          "your changes. Are you sure you want to proceed?",
+        G_CALLBACK (accounts_dialog_add_pending_changes_response_cb),
+        dialog,
+        GTK_STOCK_CANCEL, GTK_RESPONSE_NO,
+        GTK_STOCK_DISCARD, GTK_RESPONSE_YES, NULL);
+
+    g_free (question_dialog_primary_text);
     }
   else
     {
@@ -716,7 +759,7 @@ accounts_dialog_view_delete_activated_cb (EmpathyCellRendererActivatable *cell,
   EmpathyAccount *account;
   GtkTreeModel *model;
   GtkTreeIter iter;
-  GtkWidget *message_dialog;
+  gchar *question_dialog_primary_text;
   EmpathyAccountsDialogPriv *priv = GET_PRIV (dialog);
 
   model = gtk_tree_view_get_model (GTK_TREE_VIEW (priv->treeview));
@@ -733,34 +776,23 @@ accounts_dialog_view_delete_activated_cb (EmpathyCellRendererActivatable *cell,
       return;
     }
 
-  message_dialog = gtk_message_dialog_new
-      (GTK_WINDOW (priv->window),
-          GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
-          GTK_MESSAGE_QUESTION,
-          GTK_BUTTONS_NONE,
-          _("You are about to remove your %s account!\n"
-              "Are you sure you want to proceed?"),
-              empathy_account_get_display_name (account));
-
-  gtk_message_dialog_format_secondary_text
-  (GTK_MESSAGE_DIALOG (message_dialog),
+  question_dialog_primary_text = g_strdup_printf (
+      _("You are about to remove your %s account!\n"
+          "Are you sure you want to proceed?"),
+      empathy_account_get_display_name (account));
+
+  accounts_dialog_show_question_dialog (dialog, question_dialog_primary_text,
       _("Any associated conversations and chat rooms will NOT be "
           "removed if you decide to proceed.\n"
           "\n"
           "Should you decide to add the account back at a later time, "
-          "they will still be available."));
-
-  gtk_dialog_add_button (GTK_DIALOG (message_dialog),
-      GTK_STOCK_CANCEL,
-      GTK_RESPONSE_NO);
-  gtk_dialog_add_button (GTK_DIALOG (message_dialog),
-      GTK_STOCK_REMOVE,
-      GTK_RESPONSE_YES);
-
-  g_signal_connect (message_dialog, "response",
-      G_CALLBACK (accounts_dialog_delete_account_response_cb), dialog);
+          "they will still be available."),
+      G_CALLBACK (accounts_dialog_delete_account_response_cb),
+      dialog,
+      GTK_STOCK_CANCEL, GTK_RESPONSE_NO,
+      GTK_STOCK_REMOVE, GTK_RESPONSE_YES, NULL);
 
-  gtk_widget_show (message_dialog);
+  g_free (question_dialog_primary_text);
 
   if (account != NULL)
     g_object_unref (account);
@@ -925,20 +957,22 @@ accounts_dialog_account_selection_change (GtkTreeSelection *selection,
       /* The currently selected account has some unsaved changes. We ask
        * the user if he really wants to lose his changes and select another
        * account */
+      gchar *question_dialog_primary_text;
       priv->destination_path = gtk_tree_path_to_string (path);
-      gchar *message;
 
-      message = g_strdup_printf (
-          _("There are unsaved modification regarding your %s account.\n"
-          "You are about to select another account, which will discard\n"
-          "your changes. Are you sure you want to proceed?"),
+      question_dialog_primary_text = g_strdup_printf (
+          PENDING_CHANGES_QUESTION_PRIMARY_TEXT,
           empathy_account_get_display_name (account));
 
-      empathy_show_yes_no_question_dialog (GTK_WINDOW (priv->window),
-          message, G_CALLBACK (accounts_dialog_selection_change_response_cb),
-          dialog);
+      accounts_dialog_show_question_dialog (dialog, question_dialog_primary_text,
+          "You are about to select another account, which will discard\n"
+            "your changes. Are you sure you want to proceed?",
+          G_CALLBACK (accounts_dialog_selection_change_response_cb),
+          dialog,
+          GTK_STOCK_CANCEL, GTK_RESPONSE_NO,
+          GTK_STOCK_DISCARD, GTK_RESPONSE_YES, NULL);
 
-      g_free (message);
+      g_free (question_dialog_primary_text);
     }
   else
     {
@@ -1409,22 +1443,23 @@ accounts_dialog_response_cb (GtkWidget *widget,
     EmpathyAccountsDialog *dialog)
 {
   EmpathyAccount *account;
-  EmpathyAccountsDialogPriv *priv = GET_PRIV (dialog);
 
   if (accounts_dialog_has_pending_change (dialog, &account))
     {
-      gchar *message;
-
-      message = g_strdup_printf (
-        _("There are unsaved modifications regarding your %s account.\n"
-            "Are you sure you want to close the window? "),
-            empathy_account_get_display_name (account));
+      gchar *question_dialog_primary_text;
+      question_dialog_primary_text = g_strdup_printf (
+          PENDING_CHANGES_QUESTION_PRIMARY_TEXT,
+          empathy_account_get_display_name (account));
 
-      empathy_show_yes_no_question_dialog (GTK_WINDOW (priv->window),
-          message, G_CALLBACK (accounts_dialog_close_response_cb),
-          widget);
+      accounts_dialog_show_question_dialog (dialog, question_dialog_primary_text,
+          "You are about to close the window, which will discard\n"
+            "your changes. Are you sure you want to proceed?",
+          G_CALLBACK (accounts_dialog_close_response_cb),
+          widget,
+          GTK_STOCK_CANCEL, GTK_RESPONSE_NO,
+          GTK_STOCK_DISCARD, GTK_RESPONSE_YES, NULL);
 
-      g_free (message);
+      g_free (question_dialog_primary_text);
     }
   else if (response == GTK_RESPONSE_CLOSE)
     gtk_widget_destroy (widget);