/* Parse to take a set of GTK Menus and turn them into something that can be sent over the wire. Copyright 2011 Canonical Ltd. Authors: Numerous (check Bazaar) This program is free software: you can redistribute it and/or modify it under the terms of either or both of the following licenses: 1) the GNU Lesser General Public License version 3, as published by the Free Software Foundation; and/or 2) the GNU Lesser General Public License version 2.1, as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranties of MERCHANTABILITY, SATISFACTORY QUALITY or FITNESS FOR A PARTICULAR PURPOSE. See the applicable version of the GNU Lesser General Public License for more details. You should have received a copy of both the GNU Lesser General Public License version 3 and version 2.1 along with this program. If not, see */ #include "parser.h" #include "menuitem.h" #include "serializablemenuitem.h" #define CACHED_MENUITEM "dbusmenu-gtk-parser-cached-item" #define PARSER_DATA "dbusmenu-gtk-parser-data" typedef struct _ParserData { GtkWidget *label; GtkAction *action; GtkWidget *widget; GtkWidget *shell; } ParserData; typedef struct _RecurseContext { GtkWidget * toplevel; DbusmenuMenuitem * parent; } RecurseContext; static void parse_menu_structure_helper (GtkWidget * widget, RecurseContext * recurse); static DbusmenuMenuitem * construct_dbusmenu_for_widget (GtkWidget * widget); static void accel_changed (GtkWidget * widget, gpointer data); static gboolean update_stock_item (DbusmenuMenuitem * menuitem, GtkWidget * widget); static void checkbox_toggled (GtkWidget * widget, DbusmenuMenuitem * mi); static void update_icon_name (DbusmenuMenuitem * menuitem, GtkWidget * widget); static GtkWidget * find_menu_label (GtkWidget * widget); static void label_notify_cb (GtkWidget * widget, GParamSpec * pspec, gpointer data); static void action_notify_cb (GtkAction * action, GParamSpec * pspec, gpointer data); static void child_added_cb (GtkContainer * menu, GtkWidget * widget, gpointer data); static void item_activated (DbusmenuMenuitem * item, guint timestamp, gpointer user_data); static gboolean item_about_to_show (DbusmenuMenuitem * item, gpointer user_data); static void widget_notify_cb (GtkWidget * widget, GParamSpec * pspec, gpointer data); static gboolean should_show_image (GtkImage * image); static void menuitem_notify_cb (GtkWidget * widget, GParamSpec * pspec, gpointer data); /** dbusmenu_gtk_parse_menu_structure: @widget: A #GtkMenuItem or #GtkMenuShell to turn into a #DbusmenuMenuitem Goes through the GTK structures and turns them into the appropraite Dbusmenu structures along with setting up all the relationships between the objects. It also stores the dbusmenu items as a cache on the GTK items so that they'll be reused if necissary. Return value: A dbusmenu item representing the menu structure */ DbusmenuMenuitem * dbusmenu_gtk_parse_menu_structure (GtkWidget * widget) { g_return_val_if_fail(GTK_IS_MENU_ITEM(widget) || GTK_IS_MENU_SHELL(widget), NULL); RecurseContext recurse = {0}; recurse.toplevel = gtk_widget_get_toplevel(widget); parse_menu_structure_helper(widget, &recurse); return recurse.parent; } /* Called when the dbusmenu item that we're keeping around is finalized */ static void dbusmenu_cache_freed (gpointer data, GObject * obj) { /* If the dbusmenu item is killed we don't need to remove the weak ref as well. */ g_object_steal_data(G_OBJECT(data), CACHED_MENUITEM); ParserData *pdata = (ParserData *)g_object_get_data(G_OBJECT(obj), PARSER_DATA); if (pdata != NULL && pdata->label != NULL) { g_signal_handlers_disconnect_by_func(pdata->label, G_CALLBACK(label_notify_cb), obj); g_object_remove_weak_pointer(G_OBJECT(pdata->label), (gpointer*)&pdata->label); } if (pdata != NULL && pdata->action != NULL) { g_signal_handlers_disconnect_by_func(pdata->action, G_CALLBACK(action_notify_cb), obj); g_object_remove_weak_pointer(G_OBJECT(pdata->action), (gpointer*)&pdata->action); } if (pdata != NULL && pdata->widget != NULL) { g_signal_handlers_disconnect_by_func(pdata->widget, G_CALLBACK(widget_notify_cb), obj); g_object_remove_weak_pointer(G_OBJECT(pdata->widget), (gpointer*)&pdata->widget); } if (pdata != NULL && pdata->shell != NULL) { g_signal_handlers_disconnect_by_func(pdata->shell, G_CALLBACK(child_added_cb), obj); g_object_remove_weak_pointer(G_OBJECT(pdata->shell), (gpointer*)&pdata->shell); } return; } /* Called if we replace the cache on the object with a new dbusmenu menuitem */ static void object_cache_freed (gpointer data) { // TODO: make this have access to both data and obj so we can call these //if (!G_IS_OBJECT(obj)) return; //g_object_weak_unref(G_OBJECT(obj), dbusmenu_cache_freed, data); //dbusmenu_cache_freed(data, obj); return; } /* Gets the positon of the child with its' parent if it has one. Returns -1 if the position is unable to be calculated. */ static gint get_child_position (GtkWidget * child) { GtkWidget * parent = gtk_widget_get_parent (child); if (parent == NULL || !GTK_IS_CONTAINER (parent)) return -1; GList * children = gtk_container_get_children (GTK_CONTAINER (parent)); GList * iter; gint position = 0; for (iter = children; iter != NULL; iter = iter->next) { if (iter->data == child) break; ++position; } g_list_free (children); if (iter == NULL) return -1; else return position; } /* Creates a new menu item that is attached to the widget and has the data linkages hooked up. Also allocates the ParserData */ static DbusmenuMenuitem * new_menuitem (GtkWidget * widget) { DbusmenuMenuitem * item = dbusmenu_menuitem_new(); ParserData *pdata = g_new0 (ParserData, 1); g_object_set_data_full(G_OBJECT(item), PARSER_DATA, pdata, g_free); g_object_set_data_full(G_OBJECT(widget), CACHED_MENUITEM, item, object_cache_freed); g_object_weak_ref(G_OBJECT(item), dbusmenu_cache_freed, widget); return item; } static void parse_menu_structure_helper (GtkWidget * widget, RecurseContext * recurse) { /* If this is a shell, then let's handle the items in it. */ if (GTK_IS_MENU_SHELL (widget)) { /* Okay, this is a little janky and all.. but some applications update some * menuitem properties such as sensitivity on the activate callback. This * seems a little weird, but it's not our place to judge when all this code * is so crazy. So we're going to get ever crazier and activate all the * menus that are directly below the menubar and force the applications to * update their sensitivity. The menus won't actually popup in the app * window due to our gtk+ patches. * * Note that this will not force menuitems in submenus to be updated as well. */ if (recurse->parent == NULL && GTK_IS_MENU_BAR(widget)) { GList *children = gtk_container_get_children (GTK_CONTAINER (widget)); GList *iter; for (iter = children; iter != NULL; iter = iter->next) { gtk_menu_shell_activate_item (GTK_MENU_SHELL (widget), iter->data, TRUE); } g_list_free (children); } if (recurse->parent == NULL) { recurse->parent = new_menuitem(widget); } ParserData *pdata = (ParserData *)g_object_get_data(G_OBJECT(recurse->parent), PARSER_DATA); pdata->shell = widget; g_signal_connect (G_OBJECT (widget), "child-added", G_CALLBACK (child_added_cb), recurse->parent); g_object_add_weak_pointer(G_OBJECT (widget), (gpointer*)&pdata->shell); gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback)parse_menu_structure_helper, recurse); return; } if (GTK_IS_MENU_ITEM(widget)) { DbusmenuMenuitem * thisitem = NULL; /* Check to see if we're cached already */ gpointer pmi = g_object_get_data(G_OBJECT(widget), CACHED_MENUITEM); if (pmi != NULL) { thisitem = DBUSMENU_MENUITEM(pmi); g_object_ref(G_OBJECT(thisitem)); } /* We don't have one, so we'll need to build it */ if (thisitem == NULL) { thisitem = construct_dbusmenu_for_widget (widget); if (!gtk_widget_get_visible (widget)) { g_signal_connect (G_OBJECT (widget), "notify::visible", G_CALLBACK (menuitem_notify_cb), recurse->toplevel); } if (GTK_IS_TEAROFF_MENU_ITEM (widget)) { dbusmenu_menuitem_property_set_bool (thisitem, DBUSMENU_MENUITEM_PROP_VISIBLE, FALSE); } } /* Check to see if we're in our parents list of children, if we have a parent. */ if (recurse->parent != NULL) { GList * children = dbusmenu_menuitem_get_children (recurse->parent); GList * peek = NULL; if (children != NULL) { peek = g_list_find (children, thisitem); } /* Oops, let's tell our parents about us */ if (peek == NULL) { /* TODO: Should we set a weak ref on the parent? */ g_object_set_data (G_OBJECT (thisitem), "dbusmenu-parent", recurse->parent); gint pos = get_child_position (widget); if (pos >= 0) dbusmenu_menuitem_child_add_position (recurse->parent, thisitem, pos); else dbusmenu_menuitem_child_append (recurse->parent, thisitem); } } GtkWidget *menu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (widget)); if (menu != NULL) { DbusmenuMenuitem * parent_save = recurse->parent; recurse->parent = thisitem; parse_menu_structure_helper (menu, recurse); recurse->parent = parent_save; } if (recurse->parent == NULL) { recurse->parent = thisitem; } else { g_object_unref(thisitem); } } return; } /* Turn a widget into a dbusmenu item depending on the type of GTK object that it is. */ static DbusmenuMenuitem * construct_dbusmenu_for_widget (GtkWidget * widget) { /* If it's a subclass of our serializable menu item then we can use its own build function */ if (DBUSMENU_IS_GTK_SERIALIZABLE_MENU_ITEM(widget)) { DbusmenuGtkSerializableMenuItem * smi = DBUSMENU_GTK_SERIALIZABLE_MENU_ITEM(widget); return dbusmenu_gtk_serializable_menu_item_build_menuitem(smi); } /* If it's a standard GTK Menu Item we need to do some of our own work */ if (GTK_IS_MENU_ITEM (widget)) { DbusmenuMenuitem *mi = new_menuitem(widget); ParserData *pdata = (ParserData *)g_object_get_data(G_OBJECT(mi), PARSER_DATA); gboolean visible = FALSE; gboolean sensitive = FALSE; if (GTK_IS_SEPARATOR_MENU_ITEM (widget)) { dbusmenu_menuitem_property_set (mi, "type", "separator"); visible = gtk_widget_get_visible (widget); sensitive = gtk_widget_get_sensitive (widget); } else { gboolean label_set = FALSE; g_signal_connect (widget, "accel-closures-changed", G_CALLBACK (accel_changed), mi); if (GTK_IS_CHECK_MENU_ITEM (widget)) { dbusmenu_menuitem_property_set (mi, DBUSMENU_MENUITEM_PROP_TOGGLE_TYPE, gtk_check_menu_item_get_draw_as_radio (GTK_CHECK_MENU_ITEM (widget)) ? DBUSMENU_MENUITEM_TOGGLE_RADIO : DBUSMENU_MENUITEM_TOGGLE_CHECK); dbusmenu_menuitem_property_set_int (mi, DBUSMENU_MENUITEM_PROP_TOGGLE_STATE, gtk_check_menu_item_get_active (GTK_CHECK_MENU_ITEM (widget)) ? DBUSMENU_MENUITEM_TOGGLE_STATE_CHECKED : DBUSMENU_MENUITEM_TOGGLE_STATE_UNCHECKED); g_signal_connect (widget, "activate", G_CALLBACK (checkbox_toggled), mi); } if (GTK_IS_IMAGE_MENU_ITEM (widget)) { GtkWidget *image; GtkImageType image_type; image = gtk_image_menu_item_get_image (GTK_IMAGE_MENU_ITEM (widget)); if (GTK_IS_IMAGE (image)) { image_type = gtk_image_get_storage_type (GTK_IMAGE (image)); if (image_type == GTK_IMAGE_STOCK) { label_set = update_stock_item (mi, image); } else if (image_type == GTK_IMAGE_ICON_NAME) { update_icon_name (mi, image); } else if (image_type == GTK_IMAGE_PIXBUF) { dbusmenu_menuitem_property_set_image (mi, DBUSMENU_MENUITEM_PROP_ICON_DATA, gtk_image_get_pixbuf (GTK_IMAGE (image))); } } } GtkWidget *label = find_menu_label (widget); dbusmenu_menuitem_property_set (mi, "label", label ? gtk_label_get_text (GTK_LABEL (label)) : NULL); if (label) { // Sometimes, an app will directly find and modify the label // (like empathy), so watch the label especially for that. pdata->label = label; g_signal_connect (G_OBJECT (label), "notify", G_CALLBACK (label_notify_cb), mi); g_object_add_weak_pointer(G_OBJECT (label), (gpointer*)&pdata->label); } if (GTK_IS_ACTIVATABLE (widget)) { GtkActivatable *activatable = GTK_ACTIVATABLE (widget); if (gtk_activatable_get_use_action_appearance (activatable)) { GtkAction *action = gtk_activatable_get_related_action (activatable); if (action) { visible = gtk_action_is_visible (action); sensitive = gtk_action_is_sensitive (action); pdata->action = action; g_signal_connect_object (action, "notify", G_CALLBACK (action_notify_cb), mi, G_CONNECT_AFTER); g_object_add_weak_pointer(G_OBJECT (action), (gpointer*)&pdata->action); } } } if (!g_object_get_data (G_OBJECT (widget), "gtk-empty-menu-item") && !GTK_IS_TEAROFF_MENU_ITEM (widget)) { visible = gtk_widget_get_visible (widget); sensitive = gtk_widget_get_sensitive (widget); } dbusmenu_menuitem_property_set_shortcut_menuitem (mi, GTK_MENU_ITEM (widget)); g_signal_connect (G_OBJECT (mi), DBUSMENU_MENUITEM_SIGNAL_ITEM_ACTIVATED, G_CALLBACK (item_activated), widget); g_signal_connect (G_OBJECT (mi), DBUSMENU_MENUITEM_SIGNAL_ABOUT_TO_SHOW, G_CALLBACK (item_about_to_show), widget); } dbusmenu_menuitem_property_set_bool (mi, DBUSMENU_MENUITEM_PROP_VISIBLE, visible); dbusmenu_menuitem_property_set_bool (mi, DBUSMENU_MENUITEM_PROP_ENABLED, sensitive); pdata->widget = widget; g_signal_connect (widget, "notify", G_CALLBACK (widget_notify_cb), mi); g_object_add_weak_pointer(G_OBJECT (widget), (gpointer*)&pdata->widget); return mi; } /* If it's none of those we're going to just create a generic menuitem as a place holder for it. */ return new_menuitem(widget); } static void menuitem_notify_cb (GtkWidget *widget, GParamSpec *pspec, gpointer data) { if (pspec->name == g_intern_static_string ("visible")) { GtkWidget * new_toplevel = gtk_widget_get_toplevel (widget); GtkWidget * old_toplevel = GTK_WIDGET(data); if (new_toplevel == old_toplevel) { /* TODO: Figure this out -> rebuild (context->bridge, window); */ } /* We only care about this once, so let's disconnect now. */ g_signal_handlers_disconnect_by_func (widget, G_CALLBACK (menuitem_notify_cb), data); } } static void accel_changed (GtkWidget *widget, gpointer data) { DbusmenuMenuitem *mi = (DbusmenuMenuitem *)data; dbusmenu_menuitem_property_set_shortcut_menuitem (mi, GTK_MENU_ITEM (widget)); } static gboolean update_stock_item (DbusmenuMenuitem *menuitem, GtkWidget *widget) { GtkStockItem stock; GtkImage *image; g_return_val_if_fail (GTK_IS_IMAGE (widget), FALSE); image = GTK_IMAGE (widget); if (gtk_image_get_storage_type (image) != GTK_IMAGE_STOCK) return FALSE; gchar * stock_id = NULL; gtk_image_get_stock(image, &stock_id, NULL); gtk_stock_lookup (stock_id, &stock); if (should_show_image (image)) dbusmenu_menuitem_property_set (menuitem, DBUSMENU_MENUITEM_PROP_ICON_NAME, stock_id); else dbusmenu_menuitem_property_remove (menuitem, DBUSMENU_MENUITEM_PROP_ICON_NAME); const gchar *label = dbusmenu_menuitem_property_get (menuitem, DBUSMENU_MENUITEM_PROP_LABEL); if (stock.label != NULL && label != NULL) { dbusmenu_menuitem_property_set (menuitem, DBUSMENU_MENUITEM_PROP_LABEL, stock.label); return TRUE; } return FALSE; } static void checkbox_toggled (GtkWidget *widget, DbusmenuMenuitem *mi) { dbusmenu_menuitem_property_set_int (mi, DBUSMENU_MENUITEM_PROP_TOGGLE_STATE, gtk_check_menu_item_get_active (GTK_CHECK_MENU_ITEM (widget)) ? DBUSMENU_MENUITEM_TOGGLE_STATE_CHECKED : DBUSMENU_MENUITEM_TOGGLE_STATE_UNCHECKED); } static void update_icon_name (DbusmenuMenuitem *menuitem, GtkWidget *widget) { GtkImage *image; g_return_if_fail (GTK_IS_IMAGE (widget)); image = GTK_IMAGE (widget); if (gtk_image_get_storage_type (image) != GTK_IMAGE_ICON_NAME) return; if (should_show_image (image)) { const gchar * icon_name = NULL; gtk_image_get_icon_name(image, &icon_name, NULL); dbusmenu_menuitem_property_set (menuitem, DBUSMENU_MENUITEM_PROP_ICON_NAME, icon_name); } else { dbusmenu_menuitem_property_remove (menuitem, DBUSMENU_MENUITEM_PROP_ICON_NAME); } } static GtkWidget * find_menu_label (GtkWidget *widget) { GtkWidget *label = NULL; if (GTK_IS_LABEL (widget)) return widget; if (GTK_IS_CONTAINER (widget)) { GList *children; GList *l; children = gtk_container_get_children (GTK_CONTAINER (widget)); for (l = children; l; l = l->next) { label = find_menu_label (l->data); if (label) break; } g_list_free (children); } return label; } static void label_notify_cb (GtkWidget *widget, GParamSpec *pspec, gpointer data) { DbusmenuMenuitem *child = (DbusmenuMenuitem *)data; if (pspec->name == g_intern_static_string ("label")) { dbusmenu_menuitem_property_set (child, DBUSMENU_MENUITEM_PROP_LABEL, gtk_label_get_text (GTK_LABEL (widget))); } } static void action_notify_cb (GtkAction *action, GParamSpec *pspec, gpointer data) { DbusmenuMenuitem *mi = (DbusmenuMenuitem *)data; if (pspec->name == g_intern_static_string ("sensitive")) { dbusmenu_menuitem_property_set_bool (mi, DBUSMENU_MENUITEM_PROP_ENABLED, gtk_action_is_sensitive (action)); } else if (pspec->name == g_intern_static_string ("visible")) { dbusmenu_menuitem_property_set_bool (mi, DBUSMENU_MENUITEM_PROP_VISIBLE, gtk_action_is_visible (action)); } else if (pspec->name == g_intern_static_string ("active")) { dbusmenu_menuitem_property_set_int (mi, DBUSMENU_MENUITEM_PROP_TOGGLE_STATE, gtk_toggle_action_get_active (GTK_TOGGLE_ACTION (action)) ? DBUSMENU_MENUITEM_TOGGLE_STATE_CHECKED : DBUSMENU_MENUITEM_TOGGLE_STATE_UNCHECKED); } else if (pspec->name == g_intern_static_string ("label")) { dbusmenu_menuitem_property_set (mi, DBUSMENU_MENUITEM_PROP_LABEL, gtk_action_get_label (action)); } } static void item_activated (DbusmenuMenuitem *item, guint timestamp, gpointer user_data) { GtkWidget *child; if (user_data != NULL) { child = (GtkWidget *)user_data; if (GTK_IS_MENU_ITEM (child)) { gtk_menu_item_activate (GTK_MENU_ITEM (child)); } } } static gboolean item_about_to_show (DbusmenuMenuitem *item, gpointer user_data) { GtkWidget *child; if (user_data != NULL) { child = (GtkWidget *)user_data; if (GTK_IS_MENU_ITEM (child)) { // Only called for items with submens. So we activate it here in // case the program dynamically creates menus (like empathy does) gtk_menu_item_activate (GTK_MENU_ITEM (child)); } } return TRUE; } static void widget_notify_cb (GtkWidget *widget, GParamSpec *pspec, gpointer data) { DbusmenuMenuitem *child = (DbusmenuMenuitem *)data; if (pspec->name == g_intern_static_string ("sensitive")) { dbusmenu_menuitem_property_set_bool (child, DBUSMENU_MENUITEM_PROP_ENABLED, gtk_widget_get_sensitive (widget)); } else if (pspec->name == g_intern_static_string ("label")) { dbusmenu_menuitem_property_set (child, DBUSMENU_MENUITEM_PROP_LABEL, gtk_menu_item_get_label (GTK_MENU_ITEM (widget))); } else if (pspec->name == g_intern_static_string ("visible")) { dbusmenu_menuitem_property_set_bool (child, DBUSMENU_MENUITEM_PROP_VISIBLE, gtk_widget_get_visible (widget)); } else if (pspec->name == g_intern_static_string ("stock")) { update_stock_item (child, widget); } else if (pspec->name == g_intern_static_string ("icon-name")) { update_icon_name (child, widget); } else if (pspec->name == g_intern_static_string ("parent")) { /* * We probably should have added a 'remove' method to the * UbuntuMenuProxy early on, but it's late in the cycle now. */ if (gtk_widget_get_parent (widget) == NULL) { g_signal_handlers_disconnect_by_func (widget, G_CALLBACK (widget_notify_cb), child); DbusmenuMenuitem *parent = g_object_get_data (G_OBJECT (child), "dbusmenu-parent"); if (DBUSMENU_IS_MENUITEM (parent) && DBUSMENU_IS_MENUITEM (child)) { dbusmenu_menuitem_child_delete (parent, child); } } } else if (pspec->name == g_intern_static_string ("submenu")) { /* The underlying submenu got swapped out. Let's see what it is now. */ /* First, delete any children that may exist currently. */ DbusmenuMenuitem * item = DBUSMENU_MENUITEM(g_object_get_data(G_OBJECT(widget), CACHED_MENUITEM)); if (item != NULL) { GList * children = dbusmenu_menuitem_take_children (item); GList * child = children; while (child != NULL) { g_object_unref (G_OBJECT(child->data)); child = child->next; } g_list_free(children); } /* Now parse new submenu. */ RecurseContext recurse = {0}; recurse.toplevel = gtk_widget_get_toplevel(widget); recurse.parent = item; if (item != NULL) { GtkWidget * menu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (widget)); parse_menu_structure_helper(menu, &recurse); } else { /* Note: it would be really odd that we wouldn't have a cached item, but we should handle that appropriately. */ parse_menu_structure_helper(widget, &recurse); g_object_unref(G_OBJECT(recurse.parent)); } } } /* A child item was added to a menu we're watching. Let's try to integrate it. */ static void child_added_cb (GtkContainer *menu, GtkWidget *widget, gpointer data) { DbusmenuMenuitem *menuitem = (DbusmenuMenuitem *)data; RecurseContext recurse = {0}; recurse.toplevel = gtk_widget_get_toplevel(GTK_WIDGET(menu)); recurse.parent = menuitem; parse_menu_structure_helper(widget, &recurse); } static gboolean should_show_image (GtkImage *image) { GtkWidget *item; item = gtk_widget_get_ancestor (GTK_WIDGET (image), GTK_TYPE_IMAGE_MENU_ITEM); if (item) { GtkSettings *settings; gboolean gtk_menu_images; settings = gtk_widget_get_settings (item); g_object_get (settings, "gtk-menu-images", >k_menu_images, NULL); if (gtk_menu_images) return TRUE; return gtk_image_menu_item_get_always_show_image (GTK_IMAGE_MENU_ITEM (item)); } return FALSE; }