summaryrefslogtreecommitdiff
path: root/pluma/pluma-panel.c
diff options
context:
space:
mode:
Diffstat (limited to 'pluma/pluma-panel.c')
-rwxr-xr-xpluma/pluma-panel.c950
1 files changed, 950 insertions, 0 deletions
diff --git a/pluma/pluma-panel.c b/pluma/pluma-panel.c
new file mode 100755
index 00000000..1e02f6ca
--- /dev/null
+++ b/pluma/pluma-panel.c
@@ -0,0 +1,950 @@
+/*
+ * pluma-panel.c
+ * This file is part of pluma
+ *
+ * Copyright (C) 2005 - Paolo Maggi
+ *
+ * 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.
+ */
+
+/*
+ * Modified by the pluma Team, 2005. See the AUTHORS file for a
+ * list of people on the pluma Team.
+ * See the ChangeLog files for a list of changes.
+ *
+ * $Id$
+ */
+
+#include "pluma-panel.h"
+
+#include <glib/gi18n.h>
+#include <gtk/gtk.h>
+#include <gdk/gdk.h>
+#include <gdk/gdkkeysyms.h>
+
+#include "pluma-close-button.h"
+#include "pluma-window.h"
+#include "pluma-debug.h"
+
+#define PANEL_ITEM_KEY "PlumaPanelItemKey"
+
+#define PLUMA_PANEL_GET_PRIVATE(object)(G_TYPE_INSTANCE_GET_PRIVATE ((object), PLUMA_TYPE_PANEL, PlumaPanelPrivate))
+
+struct _PlumaPanelPrivate
+{
+ GtkOrientation orientation;
+
+ /* Title bar (vertical panel only) */
+ GtkWidget *title_image;
+ GtkWidget *title_label;
+
+ /* Notebook */
+ GtkWidget *notebook;
+};
+
+typedef struct _PlumaPanelItem PlumaPanelItem;
+
+struct _PlumaPanelItem
+{
+ gchar *name;
+ GtkWidget *icon;
+};
+
+/* Properties */
+enum {
+ PROP_0,
+ PROP_ORIENTATION
+};
+
+/* Signals */
+enum {
+ ITEM_ADDED,
+ ITEM_REMOVED,
+ CLOSE,
+ FOCUS_DOCUMENT,
+ LAST_SIGNAL
+};
+
+static guint signals[LAST_SIGNAL];
+
+static GObject *pluma_panel_constructor (GType type,
+ guint n_construct_properties,
+ GObjectConstructParam *construct_properties);
+
+
+G_DEFINE_TYPE(PlumaPanel, pluma_panel, GTK_TYPE_VBOX)
+
+static void
+pluma_panel_finalize (GObject *obj)
+{
+ if (G_OBJECT_CLASS (pluma_panel_parent_class)->finalize)
+ (*G_OBJECT_CLASS (pluma_panel_parent_class)->finalize) (obj);
+}
+
+static void
+pluma_panel_get_property (GObject *object,
+ guint prop_id,
+ GValue *value,
+ GParamSpec *pspec)
+{
+ PlumaPanel *panel = PLUMA_PANEL (object);
+
+ switch (prop_id)
+ {
+ case PROP_ORIENTATION:
+ g_value_set_enum(value, panel->priv->orientation);
+ break;
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ break;
+ }
+}
+
+static void
+pluma_panel_set_property (GObject *object,
+ guint prop_id,
+ const GValue *value,
+ GParamSpec *pspec)
+{
+ PlumaPanel *panel = PLUMA_PANEL (object);
+
+ switch (prop_id)
+ {
+ case PROP_ORIENTATION:
+ panel->priv->orientation = g_value_get_enum (value);
+ break;
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ break;
+ }
+}
+
+static void
+pluma_panel_close (PlumaPanel *panel)
+{
+ gtk_widget_hide (GTK_WIDGET (panel));
+}
+
+static void
+pluma_panel_focus_document (PlumaPanel *panel)
+{
+ GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (panel));
+#if !GTK_CHECK_VERSION (2, 18, 0)
+ if (GTK_WIDGET_TOPLEVEL (toplevel) && PLUMA_IS_WINDOW (toplevel))
+#else
+ if (gtk_widget_is_toplevel (toplevel) && PLUMA_IS_WINDOW (toplevel))
+#endif
+ {
+ PlumaView *view;
+
+ view = pluma_window_get_active_view (PLUMA_WINDOW (toplevel));
+ if (view != NULL)
+ gtk_widget_grab_focus (GTK_WIDGET (view));
+ }
+}
+
+static void
+pluma_panel_grab_focus (GtkWidget *w)
+{
+ gint n;
+ GtkWidget *tab;
+ PlumaPanel *panel = PLUMA_PANEL (w);
+
+ n = gtk_notebook_get_current_page (GTK_NOTEBOOK (panel->priv->notebook));
+ if (n == -1)
+ return;
+
+ tab = gtk_notebook_get_nth_page (GTK_NOTEBOOK (panel->priv->notebook),
+ n);
+ g_return_if_fail (tab != NULL);
+
+ gtk_widget_grab_focus (tab);
+}
+
+static void
+pluma_panel_class_init (PlumaPanelClass *klass)
+{
+ GtkBindingSet *binding_set;
+ GObjectClass *object_class = G_OBJECT_CLASS (klass);
+ GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
+
+ g_type_class_add_private (klass, sizeof (PlumaPanelPrivate));
+
+ object_class->constructor = pluma_panel_constructor;
+ object_class->finalize = pluma_panel_finalize;
+ object_class->get_property = pluma_panel_get_property;
+ object_class->set_property = pluma_panel_set_property;
+
+ g_object_class_install_property (object_class,
+ PROP_ORIENTATION,
+ g_param_spec_enum ("orientation",
+ "Orientation",
+ "The panel's orientation",
+ GTK_TYPE_ORIENTATION,
+ GTK_ORIENTATION_VERTICAL,
+ G_PARAM_WRITABLE |
+ G_PARAM_READABLE |
+ G_PARAM_CONSTRUCT_ONLY |
+ G_PARAM_STATIC_STRINGS));
+
+ widget_class->grab_focus = pluma_panel_grab_focus;
+
+ klass->close = pluma_panel_close;
+ klass->focus_document = pluma_panel_focus_document;
+
+ signals[ITEM_ADDED] =
+ g_signal_new ("item_added",
+ G_OBJECT_CLASS_TYPE (klass),
+ G_SIGNAL_RUN_FIRST,
+ G_STRUCT_OFFSET (PlumaPanelClass, item_added),
+ NULL, NULL,
+ g_cclosure_marshal_VOID__OBJECT,
+ G_TYPE_NONE,
+ 1,
+ GTK_TYPE_WIDGET);
+ signals[ITEM_REMOVED] =
+ g_signal_new ("item_removed",
+ G_OBJECT_CLASS_TYPE (klass),
+ G_SIGNAL_RUN_FIRST,
+ G_STRUCT_OFFSET (PlumaPanelClass, item_removed),
+ NULL, NULL,
+ g_cclosure_marshal_VOID__OBJECT,
+ G_TYPE_NONE,
+ 1,
+ GTK_TYPE_WIDGET);
+
+ /* Keybinding signals */
+ signals[CLOSE] =
+ g_signal_new ("close",
+ G_OBJECT_CLASS_TYPE (klass),
+ G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
+ G_STRUCT_OFFSET (PlumaPanelClass, close),
+ NULL, NULL,
+ g_cclosure_marshal_VOID__VOID,
+ G_TYPE_NONE, 0);
+ signals[FOCUS_DOCUMENT] =
+ g_signal_new ("focus_document",
+ G_OBJECT_CLASS_TYPE (klass),
+ G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
+ G_STRUCT_OFFSET (PlumaPanelClass, focus_document),
+ NULL, NULL,
+ g_cclosure_marshal_VOID__VOID,
+ G_TYPE_NONE, 0);
+ binding_set = gtk_binding_set_by_class (klass);
+
+ gtk_binding_entry_add_signal (binding_set,
+ GDK_Escape,
+ 0,
+ "close",
+ 0);
+ gtk_binding_entry_add_signal (binding_set,
+ GDK_Return,
+ GDK_CONTROL_MASK,
+ "focus_document",
+ 0);
+}
+
+/* This is ugly, since it supports only known
+ * storage types of GtkImage, otherwise fall back
+ * to the empty icon.
+ * See http://bugzilla.gnome.org/show_bug.cgi?id=317520.
+ */
+static void
+set_gtk_image_from_gtk_image (GtkImage *image,
+ GtkImage *source)
+{
+ switch (gtk_image_get_storage_type (source))
+ {
+ case GTK_IMAGE_EMPTY:
+ gtk_image_clear (image);
+ break;
+ case GTK_IMAGE_PIXMAP:
+ {
+ GdkPixmap *pm;
+ GdkBitmap *bm;
+
+ gtk_image_get_pixmap (source, &pm, &bm);
+ gtk_image_set_from_pixmap (image, pm, bm);
+ }
+ break;
+ case GTK_IMAGE_IMAGE:
+ {
+ GdkImage *i;
+ GdkBitmap *bm;
+
+ gtk_image_get_image (source, &i, &bm);
+ gtk_image_set_from_image (image, i, bm);
+ }
+ break;
+ case GTK_IMAGE_PIXBUF:
+ {
+ GdkPixbuf *pb;
+
+ pb = gtk_image_get_pixbuf (source);
+ gtk_image_set_from_pixbuf (image, pb);
+ }
+ break;
+ case GTK_IMAGE_STOCK:
+ {
+ gchar *s_id;
+ GtkIconSize s;
+
+ gtk_image_get_stock (source, &s_id, &s);
+ gtk_image_set_from_stock (image, s_id, s);
+ }
+ break;
+ case GTK_IMAGE_ICON_SET:
+ {
+ GtkIconSet *is;
+ GtkIconSize s;
+
+ gtk_image_get_icon_set (source, &is, &s);
+ gtk_image_set_from_icon_set (image, is, s);
+ }
+ break;
+ case GTK_IMAGE_ANIMATION:
+ {
+ GdkPixbufAnimation *a;
+
+ a = gtk_image_get_animation (source);
+ gtk_image_set_from_animation (image, a);
+ }
+ break;
+ case GTK_IMAGE_ICON_NAME:
+ {
+ const gchar *n;
+ GtkIconSize s;
+
+ gtk_image_get_icon_name (source, &n, &s);
+ gtk_image_set_from_icon_name (image, n, s);
+ }
+ break;
+ default:
+ gtk_image_set_from_stock (image,
+ GTK_STOCK_FILE,
+ GTK_ICON_SIZE_MENU);
+ }
+}
+
+static void
+sync_title (PlumaPanel *panel,
+ PlumaPanelItem *item)
+{
+ if (panel->priv->orientation != GTK_ORIENTATION_VERTICAL)
+ return;
+
+ if (item != NULL)
+ {
+ gtk_label_set_text (GTK_LABEL (panel->priv->title_label),
+ item->name);
+
+ set_gtk_image_from_gtk_image (GTK_IMAGE (panel->priv->title_image),
+ GTK_IMAGE (item->icon));
+ }
+ else
+ {
+ gtk_label_set_text (GTK_LABEL (panel->priv->title_label),
+ _("Empty"));
+
+ gtk_image_set_from_stock (GTK_IMAGE (panel->priv->title_image),
+ GTK_STOCK_FILE,
+ GTK_ICON_SIZE_MENU);
+ }
+}
+
+static void
+notebook_page_changed (GtkNotebook *notebook,
+ GtkNotebookPage *page,
+ guint page_num,
+ PlumaPanel *panel)
+{
+ GtkWidget *item;
+ PlumaPanelItem *data;
+
+ item = gtk_notebook_get_nth_page (notebook, page_num);
+ g_return_if_fail (item != NULL);
+
+ data = (PlumaPanelItem *)g_object_get_data (G_OBJECT (item),
+ PANEL_ITEM_KEY);
+ g_return_if_fail (data != NULL);
+
+ sync_title (panel, data);
+}
+
+static void
+panel_show (PlumaPanel *panel,
+ gpointer user_data)
+{
+ gint page;
+ GtkNotebook *nb;
+
+ nb = GTK_NOTEBOOK (panel->priv->notebook);
+
+ page = gtk_notebook_get_current_page (nb);
+
+ if (page != -1)
+ notebook_page_changed (nb, NULL, page, panel);
+}
+
+static void
+pluma_panel_init (PlumaPanel *panel)
+{
+ panel->priv = PLUMA_PANEL_GET_PRIVATE (panel);
+}
+
+static void
+close_button_clicked_cb (GtkWidget *widget,
+ GtkWidget *panel)
+{
+ gtk_widget_hide (panel);
+}
+
+static GtkWidget *
+create_close_button (PlumaPanel *panel)
+{
+ GtkWidget *button;
+
+ button = pluma_close_button_new ();
+
+ gtk_widget_set_tooltip_text (button, _("Hide panel"));
+
+ g_signal_connect (button,
+ "clicked",
+ G_CALLBACK (close_button_clicked_cb),
+ panel);
+
+ return button;
+}
+
+static void
+build_notebook_for_panel (PlumaPanel *panel)
+{
+ /* Create the panel notebook */
+ panel->priv->notebook = gtk_notebook_new ();
+
+ gtk_notebook_set_tab_pos (GTK_NOTEBOOK (panel->priv->notebook),
+ GTK_POS_BOTTOM);
+ gtk_notebook_set_scrollable (GTK_NOTEBOOK (panel->priv->notebook),
+ TRUE);
+ gtk_notebook_popup_enable (GTK_NOTEBOOK (panel->priv->notebook));
+
+ gtk_widget_show (GTK_WIDGET (panel->priv->notebook));
+
+ g_signal_connect (panel->priv->notebook,
+ "switch-page",
+ G_CALLBACK (notebook_page_changed),
+ panel);
+}
+
+static void
+build_horizontal_panel (PlumaPanel *panel)
+{
+ GtkWidget *box;
+ GtkWidget *sidebar;
+ GtkWidget *close_button;
+
+ box = gtk_hbox_new(FALSE, 0);
+
+ gtk_box_pack_start (GTK_BOX (box),
+ panel->priv->notebook,
+ TRUE,
+ TRUE,
+ 0);
+
+ /* Toolbar, close button and first separator */
+ sidebar = gtk_vbox_new(FALSE, 6);
+ gtk_container_set_border_width (GTK_CONTAINER (sidebar), 4);
+
+ gtk_box_pack_start (GTK_BOX (box),
+ sidebar,
+ FALSE,
+ FALSE,
+ 0);
+
+ close_button = create_close_button (panel);
+
+ gtk_box_pack_start (GTK_BOX (sidebar),
+ close_button,
+ FALSE,
+ FALSE,
+ 0);
+
+ gtk_widget_show_all (box);
+
+ gtk_box_pack_start (GTK_BOX (panel),
+ box,
+ TRUE,
+ TRUE,
+ 0);
+}
+
+static void
+build_vertical_panel (PlumaPanel *panel)
+{
+ GtkWidget *close_button;
+ GtkWidget *title_hbox;
+ GtkWidget *icon_name_hbox;
+ GtkWidget *dummy_label;
+
+ /* Create title hbox */
+ title_hbox = gtk_hbox_new (FALSE, 6);
+ gtk_container_set_border_width (GTK_CONTAINER (title_hbox), 5);
+
+ gtk_box_pack_start (GTK_BOX (panel), title_hbox, FALSE, FALSE, 0);
+
+ icon_name_hbox = gtk_hbox_new (FALSE, 0);
+ gtk_box_pack_start (GTK_BOX (title_hbox),
+ icon_name_hbox,
+ TRUE,
+ TRUE,
+ 0);
+
+ panel->priv->title_image =
+ gtk_image_new_from_stock (GTK_STOCK_FILE,
+ GTK_ICON_SIZE_MENU);
+ gtk_box_pack_start (GTK_BOX (icon_name_hbox),
+ panel->priv->title_image,
+ FALSE,
+ TRUE,
+ 0);
+
+ dummy_label = gtk_label_new (" ");
+
+ gtk_box_pack_start (GTK_BOX (icon_name_hbox),
+ dummy_label,
+ FALSE,
+ FALSE,
+ 0);
+
+ panel->priv->title_label = gtk_label_new (_("Empty"));
+ gtk_misc_set_alignment (GTK_MISC (panel->priv->title_label), 0, 0.5);
+ gtk_label_set_ellipsize(GTK_LABEL (panel->priv->title_label), PANGO_ELLIPSIZE_END);
+
+ gtk_box_pack_start (GTK_BOX (icon_name_hbox),
+ panel->priv->title_label,
+ TRUE,
+ TRUE,
+ 0);
+
+ close_button = create_close_button (panel);
+
+ gtk_box_pack_start (GTK_BOX (title_hbox),
+ close_button,
+ FALSE,
+ FALSE,
+ 0);
+
+ gtk_widget_show_all (title_hbox);
+
+ gtk_box_pack_start (GTK_BOX (panel),
+ panel->priv->notebook,
+ TRUE,
+ TRUE,
+ 0);
+}
+
+static GObject *
+pluma_panel_constructor (GType type,
+ guint n_construct_properties,
+ GObjectConstructParam *construct_properties)
+{
+
+ /* Invoke parent constructor. */
+ PlumaPanelClass *klass = PLUMA_PANEL_CLASS (g_type_class_peek (PLUMA_TYPE_PANEL));
+ GObjectClass *parent_class = G_OBJECT_CLASS (g_type_class_peek_parent (klass));
+ GObject *obj = parent_class->constructor (type,
+ n_construct_properties,
+ construct_properties);
+
+ /* Build the panel, now that we know the orientation
+ (_init has been called previously) */
+ PlumaPanel *panel = PLUMA_PANEL (obj);
+
+ build_notebook_for_panel (panel);
+ if (panel->priv->orientation == GTK_ORIENTATION_HORIZONTAL)
+ build_horizontal_panel (panel);
+ else
+ build_vertical_panel (panel);
+
+ g_signal_connect (panel,
+ "show",
+ G_CALLBACK (panel_show),
+ NULL);
+
+ return obj;
+}
+
+/**
+ * pluma_panel_new:
+ * @orientation: a #GtkOrientation
+ *
+ * Creates a new #PlumaPanel with the given @orientation. You shouldn't create
+ * a new panel use pluma_window_get_side_panel() or pluma_window_get_bottom_panel()
+ * instead.
+ *
+ * Returns: a new #PlumaPanel object.
+ */
+GtkWidget *
+pluma_panel_new (GtkOrientation orientation)
+{
+ return GTK_WIDGET (g_object_new (PLUMA_TYPE_PANEL, "orientation", orientation, NULL));
+}
+
+static GtkWidget *
+build_tab_label (PlumaPanel *panel,
+ GtkWidget *item,
+ const gchar *name,
+ GtkWidget *icon)
+{
+ GtkWidget *hbox, *label_hbox, *label_ebox;
+ GtkWidget *label;
+
+ /* set hbox spacing and label padding (see below) so that there's an
+ * equal amount of space around the label */
+ hbox = gtk_hbox_new (FALSE, 4);
+
+ label_ebox = gtk_event_box_new ();
+ gtk_event_box_set_visible_window (GTK_EVENT_BOX (label_ebox), FALSE);
+ gtk_box_pack_start (GTK_BOX (hbox), label_ebox, TRUE, TRUE, 0);
+
+ label_hbox = gtk_hbox_new (FALSE, 4);
+ gtk_container_add (GTK_CONTAINER (label_ebox), label_hbox);
+
+ /* setup icon */
+ gtk_box_pack_start (GTK_BOX (label_hbox), icon, FALSE, FALSE, 0);
+
+ /* setup label */
+ label = gtk_label_new (name);
+ gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.5);
+ gtk_misc_set_padding (GTK_MISC (label), 0, 0);
+ gtk_box_pack_start (GTK_BOX (label_hbox), label, TRUE, TRUE, 0);
+
+ gtk_widget_set_tooltip_text (label_ebox, name);
+
+ gtk_widget_show_all (hbox);
+
+ if (panel->priv->orientation == GTK_ORIENTATION_VERTICAL)
+ gtk_widget_hide(label);
+
+ g_object_set_data (G_OBJECT (item), "label", label);
+ g_object_set_data (G_OBJECT (item), "hbox", hbox);
+
+ return hbox;
+}
+
+/**
+ * pluma_panel_add_item:
+ * @panel: a #PlumaPanel
+ * @item: the #GtkWidget to add to the @panel
+ * @name: the name to be shown in the @panel
+ * @image: the image to be shown in the @panel
+ *
+ * Adds a new item to the @panel.
+ */
+void
+pluma_panel_add_item (PlumaPanel *panel,
+ GtkWidget *item,
+ const gchar *name,
+ GtkWidget *image)
+{
+ PlumaPanelItem *data;
+ GtkWidget *tab_label;
+ GtkWidget *menu_label;
+ gint w, h;
+
+ g_return_if_fail (PLUMA_IS_PANEL (panel));
+ g_return_if_fail (GTK_IS_WIDGET (item));
+ g_return_if_fail (name != NULL);
+ g_return_if_fail (image == NULL || GTK_IS_IMAGE (image));
+
+ data = g_new (PlumaPanelItem, 1);
+
+ data->name = g_strdup (name);
+
+ if (image == NULL)
+ {
+ /* default to empty */
+ data->icon = gtk_image_new_from_stock (GTK_STOCK_FILE,
+ GTK_ICON_SIZE_MENU);
+ }
+ else
+ {
+ data->icon = image;
+ }
+
+ gtk_icon_size_lookup (GTK_ICON_SIZE_MENU, &w, &h);
+ gtk_widget_set_size_request (data->icon, w, h);
+
+ g_object_set_data (G_OBJECT (item),
+ PANEL_ITEM_KEY,
+ data);
+
+ tab_label = build_tab_label (panel, item, data->name, data->icon);
+
+ menu_label = gtk_label_new (name);
+ gtk_misc_set_alignment (GTK_MISC (menu_label), 0.0, 0.5);
+
+ if (!GTK_WIDGET_VISIBLE (item))
+ gtk_widget_show (item);
+
+ gtk_notebook_append_page_menu (GTK_NOTEBOOK (panel->priv->notebook),
+ item,
+ tab_label,
+ menu_label);
+
+ g_signal_emit (G_OBJECT (panel), signals[ITEM_ADDED], 0, item);
+}
+
+/**
+ * pluma_panel_add_item_with_stock_icon:
+ * @panel: a #PlumaPanel
+ * @item: the #GtkWidget to add to the @panel
+ * @name: the name to be shown in the @panel
+ * @stock_id: a stock id
+ *
+ * Same as pluma_panel_add_item() but using an image from stock.
+ */
+void
+pluma_panel_add_item_with_stock_icon (PlumaPanel *panel,
+ GtkWidget *item,
+ const gchar *name,
+ const gchar *stock_id)
+{
+ GtkWidget *icon = NULL;
+
+ if (stock_id != NULL)
+ {
+ icon = gtk_image_new_from_stock (stock_id,
+ GTK_ICON_SIZE_MENU);
+ }
+
+ pluma_panel_add_item (panel, item, name, icon);
+}
+
+/**
+ * pluma_panel_remove_item:
+ * @panel: a #PlumaPanel
+ * @item: the item to be removed from the panel
+ *
+ * Removes the widget @item from the panel if it is in the @panel and returns
+ * TRUE if there was not any problem.
+ *
+ * Returns: TRUE if it was well removed.
+ */
+gboolean
+pluma_panel_remove_item (PlumaPanel *panel,
+ GtkWidget *item)
+{
+ PlumaPanelItem *data;
+ gint page_num;
+
+ g_return_val_if_fail (PLUMA_IS_PANEL (panel), FALSE);
+ g_return_val_if_fail (GTK_IS_WIDGET (item), FALSE);
+
+ page_num = gtk_notebook_page_num (GTK_NOTEBOOK (panel->priv->notebook),
+ item);
+
+ if (page_num == -1)
+ return FALSE;
+
+ data = (PlumaPanelItem *)g_object_get_data (G_OBJECT (item),
+ PANEL_ITEM_KEY);
+ g_return_val_if_fail (data != NULL, FALSE);
+
+ g_free (data->name);
+ g_free (data);
+
+ g_object_set_data (G_OBJECT (item),
+ PANEL_ITEM_KEY,
+ NULL);
+
+ /* ref the item to keep it alive during signal emission */
+ g_object_ref (G_OBJECT (item));
+
+ gtk_notebook_remove_page (GTK_NOTEBOOK (panel->priv->notebook),
+ page_num);
+
+ /* if we removed all the pages, reset the title */
+ if (gtk_notebook_get_n_pages (GTK_NOTEBOOK (panel->priv->notebook)) == 0)
+ sync_title (panel, NULL);
+
+ g_signal_emit (G_OBJECT (panel), signals[ITEM_REMOVED], 0, item);
+
+ g_object_unref (G_OBJECT (item));
+
+ return TRUE;
+}
+
+/**
+ * pluma_panel_activate_item:
+ * @panel: a #PlumaPanel
+ * @item: the item to be activated
+ *
+ * Switches to the page that contains @item.
+ *
+ * Returns: TRUE if it was activated
+ */
+gboolean
+pluma_panel_activate_item (PlumaPanel *panel,
+ GtkWidget *item)
+{
+ gint page_num;
+
+ g_return_val_if_fail (PLUMA_IS_PANEL (panel), FALSE);
+ g_return_val_if_fail (GTK_IS_WIDGET (item), FALSE);
+
+ page_num = gtk_notebook_page_num (GTK_NOTEBOOK (panel->priv->notebook),
+ item);
+
+ if (page_num == -1)
+ return FALSE;
+
+ gtk_notebook_set_current_page (GTK_NOTEBOOK (panel->priv->notebook),
+ page_num);
+
+ return TRUE;
+}
+
+/**
+ * pluma_panel_item_is_active:
+ * @panel: a #PlumaPanel
+ * @item: a widget contained in #PlumaPanel
+ *
+ * Wheter @item is the one current active in @panel
+ *
+ * Returns: TRUE if the widget is active
+ */
+gboolean
+pluma_panel_item_is_active (PlumaPanel *panel,
+ GtkWidget *item)
+{
+ gint cur_page;
+ gint page_num;
+
+ g_return_val_if_fail (PLUMA_IS_PANEL (panel), FALSE);
+ g_return_val_if_fail (GTK_IS_WIDGET (item), FALSE);
+
+ page_num = gtk_notebook_page_num (GTK_NOTEBOOK (panel->priv->notebook),
+ item);
+
+ if (page_num == -1)
+ return FALSE;
+
+ cur_page = gtk_notebook_get_current_page (
+ GTK_NOTEBOOK (panel->priv->notebook));
+
+ return (page_num == cur_page);
+}
+
+/**
+ * pluma_panel_get_orientation:
+ * @panel: a #PlumaPanel
+ *
+ * Gets the orientation of the @panel.
+ *
+ * Returns: the #GtkOrientation of #PlumaPanel
+ */
+GtkOrientation
+pluma_panel_get_orientation (PlumaPanel *panel)
+{
+ g_return_val_if_fail (PLUMA_IS_PANEL (panel), GTK_ORIENTATION_VERTICAL);
+
+ return panel->priv->orientation;
+}
+
+/**
+ * pluma_panel_get_n_items:
+ * @panel: a #PlumaPanel
+ *
+ * Gets the number of items in a @panel.
+ *
+ * Returns: the number of items contained in #PlumaPanel
+ */
+gint
+pluma_panel_get_n_items (PlumaPanel *panel)
+{
+ g_return_val_if_fail (PLUMA_IS_PANEL (panel), -1);
+
+ return gtk_notebook_get_n_pages (GTK_NOTEBOOK (panel->priv->notebook));
+}
+
+gint
+_pluma_panel_get_active_item_id (PlumaPanel *panel)
+{
+ gint cur_page;
+ GtkWidget *item;
+ PlumaPanelItem *data;
+
+ g_return_val_if_fail (PLUMA_IS_PANEL (panel), 0);
+
+ cur_page = gtk_notebook_get_current_page (
+ GTK_NOTEBOOK (panel->priv->notebook));
+ if (cur_page == -1)
+ return 0;
+
+ item = gtk_notebook_get_nth_page (
+ GTK_NOTEBOOK (panel->priv->notebook),
+ cur_page);
+
+ /* FIXME: for now we use as the hash of the name as id.
+ * However the name is not guaranteed to be unique and
+ * it is a translated string, so it's subotimal, but should
+ * be good enough for now since we don't want to add an
+ * ad hoc id argument.
+ */
+
+ data = (PlumaPanelItem *)g_object_get_data (G_OBJECT (item),
+ PANEL_ITEM_KEY);
+ g_return_val_if_fail (data != NULL, 0);
+
+ return g_str_hash (data->name);
+}
+
+void
+_pluma_panel_set_active_item_by_id (PlumaPanel *panel,
+ gint id)
+{
+ gint n, i;
+
+ g_return_if_fail (PLUMA_IS_PANEL (panel));
+
+ if (id == 0)
+ return;
+
+ n = gtk_notebook_get_n_pages (
+ GTK_NOTEBOOK (panel->priv->notebook));
+
+ for (i = 0; i < n; i++)
+ {
+ GtkWidget *item;
+ PlumaPanelItem *data;
+
+ item = gtk_notebook_get_nth_page (
+ GTK_NOTEBOOK (panel->priv->notebook), i);
+
+ data = (PlumaPanelItem *)g_object_get_data (G_OBJECT (item),
+ PANEL_ITEM_KEY);
+ g_return_if_fail (data != NULL);
+
+ if (g_str_hash (data->name) == id)
+ {
+ gtk_notebook_set_current_page (
+ GTK_NOTEBOOK (panel->priv->notebook), i);
+
+ return;
+ }
+ }
+}