add a sidebar abstraction taken from emerillion
authorSjoerd Simons <sjoerd.simons@collabora.co.uk>
Tue, 3 Feb 2009 09:03:54 +0000 (09:03 +0000)
committerXavier Claessens <xclaesse@src.gnome.org>
Tue, 3 Feb 2009 09:03:54 +0000 (09:03 +0000)
Signed-off-by: Sjoerd Simons <sjoerd.simons@collabora.co.uk>
svn path=/trunk/; revision=2402

src/Makefile.am
src/empathy-sidebar.c [new file with mode: 0644]
src/empathy-sidebar.h [new file with mode: 0644]

index 864eada0c0c0e9570c346be1e5a8b37f43864efa..740357d23cd2a9955ca75ccc2deea20f94ef0b28 100644 (file)
@@ -35,6 +35,7 @@ empathy_SOURCES =                                                     \
        empathy-misc.c empathy-misc.h                                   \
        empathy-new-chatroom-dialog.c empathy-new-chatroom-dialog.h     \
        empathy-preferences.c empathy-preferences.h                     \
+       empathy-sidebar.c empathy-sidebar.h                     \
        empathy-status-icon.c empathy-status-icon.h                     \
        empathy-tube-dispatch.c empathy-tube-dispatch.h                 \
        ephy-spinner.c ephy-spinner.h
diff --git a/src/empathy-sidebar.c b/src/empathy-sidebar.c
new file mode 100644 (file)
index 0000000..a66abc7
--- /dev/null
@@ -0,0 +1,603 @@
+/*
+ * Copyright (C) 2004 Red Hat, Inc.
+ * Copyright (C) 2007 The Free Software Foundation
+ * Copyright (C) 2008 Marco Barisione <marco@barisione.org>
+ *
+ * Based on evince code (shell/ev-sidebar.c) by: 
+ *     - Jonathan Blandford <jrb@alum.mit.edu>
+ *
+ * Base on eog code (src/eog-sidebar.c) by:
+ *      - Lucas Rocha <lucasr@gnome.org>
+ *
+ * This program 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.
+ *
+ * This program 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 this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <string.h>
+#include <gtk/gtk.h>
+#include <gdk/gdkkeysyms.h>
+
+#include "empathy-sidebar.h"
+
+enum
+{
+    PROP_0,
+    PROP_CURRENT_PAGE
+};
+
+enum
+{
+    PAGE_COLUMN_TITLE,
+    PAGE_COLUMN_MENU_ITEM,
+    PAGE_COLUMN_MAIN_WIDGET,
+    PAGE_COLUMN_NOTEBOOK_INDEX,
+    PAGE_COLUMN_NUM_COLS
+};
+
+enum
+{
+    SIGNAL_PAGE_ADDED,
+    SIGNAL_PAGE_REMOVED,
+    SIGNAL_LAST
+};
+
+static gint signals[SIGNAL_LAST];
+
+struct _EmpathySidebarPrivate
+{
+    GtkWidget *notebook;
+    GtkWidget *select_button;
+    GtkWidget *menu;
+    GtkWidget *hbox;
+    GtkWidget *label;
+
+    GtkTreeModel *page_model;
+};
+
+G_DEFINE_TYPE (EmpathySidebar, empathy_sidebar, GTK_TYPE_VBOX)
+
+#define EMPATHY_SIDEBAR_GET_PRIVATE(object) \
+    (G_TYPE_INSTANCE_GET_PRIVATE ((object), EMPATHY_TYPE_SIDEBAR, EmpathySidebarPrivate))
+
+static void
+empathy_sidebar_destroy (GtkObject *object)
+{
+  EmpathySidebar *sidebar = EMPATHY_SIDEBAR (object);
+
+  if (sidebar->priv->menu)
+    {
+      gtk_menu_detach (GTK_MENU (sidebar->priv->menu));
+      sidebar->priv->menu = NULL;
+    }
+
+  if (sidebar->priv->page_model)
+    {
+      g_object_unref (sidebar->priv->page_model);
+      sidebar->priv->page_model = NULL;
+    }
+
+  (* GTK_OBJECT_CLASS (empathy_sidebar_parent_class)->destroy) (object);
+}
+
+static void
+empathy_sidebar_select_page (EmpathySidebar *sidebar,
+                                GtkTreeIter *iter)
+{
+  gchar *title;
+  gint index;
+
+  gtk_tree_model_get (sidebar->priv->page_model, iter,
+      PAGE_COLUMN_TITLE, &title, 
+      PAGE_COLUMN_NOTEBOOK_INDEX, &index,
+      -1);
+
+  gtk_notebook_set_current_page (GTK_NOTEBOOK (sidebar->priv->notebook), index);
+  gtk_label_set_text (GTK_LABEL (sidebar->priv->label), title);
+
+  g_free (title);
+}
+
+void
+empathy_sidebar_set_page (EmpathySidebar *sidebar,
+                             GtkWidget *main_widget)
+{
+  GtkTreeIter iter;
+  gboolean valid;
+
+  valid = gtk_tree_model_get_iter_first (sidebar->priv->page_model, &iter);
+
+  while (valid)
+    {
+      GtkWidget *widget;
+
+      gtk_tree_model_get (sidebar->priv->page_model, &iter,
+          PAGE_COLUMN_MAIN_WIDGET, &widget,
+          -1);
+
+      if (widget == main_widget)
+        {
+          empathy_sidebar_select_page (sidebar, &iter);
+          valid = FALSE;
+        }
+      else
+        {
+          valid = gtk_tree_model_iter_next (sidebar->priv->page_model, &iter);
+        }
+
+      g_object_unref (widget);
+  }
+
+  g_object_notify (G_OBJECT (sidebar), "current-page");
+}
+
+static GtkWidget *
+empathy_sidebar_get_current_page (EmpathySidebar *sidebar)
+{
+  GtkNotebook *notebook = GTK_NOTEBOOK (sidebar->priv->notebook);
+
+  return gtk_notebook_get_nth_page (
+    notebook, gtk_notebook_get_current_page (notebook));
+}
+
+static void
+empathy_sidebar_set_property (GObject *object,
+                                 guint prop_id,
+                                 const GValue *value,
+                                 GParamSpec *pspec)
+{
+  EmpathySidebar *sidebar = EMPATHY_SIDEBAR (object);
+
+  switch (prop_id)
+    {
+      case PROP_CURRENT_PAGE:
+        empathy_sidebar_set_page (sidebar, g_value_get_object (value));        
+        break;
+      default:
+        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+    }
+}
+
+static void
+empathy_sidebar_get_property (GObject *object,
+                                 guint prop_id,
+                                 GValue *value,
+                                 GParamSpec *pspec)
+{
+  EmpathySidebar *sidebar = EMPATHY_SIDEBAR (object);
+
+  switch (prop_id)
+    {
+      case PROP_CURRENT_PAGE:
+        g_value_set_object (value,
+            empathy_sidebar_get_current_page (sidebar));
+        break;
+      default:
+        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+    }
+}
+
+static void
+empathy_sidebar_class_init (EmpathySidebarClass *empathy_sidebar_class)
+{
+  GObjectClass *g_object_class;
+  GtkWidgetClass *widget_class;
+  GtkObjectClass *gtk_object_klass;
+
+  g_object_class = G_OBJECT_CLASS (empathy_sidebar_class);
+  widget_class = GTK_WIDGET_CLASS (empathy_sidebar_class);
+  gtk_object_klass = GTK_OBJECT_CLASS (empathy_sidebar_class);
+
+  g_type_class_add_private (g_object_class, sizeof (EmpathySidebarPrivate));
+
+  gtk_object_klass->destroy = empathy_sidebar_destroy;
+  g_object_class->get_property = empathy_sidebar_get_property;
+  g_object_class->set_property = empathy_sidebar_set_property;
+
+  g_object_class_install_property (g_object_class,
+      PROP_CURRENT_PAGE,
+      g_param_spec_object ("current-page",
+          "Current page",
+          "The currently visible page",
+          GTK_TYPE_WIDGET,
+          G_PARAM_READWRITE));
+
+  signals[SIGNAL_PAGE_ADDED] = g_signal_new ("page-added",
+      EMPATHY_TYPE_SIDEBAR, G_SIGNAL_RUN_FIRST,
+      G_STRUCT_OFFSET (EmpathySidebarClass, page_added),
+      NULL, NULL, g_cclosure_marshal_VOID__OBJECT,
+      G_TYPE_NONE, 1, GTK_TYPE_WIDGET);
+
+  signals[SIGNAL_PAGE_REMOVED] = g_signal_new ("page-removed",
+      EMPATHY_TYPE_SIDEBAR, G_SIGNAL_RUN_FIRST,
+      G_STRUCT_OFFSET (EmpathySidebarClass, page_removed),
+      NULL, NULL, g_cclosure_marshal_VOID__OBJECT,
+      G_TYPE_NONE, 1, GTK_TYPE_WIDGET);
+}
+
+static void
+empathy_sidebar_menu_position_under (GtkMenu *menu,
+                                         gint *x,
+                                         gint *y,
+                                         gboolean *push_in,
+                                         gpointer user_data)
+{
+  GtkWidget *widget;
+
+  g_return_if_fail (GTK_IS_BUTTON (user_data));
+  g_return_if_fail (GTK_WIDGET_NO_WINDOW (user_data));
+
+  widget = GTK_WIDGET (user_data);
+
+  gdk_window_get_origin (widget->window, x, y);
+
+  *x += widget->allocation.x;
+  *y += widget->allocation.y + widget->allocation.height;
+
+  *push_in = FALSE;
+}
+
+static gboolean
+empathy_sidebar_select_button_press_cb (GtkWidget *widget,
+                                           GdkEventButton *event,
+                                           gpointer user_data)
+{
+  EmpathySidebar *sidebar = EMPATHY_SIDEBAR (user_data);
+
+  if (event->button == 1)
+    {
+      GtkRequisition requisition;
+      gint width;
+
+      width = widget->allocation.width;
+
+      gtk_widget_set_size_request (sidebar->priv->menu, -1, -1);
+      gtk_widget_size_request (sidebar->priv->menu, &requisition);
+      gtk_widget_set_size_request (sidebar->priv->menu,
+          MAX (width, requisition.width), -1);
+
+      gtk_widget_grab_focus (widget);
+
+      gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (widget), TRUE);
+
+      gtk_menu_popup (GTK_MENU (sidebar->priv->menu),
+          NULL, NULL, empathy_sidebar_menu_position_under, widget,
+          event->button, event->time);
+
+      return TRUE;
+    }
+
+  return FALSE;
+}
+
+static gboolean
+empathy_sidebar_select_button_key_press_cb (GtkWidget *widget,
+                                               GdkEventKey *event,
+                                               gpointer user_data)
+{
+  EmpathySidebar *sidebar = EMPATHY_SIDEBAR (user_data);
+
+  if (event->keyval == GDK_space ||
+      event->keyval == GDK_KP_Space ||
+      event->keyval == GDK_Return ||
+      event->keyval == GDK_KP_Enter)
+    {
+      gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (widget), TRUE);
+
+      gtk_menu_popup (GTK_MENU (sidebar->priv->menu),
+          NULL, NULL, empathy_sidebar_menu_position_under, widget,
+          1, event->time);
+
+      return TRUE;
+    }
+
+  return FALSE;
+}
+
+static void
+empathy_sidebar_close_clicked_cb (GtkWidget *widget,
+                                     gpointer user_data)
+{
+  EmpathySidebar *sidebar = EMPATHY_SIDEBAR (user_data);
+
+  gtk_widget_hide (GTK_WIDGET (sidebar));
+}
+
+static void
+empathy_sidebar_menu_deactivate_cb (GtkWidget *widget,
+                                       gpointer user_data)
+{
+  GtkWidget *menu_button;
+
+  menu_button = GTK_WIDGET (user_data);
+
+  gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (menu_button), FALSE);
+}
+
+static void
+empathy_sidebar_menu_detach_cb (GtkWidget *widget,
+                                   GtkMenu *menu)
+{
+  EmpathySidebar *sidebar = EMPATHY_SIDEBAR (widget);
+
+  sidebar->priv->menu = NULL;
+}
+
+static void
+empathy_sidebar_menu_item_activate_cb (GtkWidget *widget,
+                                          gpointer user_data)
+{
+  EmpathySidebar *sidebar = EMPATHY_SIDEBAR (user_data);
+  GtkTreeIter iter;
+  GtkWidget *menu_item, *item;
+  gboolean valid;
+
+  menu_item = gtk_menu_get_active (GTK_MENU (sidebar->priv->menu));
+  valid = gtk_tree_model_get_iter_first (sidebar->priv->page_model, &iter);
+
+  while (valid)
+    {
+      gtk_tree_model_get (sidebar->priv->page_model, &iter,
+          PAGE_COLUMN_MENU_ITEM, &item,
+          -1);
+
+      if (item == menu_item)
+        {
+          empathy_sidebar_select_page (sidebar, &iter);
+          valid = FALSE;
+        }
+      else
+        {
+          valid = gtk_tree_model_iter_next (sidebar->priv->page_model, &iter);
+        }
+
+      g_object_unref (item);
+    }
+
+  g_object_notify (G_OBJECT (sidebar), "current-page");
+}
+
+static void
+empathy_sidebar_init (EmpathySidebar *sidebar)
+{
+  GtkWidget *hbox;
+  GtkWidget *close_button;
+  GtkWidget *select_hbox;
+  GtkWidget *arrow;
+  GtkWidget *image;
+
+  sidebar->priv = EMPATHY_SIDEBAR_GET_PRIVATE (sidebar);
+
+  /* data model */
+  sidebar->priv->page_model = (GtkTreeModel *) gtk_list_store_new (
+      PAGE_COLUMN_NUM_COLS,
+      G_TYPE_STRING,
+      GTK_TYPE_WIDGET,
+      GTK_TYPE_WIDGET,
+      G_TYPE_INT);
+
+  /* top option menu */
+  hbox = gtk_hbox_new (FALSE, 0);
+  sidebar->priv->hbox = hbox;
+  gtk_box_pack_start (GTK_BOX (sidebar), hbox, FALSE, FALSE, 0);
+  gtk_widget_show (hbox);
+
+  sidebar->priv->select_button = gtk_toggle_button_new ();
+  gtk_button_set_relief (GTK_BUTTON (sidebar->priv->select_button), 
+      GTK_RELIEF_NONE);
+
+  g_signal_connect (sidebar->priv->select_button, "button_press_event",
+      G_CALLBACK (empathy_sidebar_select_button_press_cb),
+      sidebar);
+
+  g_signal_connect (sidebar->priv->select_button, "key_press_event",
+      G_CALLBACK (empathy_sidebar_select_button_key_press_cb),
+      sidebar);
+
+  select_hbox = gtk_hbox_new (FALSE, 0);
+
+  sidebar->priv->label = gtk_label_new ("");
+
+  gtk_box_pack_start (GTK_BOX (select_hbox),
+      sidebar->priv->label,
+      FALSE, FALSE, 0);
+
+  gtk_widget_show (sidebar->priv->label);
+
+  arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
+  gtk_box_pack_end (GTK_BOX (select_hbox), arrow, FALSE, FALSE, 0);
+  gtk_widget_show (arrow);
+
+  gtk_container_add (GTK_CONTAINER (sidebar->priv->select_button), select_hbox);
+  gtk_widget_show (select_hbox);
+
+  gtk_box_pack_start (GTK_BOX (hbox), sidebar->priv->select_button, TRUE, TRUE, 0);
+  gtk_widget_show (sidebar->priv->select_button);
+
+  close_button = gtk_button_new ();
+
+  gtk_button_set_relief (GTK_BUTTON (close_button), GTK_RELIEF_NONE);
+
+  g_signal_connect (close_button, "clicked",
+      G_CALLBACK (empathy_sidebar_close_clicked_cb),
+      sidebar);
+
+  image = gtk_image_new_from_stock (GTK_STOCK_CLOSE,
+      GTK_ICON_SIZE_MENU);
+  gtk_container_add (GTK_CONTAINER (close_button), image);
+  gtk_widget_show (image);
+
+  gtk_box_pack_end (GTK_BOX (hbox), close_button, FALSE, FALSE, 0);
+  gtk_widget_show (close_button);
+
+  sidebar->priv->menu = gtk_menu_new ();
+
+  g_signal_connect (sidebar->priv->menu, "deactivate",
+      G_CALLBACK (empathy_sidebar_menu_deactivate_cb),
+      sidebar->priv->select_button);
+
+  gtk_menu_attach_to_widget (GTK_MENU (sidebar->priv->menu),
+      GTK_WIDGET (sidebar),
+      empathy_sidebar_menu_detach_cb);
+
+  gtk_widget_show (sidebar->priv->menu);
+
+  sidebar->priv->notebook = gtk_notebook_new ();
+
+  gtk_notebook_set_show_border (GTK_NOTEBOOK (sidebar->priv->notebook), FALSE);
+  gtk_notebook_set_show_tabs (GTK_NOTEBOOK (sidebar->priv->notebook), FALSE);
+
+  gtk_box_pack_start (GTK_BOX (sidebar), sidebar->priv->notebook,
+      TRUE, TRUE, 0);
+
+  gtk_widget_show (sidebar->priv->notebook);
+}
+
+GtkWidget *
+empathy_sidebar_new (void)
+{
+  GtkWidget *sidebar;
+
+  sidebar = g_object_new (EMPATHY_TYPE_SIDEBAR, NULL);
+
+  return sidebar;
+}
+
+void
+empathy_sidebar_add_page (EmpathySidebar *sidebar,
+                             const gchar *title,
+                             GtkWidget *main_widget)
+{
+  GtkTreeIter iter;
+  GtkWidget *menu_item;
+  gchar *label_title;
+  gint index;
+
+  g_return_if_fail (EMPATHY_IS_SIDEBAR (sidebar));
+  g_return_if_fail (GTK_IS_WIDGET (main_widget));
+
+  index = gtk_notebook_append_page (GTK_NOTEBOOK (sidebar->priv->notebook),
+      main_widget, NULL);
+
+  menu_item = gtk_image_menu_item_new_with_label (title);
+
+  g_signal_connect (menu_item, "activate",
+      G_CALLBACK (empathy_sidebar_menu_item_activate_cb),
+      sidebar);
+
+  gtk_widget_show (menu_item);
+
+  gtk_menu_shell_append (GTK_MENU_SHELL (sidebar->priv->menu),
+      menu_item);
+
+  /* Insert and move to end */
+  gtk_list_store_insert_with_values (GTK_LIST_STORE (sidebar->priv->page_model),
+      &iter, 0,
+      PAGE_COLUMN_TITLE, title,
+      PAGE_COLUMN_MENU_ITEM, menu_item,
+      PAGE_COLUMN_MAIN_WIDGET, main_widget,
+      PAGE_COLUMN_NOTEBOOK_INDEX, index,
+      -1);
+
+  gtk_list_store_move_before (GTK_LIST_STORE(sidebar->priv->page_model),
+      &iter, 
+      NULL);
+
+  /* Set the first item added as active */
+  gtk_tree_model_get_iter_first (sidebar->priv->page_model, &iter);
+  gtk_tree_model_get (sidebar->priv->page_model,
+      &iter,
+      PAGE_COLUMN_TITLE, &label_title,
+      PAGE_COLUMN_NOTEBOOK_INDEX, &index,
+      -1);
+
+  gtk_menu_set_active (GTK_MENU (sidebar->priv->menu), index);
+
+  gtk_label_set_text (GTK_LABEL (sidebar->priv->label), label_title);
+
+  gtk_notebook_set_current_page (GTK_NOTEBOOK (sidebar->priv->notebook),
+      index);
+
+  g_free (label_title);
+
+  g_signal_emit (G_OBJECT (sidebar), signals[SIGNAL_PAGE_ADDED],
+      0, main_widget);
+}
+
+void
+empathy_sidebar_remove_page (EmpathySidebar *sidebar,
+                                GtkWidget *main_widget)
+{
+  GtkTreeIter iter;
+  GtkWidget *widget, *menu_item;
+  gboolean valid;
+  gint index;
+
+  g_return_if_fail (EMPATHY_IS_SIDEBAR (sidebar));
+  g_return_if_fail (GTK_IS_WIDGET (main_widget));
+
+  valid = gtk_tree_model_get_iter_first (sidebar->priv->page_model, &iter);
+
+  while (valid)
+    {
+      gtk_tree_model_get (sidebar->priv->page_model, &iter,
+          PAGE_COLUMN_NOTEBOOK_INDEX, &index,
+          PAGE_COLUMN_MENU_ITEM, &menu_item,
+          PAGE_COLUMN_MAIN_WIDGET, &widget,
+          -1);
+
+      if (widget == main_widget)
+          break;
+      else
+          valid = gtk_tree_model_iter_next (sidebar->priv->page_model, &iter);
+
+      g_object_unref (menu_item);
+      g_object_unref (widget);
+    }
+
+  if (valid)
+    {
+      gtk_notebook_remove_page (GTK_NOTEBOOK (sidebar->priv->notebook), 
+          index);
+
+      gtk_container_remove (GTK_CONTAINER (sidebar->priv->menu), menu_item);
+
+      gtk_list_store_remove (GTK_LIST_STORE (sidebar->priv->page_model), 
+          &iter);
+
+      g_signal_emit (G_OBJECT (sidebar), 
+          signals[SIGNAL_PAGE_REMOVED], 0, main_widget);
+    }
+}
+
+gint
+empathy_sidebar_get_n_pages (EmpathySidebar *sidebar)
+{
+  g_return_val_if_fail (EMPATHY_IS_SIDEBAR (sidebar), TRUE);
+
+  return gtk_tree_model_iter_n_children (
+      GTK_TREE_MODEL (sidebar->priv->page_model), NULL);
+}
+
+gboolean
+empathy_sidebar_is_empty (EmpathySidebar *sidebar)
+{
+  g_return_val_if_fail (EMPATHY_IS_SIDEBAR (sidebar), TRUE);
+
+  return gtk_tree_model_iter_n_children (
+      GTK_TREE_MODEL (sidebar->priv->page_model), NULL) == 0;
+}
diff --git a/src/empathy-sidebar.h b/src/empathy-sidebar.h
new file mode 100644 (file)
index 0000000..6e88e78
--- /dev/null
@@ -0,0 +1,85 @@
+/*
+ * Copyright (C) 2004 Red Hat, Inc.
+ * Copyright (C) 2007 The Free Software Foundation
+ * Copyright (C) 2008 Marco Barisione <marco@barisione.org>
+ *
+ * Based on evince code (shell/ev-sidebar.h) by: 
+ *     - Jonathan Blandford <jrb@alum.mit.edu>
+ *
+ * Base on eog code (src/eog-sidebar.c) by:
+ *      - Lucas Rocha <lucasr@gnome.org>
+ *
+ * This program 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.
+ *
+ * This program 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 this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+#ifndef __EMPATHY_SIDEBAR_H__
+#define __EMPATHY_SIDEBAR_H__
+
+#include <gtk/gtk.h>
+
+G_BEGIN_DECLS
+
+typedef struct _EmpathySidebar EmpathySidebar;
+typedef struct _EmpathySidebarClass EmpathySidebarClass;
+typedef struct _EmpathySidebarPrivate EmpathySidebarPrivate;
+
+#define EMPATHY_TYPE_SIDEBAR            (empathy_sidebar_get_type())
+#define EMPATHY_SIDEBAR(obj)            (G_TYPE_CHECK_INSTANCE_CAST((obj), EMPATHY_TYPE_SIDEBAR, EmpathySidebar))
+#define EMPATHY_SIDEBAR_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST((klass),  EMPATHY_TYPE_SIDEBAR, EmpathySidebarClass))
+#define EMPATHY_IS_SIDEBAR(obj)         (G_TYPE_CHECK_INSTANCE_TYPE((obj), EMPATHY_TYPE_SIDEBAR))
+#define EMPATHY_IS_SIDEBAR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),  EMPATHY_TYPE_SIDEBAR))
+#define EMPATHY_SIDEBAR_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS((obj),  EMPATHY_TYPE_SIDEBAR, EmpathySidebarClass))
+
+struct _EmpathySidebar
+{
+  GtkVBox base_instance;
+
+  EmpathySidebarPrivate *priv;
+};
+
+struct _EmpathySidebarClass
+{
+  GtkVBoxClass base_class;
+
+  void (* page_added)   (EmpathySidebar *sidebar, 
+                         GtkWidget *main_widget);
+
+  void (* page_removed) (EmpathySidebar *sidebar, 
+                         GtkWidget *main_widget);
+};
+
+GType      empathy_sidebar_get_type     (void);
+
+GtkWidget *empathy_sidebar_new          (void);
+
+void       empathy_sidebar_add_page     (EmpathySidebar *sidebar,
+                                            const gchar *title,
+                                            GtkWidget *main_widget);
+
+void       empathy_sidebar_remove_page  (EmpathySidebar *sidebar,
+                                            GtkWidget *main_widget);
+
+void       empathy_sidebar_set_page     (EmpathySidebar *sidebar,
+                                            GtkWidget *main_widget);
+
+gint       empathy_sidebar_get_n_pages  (EmpathySidebar *sidebar);
+
+gboolean   empathy_sidebar_is_empty     (EmpathySidebar *sidebar);
+
+G_END_DECLS
+
+#endif /* __EMPATHY_SIDEBAR_H__ */
+
+