/*

 * GTK - The GIMP Toolkit

 * Copyright (C) 1998, 1999 Red Hat, Inc.

 * All rights reserved.

 *

 * This Library is free software; you can redistribute it and/or

 * modify it under the terms of the GNU Library General Public License as

 * published by the Free Software Foundation; either version 2 of the

 * License, or (at your option) any later version.

 *

 * This Library 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

 * Library General Public License for more details.

 *

 * You should have received a copy of the GNU Library General Public

 * License along with the Gnome Library; see the file COPYING.LIB.  If not,

 * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,

 * Boston, MA 02111-1307, USA.

 */

/*

 * Author: James Henstridge <james@daa.com.au>

 *

 * Modified by the GTK+ Team and others 2003.  See the AUTHORS

 * file for a list of people on the GTK+ Team.  See the ChangeLog

 * files for a list of changes.  These files are distributed with

 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.

 */

#include "config.h"

#include <string.h>

#include "gtkaccellabel.h"

#include "gtkactivatable.h"

#include "gtkbuildable.h"

#include "gtkimagemenuitem.h"

#include "gtkintl.h"

#include "gtkmarshalers.h"

#include "gtkmenu.h"

#include "gtkmenubar.h"

#include "gtkmenutoolbutton.h"

#include "gtkseparatormenuitem.h"

#include "gtkseparatortoolitem.h"

#include "gtktearoffmenuitem.h"

#include "gtktoolbar.h"

#include "gtkuimanager.h"

#include "gtkwindow.h"

#include "gtkprivate.h"

#include "gtkalias.h"

#undef DEBUG_UI_MANAGER

typedef enum

{

  NODE_TYPE_UNDECIDED,

  NODE_TYPE_ROOT,

  NODE_TYPE_MENUBAR,

  NODE_TYPE_MENU,

  NODE_TYPE_TOOLBAR,

  NODE_TYPE_MENU_PLACEHOLDER,

  NODE_TYPE_TOOLBAR_PLACEHOLDER,

  NODE_TYPE_POPUP,

  NODE_TYPE_MENUITEM,

  NODE_TYPE_TOOLITEM,

  NODE_TYPE_SEPARATOR,

  NODE_TYPE_ACCELERATOR

} NodeType;

typedef struct _Node Node;

struct _Node {

  NodeType type;

  gchar *name;

  GQuark action_name;

  GtkAction *action;

  GtkWidget *proxy;

  GtkWidget *extra; /* second separator for placeholders */

  GList *uifiles;

  guint dirty : 1;

  guint expand : 1;  /* used for separators */

  guint popup_accels : 1;

  guint always_show_image_set : 1; /* used for menu items */

  guint always_show_image     : 1; /* used for menu items */

};

#define GTK_UI_MANAGER_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_UI_MANAGER, GtkUIManagerPrivate))

struct _GtkUIManagerPrivate 

{

  GtkAccelGroup *accel_group;

  GNode *root_node;

  GList *action_groups;

  guint last_merge_id;

  guint update_tag;  

  gboolean add_tearoffs;

};

#define NODE_INFO(node) ((Node *)node->data)

typedef struct _NodeUIReference NodeUIReference;

struct _NodeUIReference 

{

  guint merge_id;

  GQuark action_quark;

};

static void        gtk_ui_manager_finalize        (GObject           *object);

static void        gtk_ui_manager_set_property    (GObject           *object,

                                                   guint              prop_id,

                                                   const GValue      *value,

                                                   GParamSpec        *pspec);

static void        gtk_ui_manager_get_property    (GObject           *object,

                                                   guint              prop_id,

                                                   GValue            *value,

                                                   GParamSpec        *pspec);

static GtkWidget * gtk_ui_manager_real_get_widget (GtkUIManager      *manager,

                                                   const gchar       *path);

static GtkAction * gtk_ui_manager_real_get_action (GtkUIManager      *manager,

                                                   const gchar       *path);

static void        queue_update                   (GtkUIManager      *self);

static void        dirty_all_nodes                (GtkUIManager      *self);

static void        mark_node_dirty                (GNode             *node);

static GNode     * get_child_node                 (GtkUIManager      *self,

                                                   GNode             *parent,

						   GNode             *sibling,

                                                   const gchar       *childname,

                                                   gint               childname_length,

                                                   NodeType           node_type,

                                                   gboolean           create,

                                                   gboolean           top);

static GNode     * get_node                       (GtkUIManager      *self,

                                                   const gchar       *path,

                                                   NodeType           node_type,

                                                   gboolean           create);

static gboolean    free_node                      (GNode             *node);

static void        node_prepend_ui_reference      (GNode             *node,

                                                   guint              merge_id,

                                                   GQuark             action_quark);

static void        node_remove_ui_reference       (GNode             *node,

                                                   guint              merge_id);

/* GtkBuildable */

static void gtk_ui_manager_buildable_init      (GtkBuildableIface *iface);

static void gtk_ui_manager_buildable_add_child (GtkBuildable  *buildable,

						GtkBuilder    *builder,

						GObject       *child,

						const gchar   *type);

static GObject* gtk_ui_manager_buildable_construct_child (GtkBuildable *buildable,

							  GtkBuilder   *builder,

							  const gchar  *name);

static gboolean gtk_ui_manager_buildable_custom_tag_start (GtkBuildable  *buildable,

							   GtkBuilder    *builder,

							   GObject       *child,

							   const gchar   *tagname,

							   GMarkupParser *parser,

							   gpointer      *data);

static void     gtk_ui_manager_buildable_custom_tag_end (GtkBuildable 	 *buildable,

							 GtkBuilder   	 *builder,

							 GObject      	 *child,

							 const gchar  	 *tagname,

							 gpointer     	 *data);

enum 

{

  ADD_WIDGET,

  ACTIONS_CHANGED,

  CONNECT_PROXY,

  DISCONNECT_PROXY,

  PRE_ACTIVATE,

  POST_ACTIVATE,

  LAST_SIGNAL

};

enum

{

  PROP_0,

  PROP_ADD_TEAROFFS,

  PROP_UI

};

static guint ui_manager_signals[LAST_SIGNAL] = { 0 };

G_DEFINE_TYPE_WITH_CODE (GtkUIManager, gtk_ui_manager, G_TYPE_OBJECT,

			 G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,

						gtk_ui_manager_buildable_init))

static void

gtk_ui_manager_class_init (GtkUIManagerClass *klass)

{

  GObjectClass *gobject_class;

  gobject_class = G_OBJECT_CLASS (klass);

  gobject_class->finalize = gtk_ui_manager_finalize;

  gobject_class->set_property = gtk_ui_manager_set_property;

  gobject_class->get_property = gtk_ui_manager_get_property;

  klass->get_widget = gtk_ui_manager_real_get_widget;

  klass->get_action = gtk_ui_manager_real_get_action;

  /**

   * GtkUIManager:add-tearoffs:

   *

   * The "add-tearoffs" property controls whether generated menus 

   * have tearoff menu items. 

   *

   * Note that this only affects regular menus. Generated popup 

   * menus never have tearoff menu items.   

   *

   * Since: 2.4

   */

  g_object_class_install_property (gobject_class,

                                   PROP_ADD_TEAROFFS,

                                   g_param_spec_boolean ("add-tearoffs",

							 P_("Add tearoffs to menus"),

							 P_("Whether tearoff menu items should be added to menus"),

                                                         FALSE,

							 GTK_PARAM_READWRITE));

  g_object_class_install_property (gobject_class,

				   PROP_UI,

				   g_param_spec_string ("ui",

 							P_("Merged UI definition"),

							P_("An XML string describing the merged UI"),

							"<ui>\n</ui>\n",

							GTK_PARAM_READABLE));

  /**

   * GtkUIManager::add-widget:

   * @merge: a #GtkUIManager

   * @widget: the added widget

   *

   * The add_widget signal is emitted for each generated menubar and toolbar.

   * It is not emitted for generated popup menus, which can be obtained by 

   * gtk_ui_manager_get_widget().

   *

   * Since: 2.4

   */

  ui_manager_signals[ADD_WIDGET] =

    g_signal_new (I_("add-widget"),

		  G_OBJECT_CLASS_TYPE (klass),

		  G_SIGNAL_RUN_FIRST | G_SIGNAL_NO_RECURSE,

		  G_STRUCT_OFFSET (GtkUIManagerClass, add_widget),

		  NULL, NULL,

		  g_cclosure_marshal_VOID__OBJECT,

		  G_TYPE_NONE, 1, 

		  GTK_TYPE_WIDGET);

  /**

   * GtkUIManager::actions-changed:

   * @merge: a #GtkUIManager

   *

   * The "actions-changed" signal is emitted whenever the set of actions

   * changes.

   *

   * Since: 2.4

   */

  ui_manager_signals[ACTIONS_CHANGED] =

    g_signal_new (I_("actions-changed"),

		  G_OBJECT_CLASS_TYPE (klass),

		  G_SIGNAL_RUN_FIRST | G_SIGNAL_NO_RECURSE,

		  G_STRUCT_OFFSET (GtkUIManagerClass, actions_changed),  

		  NULL, NULL,

		  g_cclosure_marshal_VOID__VOID,

		  G_TYPE_NONE, 0);

  /**

   * GtkUIManager::connect-proxy:

   * @uimanager: the ui manager

   * @action: the action

   * @proxy: the proxy

   *

   * The connect_proxy signal is emitted after connecting a proxy to 

   * an action in the group. 

   *

   * This is intended for simple customizations for which a custom action

   * class would be too clumsy, e.g. showing tooltips for menuitems in the

   * statusbar.

   *

   * Since: 2.4

   */

  ui_manager_signals[CONNECT_PROXY] =

    g_signal_new (I_("connect-proxy"),

		  G_OBJECT_CLASS_TYPE (klass),

		  G_SIGNAL_RUN_FIRST | G_SIGNAL_NO_RECURSE,

		  G_STRUCT_OFFSET (GtkUIManagerClass, connect_proxy),

		  NULL, NULL,

		  _gtk_marshal_VOID__OBJECT_OBJECT,

		  G_TYPE_NONE, 2, 

		  GTK_TYPE_ACTION,

		  GTK_TYPE_WIDGET);

  /**

   * GtkUIManager::disconnect-proxy:

   * @uimanager: the ui manager

   * @action: the action

   * @proxy: the proxy

   *

   * The disconnect_proxy signal is emitted after disconnecting a proxy 

   * from an action in the group. 

   *

   * Since: 2.4

   */

  ui_manager_signals[DISCONNECT_PROXY] =

    g_signal_new (I_("disconnect-proxy"),

		  G_OBJECT_CLASS_TYPE (klass),

		  G_SIGNAL_RUN_FIRST | G_SIGNAL_NO_RECURSE,

		  G_STRUCT_OFFSET (GtkUIManagerClass, disconnect_proxy),

		  NULL, NULL,

		  _gtk_marshal_VOID__OBJECT_OBJECT,

		  G_TYPE_NONE, 2,

		  GTK_TYPE_ACTION,

		  GTK_TYPE_WIDGET);

  /**

   * GtkUIManager::pre-activate:

   * @uimanager: the ui manager

   * @action: the action

   *

   * The pre_activate signal is emitted just before the @action

   * is activated.

   *

   * This is intended for applications to get notification

   * just before any action is activated.

   *

   * Since: 2.4

   */

  ui_manager_signals[PRE_ACTIVATE] =

    g_signal_new (I_("pre-activate"),

		  G_OBJECT_CLASS_TYPE (klass),

		  G_SIGNAL_RUN_FIRST | G_SIGNAL_NO_RECURSE,

		  G_STRUCT_OFFSET (GtkUIManagerClass, pre_activate),

		  NULL, NULL,

		  _gtk_marshal_VOID__OBJECT,

		  G_TYPE_NONE, 1,

		  GTK_TYPE_ACTION);

  /**

   * GtkUIManager::post-activate:

   * @uimanager: the ui manager

   * @action: the action

   *

   * The post_activate signal is emitted just after the @action

   * is activated.

   *

   * This is intended for applications to get notification

   * just after any action is activated.

   *

   * Since: 2.4

   */

  ui_manager_signals[POST_ACTIVATE] =

    g_signal_new (I_("post-activate"),

		  G_OBJECT_CLASS_TYPE (klass),

		  G_SIGNAL_RUN_FIRST | G_SIGNAL_NO_RECURSE,

		  G_STRUCT_OFFSET (GtkUIManagerClass, post_activate),

		  NULL, NULL,

		  _gtk_marshal_VOID__OBJECT,

		  G_TYPE_NONE, 1,

		  GTK_TYPE_ACTION);

  klass->add_widget = NULL;

  klass->actions_changed = NULL;

  klass->connect_proxy = NULL;

  klass->disconnect_proxy = NULL;

  klass->pre_activate = NULL;

  klass->post_activate = NULL;

  g_type_class_add_private (gobject_class, sizeof (GtkUIManagerPrivate));

}

static void

gtk_ui_manager_init (GtkUIManager *self)

{

  guint merge_id;

  GNode *node;

  self->private_data = GTK_UI_MANAGER_GET_PRIVATE (self);

  self->private_data->accel_group = gtk_accel_group_new ();

  self->private_data->root_node = NULL;

  self->private_data->action_groups = NULL;

  self->private_data->last_merge_id = 0;

  self->private_data->add_tearoffs = FALSE;

  merge_id = gtk_ui_manager_new_merge_id (self);

  node = get_child_node (self, NULL, NULL, "ui", 2,

			 NODE_TYPE_ROOT, TRUE, FALSE);

  node_prepend_ui_reference (node, merge_id, 0);

}

static void

gtk_ui_manager_finalize (GObject *object)

{

  GtkUIManager *self = GTK_UI_MANAGER (object);

  if (self->private_data->update_tag != 0)

    {

      g_source_remove (self->private_data->update_tag);

      self->private_data->update_tag = 0;

    }

  g_node_traverse (self->private_data->root_node, 

		   G_POST_ORDER, G_TRAVERSE_ALL, -1,

		   (GNodeTraverseFunc)free_node, NULL);

  g_node_destroy (self->private_data->root_node);

  self->private_data->root_node = NULL;

  g_list_foreach (self->private_data->action_groups,

                  (GFunc) g_object_unref, NULL);

  g_list_free (self->private_data->action_groups);

  self->private_data->action_groups = NULL;

  g_object_unref (self->private_data->accel_group);

  self->private_data->accel_group = NULL;

  G_OBJECT_CLASS (gtk_ui_manager_parent_class)->finalize (object);

}

static void

gtk_ui_manager_buildable_init (GtkBuildableIface *iface)

{

  iface->add_child = gtk_ui_manager_buildable_add_child;

  iface->construct_child = gtk_ui_manager_buildable_construct_child;

  iface->custom_tag_start = gtk_ui_manager_buildable_custom_tag_start;

  iface->custom_tag_end = gtk_ui_manager_buildable_custom_tag_end;

}

static void

gtk_ui_manager_buildable_add_child (GtkBuildable  *buildable,

				    GtkBuilder    *builder,

				    GObject       *child,

				    const gchar   *type)

{

  GtkUIManager *self = GTK_UI_MANAGER (buildable);

  guint pos;

  g_return_if_fail (GTK_IS_ACTION_GROUP (child));

  pos = g_list_length (self->private_data->action_groups);

  g_object_ref (child);

  gtk_ui_manager_insert_action_group (self,

				      GTK_ACTION_GROUP (child),

				      pos);

}

static void

child_hierarchy_changed_cb (GtkWidget *widget,

			    GtkWidget *unused,

			    GtkUIManager *uimgr)

{

  GtkWidget *toplevel;

  GtkAccelGroup *group;

  GSList *groups;

  toplevel = gtk_widget_get_toplevel (widget);

  if (!toplevel || !GTK_IS_WINDOW (toplevel))

    return;

  group = gtk_ui_manager_get_accel_group (uimgr);

  groups = gtk_accel_groups_from_object (G_OBJECT (toplevel));

  if (g_slist_find (groups, group) == NULL)

    gtk_window_add_accel_group (GTK_WINDOW (toplevel), group);

  g_signal_handlers_disconnect_by_func (widget,

					child_hierarchy_changed_cb,

					uimgr);

}

static GObject *

gtk_ui_manager_buildable_construct_child (GtkBuildable *buildable,

					  GtkBuilder   *builder,

					  const gchar  *id)

{

  GtkWidget *widget;

  char *name;

  name = g_strdup_printf ("ui/%s", id);

  widget = gtk_ui_manager_get_widget (GTK_UI_MANAGER (buildable), name);

  if (!widget)

    {

      g_error ("Unknown ui manager child: %s\n", name);

      g_free (name);

      return NULL;

    }

  g_free (name);

  g_signal_connect (widget, "hierarchy-changed",

		    G_CALLBACK (child_hierarchy_changed_cb),

		    GTK_UI_MANAGER (buildable));

  return g_object_ref (widget);

}

static void

gtk_ui_manager_set_property (GObject         *object,

			     guint            prop_id,

			     const GValue    *value,

			     GParamSpec      *pspec)

{

  GtkUIManager *self = GTK_UI_MANAGER (object);

  switch (prop_id)

    {

    case PROP_ADD_TEAROFFS:

      gtk_ui_manager_set_add_tearoffs (self, g_value_get_boolean (value));

      break;

    default:

      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);

      break;

    }

}

static void

gtk_ui_manager_get_property (GObject         *object,

			     guint            prop_id,

			     GValue          *value,

			     GParamSpec      *pspec)

{

  GtkUIManager *self = GTK_UI_MANAGER (object);

  switch (prop_id)

    {

    case PROP_ADD_TEAROFFS:

      g_value_set_boolean (value, self->private_data->add_tearoffs);

      break;

    case PROP_UI:

      g_value_take_string (value, gtk_ui_manager_get_ui (self));

      break;

    default:

      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);

      break;

    }

}

static GtkWidget *

gtk_ui_manager_real_get_widget (GtkUIManager *self,

                                const gchar  *path)

{

  GNode *node;

  /* ensure that there are no pending updates before we get the

   * widget */

  gtk_ui_manager_ensure_update (self);

  node = get_node (self, path, NODE_TYPE_UNDECIDED, FALSE);

  if (node == NULL)

    return NULL;

  return NODE_INFO (node)->proxy;

}

static GtkAction *

gtk_ui_manager_real_get_action (GtkUIManager *self,

                                const gchar  *path)

{

  GNode *node;

  /* ensure that there are no pending updates before we get

   * the action */

  gtk_ui_manager_ensure_update (self);

  node = get_node (self, path, NODE_TYPE_UNDECIDED, FALSE);

  if (node == NULL)

    return NULL;

  return NODE_INFO (node)->action;

}

/**

 * gtk_ui_manager_new:

 * 

 * Creates a new ui manager object.

 * 

 * Return value: a new ui manager object.

 *

 * Since: 2.4

 **/

GtkUIManager*

gtk_ui_manager_new (void)

{

  return g_object_new (GTK_TYPE_UI_MANAGER, NULL);

}

/**

 * gtk_ui_manager_get_add_tearoffs:

 * @self: a #GtkUIManager

 * 

 * Returns whether menus generated by this #GtkUIManager

 * will have tearoff menu items. 

 * 

 * Return value: whether tearoff menu items are added

 *

 * Since: 2.4

 **/

gboolean 

gtk_ui_manager_get_add_tearoffs (GtkUIManager *self)

{

  g_return_val_if_fail (GTK_IS_UI_MANAGER (self), FALSE);

  return self->private_data->add_tearoffs;

}

/**

 * gtk_ui_manager_set_add_tearoffs:

 * @self: a #GtkUIManager

 * @add_tearoffs: whether tearoff menu items are added

 * 

 * Sets the "add_tearoffs" property, which controls whether menus 

 * generated by this #GtkUIManager will have tearoff menu items. 

 *

 * Note that this only affects regular menus. Generated popup 

 * menus never have tearoff menu items.

 *

 * Since: 2.4

 **/

void 

gtk_ui_manager_set_add_tearoffs (GtkUIManager *self,

				 gboolean      add_tearoffs)

{

  g_return_if_fail (GTK_IS_UI_MANAGER (self));

  add_tearoffs = add_tearoffs != FALSE;

  if (add_tearoffs != self->private_data->add_tearoffs)

    {

      self->private_data->add_tearoffs = add_tearoffs;

      dirty_all_nodes (self);

      g_object_notify (G_OBJECT (self), "add-tearoffs");

    }

}

static void

cb_proxy_connect_proxy (GtkActionGroup *group, 

                        GtkAction      *action,

                        GtkWidget      *proxy, 

                        GtkUIManager *self)

{

  g_signal_emit (self, ui_manager_signals[CONNECT_PROXY], 0, action, proxy);

}

static void

cb_proxy_disconnect_proxy (GtkActionGroup *group, 

                           GtkAction      *action,

                           GtkWidget      *proxy, 

                           GtkUIManager *self)

{

  g_signal_emit (self, ui_manager_signals[DISCONNECT_PROXY], 0, action, proxy);

}

static void

cb_proxy_pre_activate (GtkActionGroup *group, 

                       GtkAction      *action,

                       GtkUIManager   *self)

{

  g_signal_emit (self, ui_manager_signals[PRE_ACTIVATE], 0, action);

}

static void

cb_proxy_post_activate (GtkActionGroup *group, 

                        GtkAction      *action,

                        GtkUIManager   *self)

{

  g_signal_emit (self, ui_manager_signals[POST_ACTIVATE], 0, action);

}

/**

 * gtk_ui_manager_insert_action_group:

 * @self: a #GtkUIManager object

 * @action_group: the action group to be inserted

 * @pos: the position at which the group will be inserted.

 * 

 * Inserts an action group into the list of action groups associated 

 * with @self. Actions in earlier groups hide actions with the same 

 * name in later groups. 

 *

 * Since: 2.4

 **/

void

gtk_ui_manager_insert_action_group (GtkUIManager   *self,

				    GtkActionGroup *action_group, 

				    gint            pos)

{

#ifdef G_ENABLE_DEBUG

  GList *l;

  const char *group_name;

#endif 

  g_return_if_fail (GTK_IS_UI_MANAGER (self));

  g_return_if_fail (GTK_IS_ACTION_GROUP (action_group));

  g_return_if_fail (g_list_find (self->private_data->action_groups, 

				 action_group) == NULL);

#ifdef G_ENABLE_DEBUG

  group_name  = gtk_action_group_get_name (action_group);

  for (l = self->private_data->action_groups; l; l = l->next) 

    {

      GtkActionGroup *group = l->data;

      if (strcmp (gtk_action_group_get_name (group), group_name) == 0)

        {

          g_warning ("Inserting action group '%s' into UI manager which "

		     "already has a group with this name\n", group_name);

          break;

        }

    }

#endif /* G_ENABLE_DEBUG */

  g_object_ref (action_group);

  self->private_data->action_groups = 

    g_list_insert (self->private_data->action_groups, action_group, pos);

  g_object_connect (action_group,

		    "object-signal::connect-proxy", G_CALLBACK (cb_proxy_connect_proxy), self,

		    "object-signal::disconnect-proxy", G_CALLBACK (cb_proxy_disconnect_proxy), self,

		    "object-signal::pre-activate", G_CALLBACK (cb_proxy_pre_activate), self,

		    "object-signal::post-activate", G_CALLBACK (cb_proxy_post_activate), self,

		    NULL);

  /* dirty all nodes, as action bindings may change */

  dirty_all_nodes (self);

  g_signal_emit (self, ui_manager_signals[ACTIONS_CHANGED], 0);

}

/**

 * gtk_ui_manager_remove_action_group:

 * @self: a #GtkUIManager object

 * @action_group: the action group to be removed

 * 

 * Removes an action group from the list of action groups associated 

 * with @self.

 *

 * Since: 2.4

 **/

void

gtk_ui_manager_remove_action_group (GtkUIManager   *self,

				    GtkActionGroup *action_group)

{

  g_return_if_fail (GTK_IS_UI_MANAGER (self));

  g_return_if_fail (GTK_IS_ACTION_GROUP (action_group));

  g_return_if_fail (g_list_find (self->private_data->action_groups, 

				 action_group) != NULL);

  self->private_data->action_groups =

    g_list_remove (self->private_data->action_groups, action_group);

  g_object_disconnect (action_group,

                       "any-signal::connect-proxy", G_CALLBACK (cb_proxy_connect_proxy), self,

                       "any-signal::disconnect-proxy", G_CALLBACK (cb_proxy_disconnect_proxy), self,

                       "any-signal::pre-activate", G_CALLBACK (cb_proxy_pre_activate), self,

                       "any-signal::post-activate", G_CALLBACK (cb_proxy_post_activate), self, 

                       NULL);

  g_object_unref (action_group);

  /* dirty all nodes, as action bindings may change */

  dirty_all_nodes (self);

  g_signal_emit (self, ui_manager_signals[ACTIONS_CHANGED], 0);

}

/**

 * gtk_ui_manager_get_action_groups:

 * @self: a #GtkUIManager object

 * 

 * Returns the list of action groups associated with @self.

 *

 * Return value:  (element-type GtkActionGroup) (transfer none): a #GList of

 *   action groups. The list is owned by GTK+

 *   and should not be modified.

 *

 * Since: 2.4

 **/

GList *

gtk_ui_manager_get_action_groups (GtkUIManager *self)

{

  g_return_val_if_fail (GTK_IS_UI_MANAGER (self), NULL);

  return self->private_data->action_groups;

}

/**

 * gtk_ui_manager_get_accel_group:

 * @self: a #GtkUIManager object

 * 

 * Returns the #GtkAccelGroup associated with @self.

 *

 * Return value: (transfer none): the #GtkAccelGroup.

 *

 * Since: 2.4

 **/

GtkAccelGroup *

gtk_ui_manager_get_accel_group (GtkUIManager *self)

{

  g_return_val_if_fail (GTK_IS_UI_MANAGER (self), NULL);

  return self->private_data->accel_group;

}

/**

 * gtk_ui_manager_get_widget:

 * @self: a #GtkUIManager

 * @path: a path

 * 

 * Looks up a widget by following a path. 

 * The path consists of the names specified in the XML description of the UI. 

 * separated by '/'. Elements which don't have a name or action attribute in 

 * the XML (e.g. <popup>) can be addressed by their XML element name 

 * (e.g. "popup"). The root element ("/ui") can be omitted in the path.

 *

 * Note that the widget found by following a path that ends in a <menu>

 * element is the menuitem to which the menu is attached, not the menu itself.

 *

 * Also note that the widgets constructed by a ui manager are not tied to 

 * the lifecycle of the ui manager. If you add the widgets returned by this 

 * function to some container or explicitly ref them, they will survive the

 * destruction of the ui manager.

 *

 * Return value: (transfer none): the widget found by following the path, or %NULL if no widget

 *   was found.

 *

 * Since: 2.4

 **/

GtkWidget *

gtk_ui_manager_get_widget (GtkUIManager *self,

			   const gchar  *path)

{

  g_return_val_if_fail (GTK_IS_UI_MANAGER (self), NULL);

  g_return_val_if_fail (path != NULL, NULL);

  return GTK_UI_MANAGER_GET_CLASS (self)->get_widget (self, path);

}

typedef struct {

  GtkUIManagerItemType types;

  GSList *list;

} ToplevelData;

static void

collect_toplevels (GNode   *node, 

		   gpointer user_data)

{

  ToplevelData *data = user_data;

  if (NODE_INFO (node)->proxy)

    {

      switch (NODE_INFO (node)->type) 

	{

	case NODE_TYPE_MENUBAR:

	  if (data->types & GTK_UI_MANAGER_MENUBAR)

	data->list = g_slist_prepend (data->list, NODE_INFO (node)->proxy);

	  break;

	case NODE_TYPE_TOOLBAR:

      if (data->types & GTK_UI_MANAGER_TOOLBAR)

	data->list = g_slist_prepend (data->list, NODE_INFO (node)->proxy);

      break;

	case NODE_TYPE_POPUP:

	  if (data->types & GTK_UI_MANAGER_POPUP)

	    data->list = g_slist_prepend (data->list, NODE_INFO (node)->proxy);