[gnome-documents] lib: add GdMainToolbar

[Cosimo Cecchi <cosimoc src gnome org>]

commit 9bd9c7a1d33f0be3856cf89c7bec3e4707cb325e
Author: Cosimo Cecchi <cosimoc gnome org>
Date:   Mon Dec 5 15:55:23 2011 -0500

    lib: add GdMainToolbar
    
    Rewrite the main toolbar in a C class for share with other Finding and
    Reminding applications.

 src/Makefile-lib.am       |    2 +
 src/lib/gd-main-toolbar.c |  395 +++++++++++++++++++++++++++++++++++++++++++++
 src/lib/gd-main-toolbar.h |   99 +++++++++++
 3 files changed, 496 insertions(+), 0 deletions(-)
---
diff --git a/src/Makefile-lib.am b/src/Makefile-lib.am
index 1cf77b6..52b01a6 100644
--- a/src/Makefile-lib.am
+++ b/src/Makefile-lib.am
@@ -11,6 +11,7 @@ gdprivate_source_h = \
     lib/gd-gdata-goa-authorizer.c \
     lib/gd-gdata-goa-authorizer.h \
     lib/gd-utils.h \
+    lib/gd-main-toolbar.h \
     lib/gd-margin-container.h \
     lib/gd-pdf-loader.h \
     lib/gd-tagged-entry.h \
@@ -19,6 +20,7 @@ gdprivate_source_h = \
 
 gdprivate_source_c = \
     lib/gd-utils.c \
+    lib/gd-main-toolbar.c \
     lib/gd-margin-container.c \
     lib/gd-pdf-loader.c \
     lib/gd-tagged-entry.c \
diff --git a/src/lib/gd-main-toolbar.c b/src/lib/gd-main-toolbar.c
new file mode 100644
index 0000000..1f70579
--- /dev/null
+++ b/src/lib/gd-main-toolbar.c
@@ -0,0 +1,395 @@
+/*
+ * Copyright (c) 2011 Red Hat, Inc.
+ *
+ * Gnome Documents is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by the
+ * Free Software Foundation; either version 2 of the License, or (at your
+ * option) any later version.
+ *
+ * Gnome Documents is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+ * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with Gnome Documents; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ * Author: Cosimo Cecchi <cosimoc redhat com>
+ *
+ */
+
+#include "gd-main-toolbar.h"
+
+#include <math.h>
+#include <glib/gi18n.h>
+
+G_DEFINE_TYPE (GdMainToolbar, gd_main_toolbar, GTK_TYPE_TOOLBAR)
+
+struct _GdMainToolbarPrivate {
+  GtkSizeGroup *size_group;
+
+  GtkToolItem *left_group;
+  GtkToolItem *center_group;
+  GtkToolItem *right_group;
+
+  GtkWidget *left_grid;
+  GtkWidget *back;
+
+  GtkWidget *title_label;
+  GtkWidget *detail_label;
+
+  GtkWidget *right_grid;
+
+  GdMainToolbarMode mode;
+};
+
+enum {
+  SELECTION_MODE_REQUEST = 1,
+  GO_BACK_REQUEST,
+  CLEAR_REQUEST,
+  NUM_SIGNALS
+};
+
+static guint signals[NUM_SIGNALS] = { 0, };
+
+static void
+on_back_button_clicked (GtkButton *b,
+                        gpointer user_data)
+{
+  GdMainToolbar *self = user_data;
+  g_signal_emit (self, signals[GO_BACK_REQUEST], 0);
+}
+
+static void
+gd_main_toolbar_dispose (GObject *obj)
+{
+  GdMainToolbar *self = GD_MAIN_TOOLBAR (obj);
+
+  g_clear_object (&self->priv->size_group);
+
+  G_OBJECT_CLASS (gd_main_toolbar_parent_class)->dispose (obj);
+}
+
+static void
+gd_main_toolbar_constructed (GObject *obj)
+{
+  GdMainToolbar *self = GD_MAIN_TOOLBAR (obj);
+  GtkToolbar *tb = GTK_TOOLBAR (obj);
+  GtkWidget *w, *grid;
+
+  G_OBJECT_CLASS (gd_main_toolbar_parent_class)->constructed (obj);
+
+  /* left section */
+  self->priv->left_group = gtk_tool_item_new ();
+  gtk_widget_set_margin_right (GTK_WIDGET (self->priv->left_group), 12);
+  gtk_toolbar_insert (tb, self->priv->left_group, -1);
+
+  /* left button group */
+  self->priv->left_grid = gtk_grid_new ();
+  gtk_grid_set_column_spacing (GTK_GRID (self->priv->left_grid), 12);
+  gtk_container_add (GTK_CONTAINER (self->priv->left_group), self->priv->left_grid);
+
+  self->priv->back = gtk_button_new ();
+  gtk_style_context_add_class (gtk_widget_get_style_context (self->priv->back), "raised");
+  gtk_widget_set_no_show_all (self->priv->back, TRUE);
+  gtk_widget_set_halign (self->priv->back, GTK_ALIGN_START);
+  gtk_container_add (GTK_CONTAINER (self->priv->left_grid), self->priv->back);
+
+  w = gtk_image_new_from_icon_name ("go-previous-symbolic", GTK_ICON_SIZE_MENU);
+  gtk_widget_show (w);
+  gtk_image_set_pixel_size (GTK_IMAGE (w), 16);
+  gtk_container_add (GTK_CONTAINER (self->priv->back), w);
+
+  g_signal_connect (self->priv->back, "clicked",
+                    G_CALLBACK (on_back_button_clicked), self);
+
+  /* center section */
+  self->priv->center_group = gtk_tool_item_new ();
+  gtk_tool_item_set_expand (self->priv->center_group, TRUE);
+  gtk_toolbar_insert (tb, self->priv->center_group, -1);
+
+  /* centered label group */
+  grid = gtk_grid_new ();
+  gtk_widget_set_halign (grid, GTK_ALIGN_CENTER);
+  gtk_widget_set_valign (grid, GTK_ALIGN_CENTER);
+  gtk_container_add (GTK_CONTAINER (self->priv->center_group), grid);
+
+  self->priv->title_label = gtk_label_new (NULL);
+  gtk_label_set_ellipsize (GTK_LABEL (self->priv->title_label), PANGO_ELLIPSIZE_END);
+  gtk_container_add (GTK_CONTAINER (grid), self->priv->title_label);
+
+  self->priv->detail_label = gtk_label_new (NULL);
+  gtk_widget_set_no_show_all (self->priv->detail_label, TRUE);
+  gtk_widget_set_margin_left (self->priv->detail_label, 12);
+  gtk_style_context_add_class (gtk_widget_get_style_context (self->priv->detail_label), "dim-label");
+  gtk_container_add (GTK_CONTAINER (grid), self->priv->detail_label);
+
+  /* right section */
+  self->priv->right_group = gtk_tool_item_new ();
+  gtk_widget_set_margin_left (GTK_WIDGET (self->priv->right_group), 12);
+  gtk_toolbar_insert (tb, self->priv->right_group, -1);
+
+  self->priv->right_grid = gtk_grid_new ();
+  gtk_grid_set_column_spacing (GTK_GRID (self->priv->right_grid), 12);
+  gtk_container_add (GTK_CONTAINER (self->priv->right_group), self->priv->right_grid);
+
+  self->priv->size_group = gtk_size_group_new (GTK_SIZE_GROUP_HORIZONTAL);
+  gtk_size_group_add_widget (self->priv->size_group, GTK_WIDGET (self->priv->left_group));
+  gtk_size_group_add_widget (self->priv->size_group, GTK_WIDGET (self->priv->right_group));
+}
+
+static void
+gd_main_toolbar_init (GdMainToolbar *self)
+{
+  self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, GD_TYPE_MAIN_TOOLBAR, GdMainToolbarPrivate);
+  self->priv->mode = GD_MAIN_TOOLBAR_MODE_INVALID;
+}
+
+static void
+gd_main_toolbar_class_init (GdMainToolbarClass *klass)
+{
+  GObjectClass *oclass;
+
+  oclass = G_OBJECT_CLASS (klass);
+  oclass->constructed = gd_main_toolbar_constructed;
+  oclass->dispose = gd_main_toolbar_dispose;
+
+  signals[SELECTION_MODE_REQUEST] =
+    g_signal_new ("selection-mode-request",
+                  GD_TYPE_MAIN_TOOLBAR,
+                  G_SIGNAL_RUN_FIRST,
+                  0, NULL, NULL, NULL,
+                  G_TYPE_NONE,
+                  1, G_TYPE_BOOLEAN);
+  signals[GO_BACK_REQUEST] =
+    g_signal_new ("go-back-request",
+                  GD_TYPE_MAIN_TOOLBAR,
+                  G_SIGNAL_RUN_FIRST,
+                  0, NULL, NULL, NULL,
+                  G_TYPE_NONE, 0);
+  signals[CLEAR_REQUEST] =
+    g_signal_new ("clear-request",
+                  GD_TYPE_MAIN_TOOLBAR,
+                  G_SIGNAL_RUN_FIRST,
+                  0, NULL, NULL, NULL,
+                  G_TYPE_NONE, 0);
+
+  g_type_class_add_private (klass, sizeof (GdMainToolbarPrivate));
+}
+
+static void
+on_selection_mode_button_toggled (GtkToggleButton *tb,
+                                  gpointer user_data)
+{
+  GdMainToolbar *self = user_data;
+  gboolean toggled;
+
+  toggled = gtk_toggle_button_get_active (tb);
+  g_signal_emit (self, signals[SELECTION_MODE_REQUEST], 0, toggled);
+}
+
+static void
+on_selection_mode_done_button_clicked (GtkButton *b,
+                                       gpointer user_data)
+{
+  GdMainToolbar *self = user_data;
+  g_signal_emit (self, signals[SELECTION_MODE_REQUEST], 0, FALSE);
+}
+
+static void
+gd_main_toolbar_populate_for_selection (GdMainToolbar *self)
+{
+  GtkWidget *w;
+
+  gtk_style_context_add_class (gtk_widget_get_style_context (GTK_WIDGET (self)),
+                               "documents-selection-mode");
+  gtk_widget_reset_style (GTK_WIDGET (self));
+
+  /* right section */
+  w = gtk_button_new_with_label (_("Done"));
+  gtk_style_context_add_class (gtk_widget_get_style_context (w), "raised");
+  gtk_container_add (GTK_CONTAINER (self->priv->right_grid), w);
+
+  g_signal_connect (w, "clicked",
+                    G_CALLBACK (on_selection_mode_done_button_clicked), self);
+
+  gtk_widget_show_all (GTK_WIDGET (self));
+}
+
+static void
+gd_main_toolbar_populate_for_overview (GdMainToolbar *self)
+{
+  GtkWidget *selection_mode_button, *w;
+
+  /* right section */
+  selection_mode_button = gtk_toggle_button_new ();
+  w = gtk_image_new_from_icon_name ("emblem-default-symbolic", GTK_ICON_SIZE_MENU);
+  gtk_image_set_pixel_size (GTK_IMAGE (w), 16);
+  gtk_container_add (GTK_CONTAINER (selection_mode_button), w);
+
+  gtk_container_add (GTK_CONTAINER (self->priv->right_grid), selection_mode_button);
+
+  g_signal_connect (selection_mode_button, "toggled",
+                    G_CALLBACK (on_selection_mode_button_toggled), self);
+
+  gtk_widget_show_all (GTK_WIDGET (self));
+}
+
+static void
+gd_main_toolbar_populate_for_preview (GdMainToolbar *self)
+{
+  gtk_widget_show (self->priv->back);
+  gtk_widget_show_all (GTK_WIDGET (self));
+}
+
+static void
+on_left_grid_clear (GtkWidget *w,
+                    gpointer user_data)
+{
+  GdMainToolbar *self = user_data;
+
+  if (w != self->priv->back)
+    gtk_widget_destroy (w);
+}
+
+static void
+gd_main_toolbar_clear (GdMainToolbar *self)
+{
+  GtkWidget *w;
+  GtkStyleContext *context;
+
+  /* reset labels */
+  gtk_label_set_text (GTK_LABEL (self->priv->title_label), "");
+  gtk_label_set_text (GTK_LABEL (self->priv->detail_label), "");
+
+  /* clear all on the left, except the back button */
+  gtk_widget_hide (self->priv->back);
+  gtk_container_foreach (GTK_CONTAINER (self->priv->left_grid),
+                         on_left_grid_clear, self);
+
+  /* clear all on the right */
+  gtk_container_foreach (GTK_CONTAINER (self->priv->right_grid), 
+                         (GtkCallback) gtk_widget_destroy, self);
+
+  context = gtk_widget_get_style_context (GTK_WIDGET (self));
+  if (gtk_style_context_has_class (context, "documents-selection-mode"))
+    {
+      gtk_style_context_remove_class (context, "documents-selection-mode");
+      gtk_widget_reset_style (GTK_WIDGET (self));
+    }
+
+  g_signal_emit (self, signals[CLEAR_REQUEST], 0);
+}
+
+/**
+ * gd_main_toolbar_set_mode:
+ * @mode:
+ *
+ */
+void
+gd_main_toolbar_set_mode (GdMainToolbar *self,
+                          GdMainToolbarMode mode)
+{
+  if (mode == self->priv->mode)
+    return;
+
+  gd_main_toolbar_clear (self);
+  self->priv->mode = mode;
+
+  switch (mode)
+    {
+    case GD_MAIN_TOOLBAR_MODE_OVERVIEW:
+      gd_main_toolbar_populate_for_overview (self);
+      break;
+    case GD_MAIN_TOOLBAR_MODE_SELECTION:
+      gd_main_toolbar_populate_for_selection (self);
+      break;
+    case GD_MAIN_TOOLBAR_MODE_PREVIEW:
+      gd_main_toolbar_populate_for_preview (self);
+      break;
+    default:
+      g_assert_not_reached ();
+      break;
+    }
+}
+
+/**
+ * gd_main_toolbar_set_labels:
+ * @self:
+ * @primary: (allow-none):
+ * @detail: (allow-none):
+ *
+ */
+void
+gd_main_toolbar_set_labels (GdMainToolbar *self,
+                            const gchar *primary,
+                            const gchar *detail)
+{
+  gchar *real_primary = NULL;
+
+  if (primary != NULL)
+    real_primary = g_markup_printf_escaped ("<b>%s</b>", primary);
+
+  if (real_primary == NULL)
+    {
+      gtk_label_set_markup (GTK_LABEL (self->priv->title_label), "");
+      gtk_widget_hide (self->priv->title_label);
+    }
+  else
+    {
+      gtk_label_set_markup (GTK_LABEL (self->priv->title_label), real_primary);
+      gtk_widget_show (self->priv->title_label);
+    }
+
+  if (detail == NULL)
+    {
+      gtk_label_set_text (GTK_LABEL (self->priv->detail_label), "");
+      gtk_widget_hide (self->priv->detail_label);
+    }
+  else
+    {
+      gtk_label_set_text (GTK_LABEL (self->priv->detail_label), detail);
+      gtk_widget_show (self->priv->detail_label);
+    }
+
+  g_free (real_primary);
+}
+
+/**
+ * gd_main_toolbar_set_back_visible:
+ * @self:
+ * @visible:
+ *
+ */
+void
+gd_main_toolbar_set_back_visible (GdMainToolbar *self,
+                                  gboolean visible)
+{
+  if (visible != gtk_widget_get_visible (self->priv->back))
+    gtk_widget_set_visible (self->priv->back, visible);
+
+}
+
+void
+gd_main_toolbar_add_widget (GdMainToolbar         *self,
+                            GtkWidget             *widget,
+                            GdMainToolbarPosition  position)
+{
+  if (position == GD_MAIN_TOOLBAR_POSITION_LEFT)
+    /* append on the left grid */
+    gtk_container_add (GTK_CONTAINER (self->priv->left_grid), widget);
+  else if (position == GD_MAIN_TOOLBAR_POSITION_RIGHT)
+    {
+      /* prepend on the right grid */
+      gtk_grid_insert_column (GTK_GRID (self->priv->right_grid), 0);
+      gtk_grid_attach (GTK_GRID (self->priv->right_grid), widget,
+                       0, 0, 1, 1);
+    }
+}
+
+GtkWidget *
+gd_main_toolbar_new (void)
+{
+  return g_object_new (GD_TYPE_MAIN_TOOLBAR, NULL);
+}
diff --git a/src/lib/gd-main-toolbar.h b/src/lib/gd-main-toolbar.h
new file mode 100644
index 0000000..6941688
--- /dev/null
+++ b/src/lib/gd-main-toolbar.h
@@ -0,0 +1,99 @@
+/*
+ * Copyright (c) 2011 Red Hat, Inc.
+ *
+ * Gnome Documents is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by the
+ * Free Software Foundation; either version 2 of the License, or (at your
+ * option) any later version.
+ *
+ * Gnome Documents is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+ * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with Gnome Documents; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ * Author: Cosimo Cecchi <cosimoc redhat com>
+ *
+ */
+
+#ifndef __GD_MAIN_TOOLBAR_H__
+#define __GD_MAIN_TOOLBAR_H__
+
+#include <glib-object.h>
+
+#include <gtk/gtk.h>
+
+G_BEGIN_DECLS
+
+#define GD_TYPE_MAIN_TOOLBAR gd_main_toolbar_get_type()
+
+#define GD_MAIN_TOOLBAR(obj) \
+  (G_TYPE_CHECK_INSTANCE_CAST ((obj), \
+   GD_TYPE_MAIN_TOOLBAR, GdMainToolbar))
+
+#define GD_MAIN_TOOLBAR_CLASS(klass) \
+  (G_TYPE_CHECK_CLASS_CAST ((klass), \
+   GD_TYPE_MAIN_TOOLBAR, GdMainToolbarClass))
+
+#define GD_IS_MAIN_TOOLBAR(obj) \
+  (G_TYPE_CHECK_INSTANCE_TYPE ((obj), \
+   GD_TYPE_MAIN_TOOLBAR))
+
+#define GD_IS_MAIN_TOOLBAR_CLASS(klass) \
+  (G_TYPE_CHECK_CLASS_TYPE ((klass), \
+   GD_TYPE_MAIN_TOOLBAR))
+
+#define GD_MAIN_TOOLBAR_GET_CLASS(obj) \
+  (G_TYPE_INSTANCE_GET_CLASS ((obj), \
+   GD_TYPE_MAIN_TOOLBAR, GdMainToolbarClass))
+
+typedef struct _GdMainToolbar GdMainToolbar;
+typedef struct _GdMainToolbarClass GdMainToolbarClass;
+typedef struct _GdMainToolbarPrivate GdMainToolbarPrivate;
+
+typedef enum {
+  GD_MAIN_TOOLBAR_MODE_INVALID,
+  GD_MAIN_TOOLBAR_MODE_OVERVIEW,
+  GD_MAIN_TOOLBAR_MODE_SELECTION,
+  GD_MAIN_TOOLBAR_MODE_PREVIEW
+} GdMainToolbarMode;
+
+typedef enum {
+  GD_MAIN_TOOLBAR_POSITION_LEFT,
+  GD_MAIN_TOOLBAR_POSITION_RIGHT
+} GdMainToolbarPosition;
+
+struct _GdMainToolbar
+{
+  GtkToolbar parent;
+
+  GdMainToolbarPrivate *priv;
+};
+
+struct _GdMainToolbarClass
+{
+  GtkToolbarClass parent_class;
+};
+
+GType gd_main_toolbar_get_type (void) G_GNUC_CONST;
+
+GtkWidget     *gd_main_toolbar_new (void);
+
+void           gd_main_toolbar_set_mode (GdMainToolbar *self,
+                                         GdMainToolbarMode mode);
+void           gd_main_toolbar_set_labels (GdMainToolbar *self,
+                                           const gchar *primary,
+                                           const gchar *detail);
+void           gd_main_toolbar_set_back_visible (GdMainToolbar *self,
+                                                 gboolean visible);
+
+void           gd_main_toolbar_add_widget (GdMainToolbar         *self,
+                                           GtkWidget             *widget,
+                                           GdMainToolbarPosition  position);
+
+G_END_DECLS
+
+#endif /* __GD_MAIN_TOOLBAR_H__ */