path: root/e-util/e-popup.c

/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
 *  Authors: Michael Zucchi <notzed@ximian.com>
 *
 *  Copyright 2004 Ximian, Inc. (www.ximian.com)
 *
 *  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 Street #330, Boston, MA 02111-1307, USA.
 *
 */

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include <string.h>
#include <stdlib.h>

#include <glib.h>

#include <gtk/gtkmenu.h>
#include <gtk/gtkmenuitem.h>
#include <gtk/gtkimagemenuitem.h>
#include <gtk/gtkcheckmenuitem.h>
#include <gtk/gtkradiomenuitem.h>
#include <gtk/gtkseparatormenuitem.h>
#include <gtk/gtklabel.h>
#include <gtk/gtkimage.h>

#include "e-popup.h"

#include <e-util/e-icon-factory.h>

#include <libgnome/gnome-i18n.h>

struct _EPopupFactory {
    struct _EPopupFactory *next, *prev;

    char *menuid;
    EPopupFactoryFunc factory;
    void *factory_data;
};

/* Used for the "activate" signal callback data to re-map to the api */
struct _item_node {
    struct _item_node *next;

    EPopupItem *item;
    struct _menu_node *menu;
};

/* Stores all the items added */
struct _menu_node {
    struct _menu_node *next, *prev;

    EPopup *popup;

    GSList *menu;
    EPopupItemsFunc freefunc;
    void *data;

    struct _item_node *items;
};

struct _EPopupPrivate {
    EDList menus;
};

static GObjectClass *ep_parent;

static void
ep_init(GObject *o)
{
    EPopup *emp = (EPopup *)o;
    struct _EPopupPrivate *p;

    p = emp->priv = g_malloc0(sizeof(struct _EPopupPrivate));

    e_dlist_init(&p->menus);
}

static void
ep_finalise(GObject *o)
{
    EPopup *emp = (EPopup *)o;
    struct _EPopupPrivate *p = emp->priv;
    struct _menu_node *mnode, *nnode;

    mnode = (struct _menu_node *)p->menus.head;
    nnode = mnode->next;
    while (nnode) {
        struct _item_node *inode;

        if (mnode->freefunc)
            mnode->freefunc(emp, mnode->menu, mnode->data);

        /* free item activate callback data */
        inode = mnode->items;
        while (inode) {
            struct _item_node *nnode = inode->next;

            g_free(inode);
            inode = nnode;
        }

        g_free(mnode);
        mnode = nnode;
        nnode = nnode->next;
    }

    if (emp->target)
        e_popup_target_free(emp, emp->target);

    g_free(emp->menuid);

    g_free(p);

    ((GObjectClass *)ep_parent)->finalize(o);
}

static void
ep_target_free(EPopup *ep, EPopupTarget *t)
{
    g_free(t);
    g_object_unref(ep);
}

static void
ep_class_init(GObjectClass *klass)
{
    printf("EPopup class init %p '%s'\n", klass, g_type_name(((GObjectClass *)klass)->g_type_class.g_type));

    klass->finalize = ep_finalise;
    ((EPopupClass *)klass)->target_free = ep_target_free;
}

static void
ep_base_init(GObjectClass *klass)
{
    e_dlist_init(&((EPopupClass *)klass)->factories);
}

/**
 * e_popup_get_type:
 * 
 * Standard GObject type function.
 * 
 * Return value: The EPopup object type.
 **/
GType
e_popup_get_type(void)
{
    static GType type = 0;

    if (type == 0) {
        static const GTypeInfo info = {
            sizeof(EPopupClass),
            (GBaseInitFunc)ep_base_init, NULL,
            (GClassInitFunc)ep_class_init, NULL, NULL,
            sizeof(EPopup), 0,
            (GInstanceInitFunc)ep_init
        };
        ep_parent = g_type_class_ref(G_TYPE_OBJECT);
        type = g_type_register_static(G_TYPE_OBJECT, "EPopup", &info, 0);
    }

    return type;
}

/**
 * e_popup_new - Create an targetless popup menu manager.
 * @menuid: Unique ID for this menu.
 * 
 * Create a targetless popup menu object.  This can be used as a
 * helper for creating popup menu's with no target.  Such popup menu's
 * wont be very pluggable.
 * 
 * Return value: A new EPopup.
 **/
EPopup *e_popup_new(const char *menuid)
{
    EPopup *ep = g_object_new(e_popup_get_type(), NULL);

    e_popup_construct(ep, menuid);

    return ep;
}

/**
 * e_popup_construct:
 * @ep: An instantiated but uninitialised EPopup.
 * @menuid: The menu identifier.
 * 
 * Construct the base popup instance with standard parameters.
 * 
 * Return value: Returns @ep.
 **/
EPopup *e_popup_construct(EPopup *ep, const char *menuid)
{
    ep->menuid = g_strdup(menuid);

    return ep;
}

/**
 * e_popup_add_items:
 * @emp: An EPopup derived object.
 * @items: A list of EPopupItem's to add to the current popup menu.
 * @freefunc: A function which will be called when the items are no
 * longer needed.
 * @data: user-data passed to @freefunc, and passed to all activate
 * methods.
 * 
 * Add new EPopupItems to the menus.  Any with the same path
 * will override previously defined menu items, at menu building
 * time.  This may be called any number of times before the menu is
 * built to create a complex heirarchy of menus.
 **/
void
e_popup_add_items(EPopup *emp, GSList *items, EPopupItemsFunc freefunc, void *data)
{
    struct _menu_node *node;

    node = g_malloc0(sizeof(*node));
    node->menu = items;
    node->freefunc = freefunc;
    node->data = data;
    node->popup = emp;

    e_dlist_addtail(&emp->priv->menus, (EDListNode *)node);
}

static void
ep_add_static_items(EPopup *emp)
{
    struct _EPopupFactory *f;
    EPopupClass *klass = (EPopupClass *)G_OBJECT_GET_CLASS(emp);

    if (emp->menuid == NULL || emp->target == NULL)
        return;

    /* setup the menu itself */
    f = (struct _EPopupFactory *)klass->factories.head;
    while (f->next) {
        if (f->menuid == NULL
            || !strcmp(f->menuid, emp->menuid)) {
            f->factory(emp, f->factory_data);
        }
        f = f->next;
    }
}

static int
ep_cmp(const void *ap, const void *bp)
{
    struct _item_node *a = *((void **)ap);
    struct _item_node *b = *((void **)bp);

    return strcmp(a->item->path, b->item->path);
}

static void
ep_activate(GtkWidget *w, struct _item_node *inode)
{
    EPopupItem *item = inode->item;
    guint32 type = item->type & E_POPUP_TYPE_MASK;

    /* this is a bit hackish, use the item->type to transmit the
       active state, presumes we can write to this memory ...  The
       alternative is the EMenu idea of different callbacks, but
       thats painful for breaking type-safety on callbacks */

    if (type == E_POPUP_TOGGLE || type == E_POPUP_RADIO) {
        if (gtk_check_menu_item_get_active((GtkCheckMenuItem *)w))
            item->type |= E_POPUP_ACTIVE;
        else
            item->type &= ~E_POPUP_ACTIVE;
    }

    item->activate(inode->menu->popup, item, inode->menu->data);
}

/**
 * e_popup_create:
 * @emp: An EPopup derived object.
 * @target: popup target, if set, then factories will be invoked.
 * This is then owned by the menu.
 * @mask: If supplied, overrides the target specified mask or provides
 * a mask if no target is supplied.  Used to enable or show menu
 * items.
 *
 * All of the menu items registered on @emp are sorted by path, and
 * then converted into a menu heirarchy.
 *
 *
 * Return value: A GtkMenu which can be popped up when ready.
 **/
GtkMenu *
e_popup_create_menu(EPopup *emp, EPopupTarget *target, guint32 mask)
{
    struct _EPopupPrivate *p = emp->priv;
    struct _menu_node *mnode, *nnode;
    GPtrArray *items = g_ptr_array_new();
    GSList *l;
    GString *ppath = g_string_new("");
    GtkMenu *topmenu;
    GHashTable *menu_hash = g_hash_table_new(g_str_hash, g_str_equal),
        *group_hash = g_hash_table_new(g_str_hash, g_str_equal);
    int i;

    emp->target = target;
    ep_add_static_items(emp);

    if (target && mask == 0)
        mask = target->mask;

    /* FIXME: need to override old ones with new names */
    mnode = (struct _menu_node *)p->menus.head;
    nnode = mnode->next;
    while (nnode) {
        for (l=mnode->menu; l; l = l->next) {
            struct _item_node *inode = g_malloc0(sizeof(*inode));

            inode->item = l->data;
            inode->menu = mnode;
            inode->next = mnode->items;
            mnode->items = inode;

            g_ptr_array_add(items, inode);
        }
        mnode = nnode;
        nnode = nnode->next;
    }

    qsort(items->pdata, items->len, sizeof(items->pdata[0]), ep_cmp);

    topmenu = (GtkMenu *)gtk_menu_new();
    for (i=0;i<items->len;i++) {
        GtkWidget *label;
        struct _item_node *inode = items->pdata[i];
        struct _EPopupItem *item = inode->item;
        GtkMenu *thismenu;
        GtkMenuItem *menuitem;
        char *tmp;

        /* for bar's, the mask is exclusive or */
        if (item->visible) {
            if ((item->type & E_POPUP_TYPE_MASK) == E_POPUP_BAR) {
                if ((item->visible & mask) == item->visible)
                    continue;
            } else if (item->visible & mask)
                continue;
        }

        g_string_truncate(ppath, 0);
        tmp = strrchr(item->path, '/');
        if (tmp) {
            g_string_append_len(ppath, item->path, tmp-item->path);
            thismenu = g_hash_table_lookup(menu_hash, ppath->str);
            g_assert(thismenu != NULL);
        } else {
            thismenu = topmenu;
        }

        switch (item->type & E_POPUP_TYPE_MASK) {
        case E_POPUP_ITEM:
            if (item->image) {
                GdkPixbuf *pixbuf;
                GtkWidget *image;

                /* work-around e-icon-factory not doing GTK_STOCK stuff */
                if (strncmp((char *)item->image, "gtk-", 4) == 0) {
                    image = gtk_image_new_from_stock((char *)item->image, GTK_ICON_SIZE_MENU);
                } else {
                    pixbuf = e_icon_factory_get_icon((char *)item->image, E_ICON_SIZE_MENU);
                    image = gtk_image_new_from_pixbuf(pixbuf);
                    g_object_unref(pixbuf);
                }

                gtk_widget_show(image);
                menuitem = (GtkMenuItem *)gtk_image_menu_item_new();
                gtk_image_menu_item_set_image((GtkImageMenuItem *)menuitem, image);
            } else {
                menuitem = (GtkMenuItem *)gtk_menu_item_new();
            }
            break;
        case E_POPUP_TOGGLE:
            menuitem = (GtkMenuItem *)gtk_check_menu_item_new();
            gtk_check_menu_item_set_active((GtkCheckMenuItem *)menuitem, item->type & E_POPUP_ACTIVE);
            break;
        case E_POPUP_RADIO:
            menuitem = (GtkMenuItem *)gtk_radio_menu_item_new(g_hash_table_lookup(group_hash, ppath->str));
            /* FIXME: need to strdup the string */
            g_hash_table_insert(group_hash, ppath->str, gtk_radio_menu_item_get_group((GtkRadioMenuItem *)menuitem));
            gtk_check_menu_item_set_active((GtkCheckMenuItem *)menuitem, item->type & E_POPUP_ACTIVE);
            break;
        case E_POPUP_IMAGE:
            menuitem = (GtkMenuItem *)gtk_image_menu_item_new();
            gtk_image_menu_item_set_image((GtkImageMenuItem *)menuitem, item->image);
            break;
        case E_POPUP_SUBMENU: {
            GtkMenu *submenu = (GtkMenu *)gtk_menu_new();

            g_hash_table_insert(menu_hash, item->path, submenu);
            menuitem = (GtkMenuItem *)gtk_menu_item_new();
            gtk_menu_item_set_submenu(menuitem, (GtkWidget *)submenu);
            break; }
        case E_POPUP_BAR:
            /* TODO: double-bar, end-bar stuff? */
            menuitem = (GtkMenuItem *)gtk_separator_menu_item_new();
            break;
        default:
            continue;
        }

        if (item->label) {
            label = gtk_label_new_with_mnemonic(_(item->label));
            gtk_misc_set_alignment((GtkMisc *)label, 0.0, 0.5);
            gtk_widget_show(label);
            gtk_container_add((GtkContainer *)menuitem, label);
        }

        if (item->activate)
            g_signal_connect(menuitem, "activate", G_CALLBACK(ep_activate), inode);

        gtk_menu_shell_append((GtkMenuShell *)thismenu, (GtkWidget *)menuitem);

        if (item->enable & mask)
            gtk_widget_set_sensitive((GtkWidget *)menuitem, FALSE);

        gtk_widget_show((GtkWidget *)menuitem);
    }

    g_string_free(ppath, TRUE);
    g_ptr_array_free(items, TRUE);
    g_hash_table_destroy(menu_hash);
    g_hash_table_destroy(group_hash);

    return topmenu;
}

static void
ep_popup_done(GtkWidget *w, EPopup *emp)
{
    gtk_widget_destroy(w);
    if (emp->target) {
        e_popup_target_free(emp, emp->target);
        emp->target = NULL;
    }
    g_object_unref(emp);
}

/**
 * e_popup_create_menu_once:
 * @emp: EPopup, once the menu is shown, this cannot be
 * considered a valid pointer.
 * @target: If set, the target of the selection.  Static menu
 * items will be added.  The target will be freed once complete.
 * @mask: Enable/disable and visibility mask.
 * 
 * Like popup_create_menu, but automatically sets up the menu
 * so that it is destroyed once a selection takes place, and
 * the EPopup is unreffed.  This is the normal entry point as it
 * automates most memory management for popup menus.
 * 
 * Return value: A menu, to popup.
 **/
GtkMenu *
e_popup_create_menu_once(EPopup *emp, EPopupTarget *target, guint32 mask)
{
    GtkMenu *menu;

    menu = e_popup_create_menu(emp, target, mask);

    g_signal_connect(menu, "selection_done", G_CALLBACK(ep_popup_done), emp);

    return menu;
}

/* ********************************************************************** */

/**
 * e_popup_class_add_factory:
 * @klass: The EPopup derived class which you're interested in.
 * @menuid: The identifier of the menu you're interested in, or NULL
 * to be called for all menus on this class.
 * @func: The factory called when the menu @menuid is being created.
 * @data: User-data for the factory callback.
 *
 * This is a class-static method used to register factory callbacks
 * against specific menu's.
 * 
 * The factory method will be invoked before the menu is created.
 * This way, the factory may add any additional menu items it wishes
 * based on the context supplied in the @target.
 * 
 * Return value: A handle to the factory which can be used to remove
 * it later.
 **/
EPopupFactory *
e_popup_class_add_factory(EPopupClass *klass, const char *menuid, EPopupFactoryFunc func, void *data)
{
    struct _EPopupFactory *f = g_malloc0(sizeof(*f));

    f->menuid = g_strdup(menuid);
    f->factory = func;
    f->factory_data = data;
    e_dlist_addtail(&klass->factories, (EDListNode *)f);

    return f;
}

/**
 * e_popup_class_remove_factory:
 * @klass: The EPopup derived class.
 * @f: The factory handle returned by e_popup_class_add_factory().
 * 
 * Remove a popup menu factory. If it has not been added, or it has
 * already been removed, then the result is undefined (i.e. it will
 * crash).
 *
 * Generally factories are static for the life of the application, and
 * so do not need to be removed.
 **/
void
e_popup_class_remove_factory(EPopupClass *klass, EPopupFactory *f)
{
    e_dlist_remove((EDListNode *)f);
    g_free(f->menuid);
    g_free(f);
}

/**
 * e_popup_target_new:
 * @ep: An EPopup derived object.
 * @type: type, defined by the implementing class.
 * @size: The size of memory to allocate for the target.  It must be
 * equal or greater than the size of EPopupTarget.
 * 
 * Allocate a new popup target suitable for this popup type.
 **/
void *e_popup_target_new(EPopup *ep, int type, size_t size)
{
    EPopupTarget *t;

    g_assert(size >= sizeof(EPopupTarget));

    t = g_malloc0(size);
    t->popup = ep;
    g_object_ref(ep);
    t->type = type;

    return t;
}

/**
 * e_popup_target_free:
 * @ep: An EPopup derived object.
 * @o: The target, previously allocated by e_popup_target_new().
 * 
 * Free the target against @ep. Note that targets are automatically
 * freed if they are passed to the menu creation functions, so this is
 * only required if you are using the target for other purposes.
 **/
void
e_popup_target_free(EPopup *ep, void *o)
{
    EPopupTarget *t = o;

    ((EPopupClass *)G_OBJECT_GET_CLASS(ep))->target_free(ep, t);
}

/* ********************************************************************** */

/* Popup menu plugin handler */

/*
<e-plugin
  class="org.gnome.mail.plugin.popup:1.0"
  id="org.gnome.mail.plugin.popup.item:1.0"
  type="shlib"
  location="/opt/gnome2/lib/camel/1.0/libcamelimap.so"
  name="imap"
  description="IMAP4 and IMAP4v1 mail store">
  <hook class="org.gnome.mail.popupMenu:1.0"
        handler="HandlePopup">
  <menu id="any" target="select">
   <item
    type="item|toggle|radio|image|submenu|bar"
    active
    path="foo/bar"
    label="label"
    icon="foo"
    visible="select_one"
    activate="ep_view_emacs"/>
  </menu>
  </extension>

*/

static void *emph_parent_class;
#define emph ((EPopupHook *)eph)

/* must have 1:1 correspondence with e-popup types in order */
static const EPluginHookTargetKey emph_item_types[] = {
    { "item", E_POPUP_ITEM },
    { "toggle", E_POPUP_TOGGLE },
    { "radio", E_POPUP_RADIO },
    { "image", E_POPUP_IMAGE },
    { "submenu", E_POPUP_SUBMENU },
    { "bar", E_POPUP_BAR },
    { 0 }
};

static void
emph_popup_activate(EPopup *ep, EPopupItem *item, void *data)
{
    EPopupHook *hook = data;

    e_plugin_invoke(hook->hook.plugin, (char *)item->user_data, ep->target);
}

static void
emph_popup_factory(EPopup *emp, void *data)
{
    struct _EPopupHookMenu *menu = data;

    printf("popup factory called %s mask %08x\n", menu->id?menu->id:"all menus", emp->target->mask);

    /* If we're disabled, then don't add the menu's. */
    if (emp->target->type != menu->target_type
        || !menu->hook->hook.plugin->enabled)
        return;

    if (menu->items)
        e_popup_add_items(emp, menu->items, NULL, menu->hook);
}

static void
emph_free_item(struct _EPopupItem *item)
{
    g_free(item->path);
    g_free(item->label);
    g_free(item->image);
    g_free(item->user_data);
    g_free(item);
}

static void
emph_free_menu(struct _EPopupHookMenu *menu)
{
    g_slist_foreach(menu->items, (GFunc)emph_free_item, NULL);
    g_slist_free(menu->items);

    g_free(menu->id);
    g_free(menu);
}

static struct _EPopupItem *
emph_construct_item(EPluginHook *eph, EPopupHookMenu *menu, xmlNodePtr root, EPopupHookTargetMap *map)
{
    struct _EPopupItem *item;

    printf("  loading menu item\n");
    item = g_malloc0(sizeof(*item));
    if ((item->type = e_plugin_hook_id(root, emph_item_types, "type")) == -1
        || item->type == E_POPUP_IMAGE)
        goto error;
    item->path = e_plugin_xml_prop(root, "path");
    item->label = e_plugin_xml_prop_domain(root, "label", eph->plugin->domain);
    item->image = e_plugin_xml_prop(root, "icon");
    item->visible = e_plugin_hook_mask(root, map->mask_bits, "visible");
    item->enable = e_plugin_hook_mask(root, map->mask_bits, "enable");
    item->user_data = e_plugin_xml_prop(root, "activate");

    item->activate = emph_popup_activate;

    if (item->user_data == NULL)
        goto error;

    printf("   path=%s\n", item->path);
    printf("   label=%s\n", item->label);

    return item;
error:
    printf("error!\n");
    emph_free_item(item);
    return NULL;
}

static struct _EPopupHookMenu *
emph_construct_menu(EPluginHook *eph, xmlNodePtr root)
{
    struct _EPopupHookMenu *menu;
    xmlNodePtr node;
    EPopupHookTargetMap *map;
    EPopupHookClass *klass = (EPopupHookClass *)G_OBJECT_GET_CLASS(eph);
    char *tmp;

    printf(" loading menu\n");
    menu = g_malloc0(sizeof(*menu));
    menu->hook = (EPopupHook *)eph;

    tmp = xmlGetProp(root, "target");
    if (tmp == NULL)
        goto error;
    map = g_hash_table_lookup(klass->target_map, tmp);
    xmlFree(tmp);
    if (map == NULL)
        goto error;

    menu->target_type = map->id;
    menu->id = e_plugin_xml_prop(root, "id");
    node = root->children;
    while (node) {
        if (0 == strcmp(node->name, "item")) {
            struct _EPopupItem *item;

            item = emph_construct_item(eph, menu, node, map);
            if (item)
                menu->items = g_slist_append(menu->items, item);
        }
        node = node->next;
    }

    return menu;
error:
    emph_free_menu(menu);
    return NULL;
}

static int
emph_construct(EPluginHook *eph, EPlugin *ep, xmlNodePtr root)
{
    xmlNodePtr node;
    EPopupClass *klass;

    printf("loading popup hook\n");

    if (((EPluginHookClass *)emph_parent_class)->construct(eph, ep, root) == -1)
        return -1;

    klass = ((EPopupHookClass *)G_OBJECT_GET_CLASS(eph))->popup_class;

    node = root->children;
    while (node) {
        if (strcmp(node->name, "menu") == 0) {
            struct _EPopupHookMenu *menu;

            menu = emph_construct_menu(eph, node);
            if (menu) {
                e_popup_class_add_factory(klass, menu->id, emph_popup_factory, menu);
                emph->menus = g_slist_append(emph->menus, menu);
            }
        }
        node = node->next;
    }

    eph->plugin = ep;

    return 0;
}

static void
emph_finalise(GObject *o)
{
    EPluginHook *eph = (EPluginHook *)o;

    g_slist_foreach(emph->menus, (GFunc)emph_free_menu, NULL);
    g_slist_free(emph->menus);

    ((GObjectClass *)emph_parent_class)->finalize(o);
}

static void
emph_class_init(EPluginHookClass *klass)
{
    ((GObjectClass *)klass)->finalize = emph_finalise;
    klass->construct = emph_construct;

    /* this is actually an abstract implementation but list it anyway */
    klass->id = "org.gnome.evolution.popup:1.0";

    printf("EPopupHook: init class %p '%s'\n", klass, g_type_name(((GObjectClass *)klass)->g_type_class.g_type));

    ((EPopupHookClass *)klass)->target_map = g_hash_table_new(g_str_hash, g_str_equal);
    ((EPopupHookClass *)klass)->popup_class = g_type_class_ref(e_popup_get_type());
}

/**
 * e_popup_hook_get_type:
 * 
 * Standard GObject function to get the object type.  Used to subclass
 * EPopupHook.
 *
 * Return value: The type of the popup hook class.
 **/
GType
e_popup_hook_get_type(void)
{
    static GType type = 0;
    
    if (!type) {
        static const GTypeInfo info = {
            sizeof(EPopupHookClass), NULL, NULL, (GClassInitFunc) emph_class_init, NULL, NULL,
            sizeof(EPopupHook), 0, (GInstanceInitFunc) NULL,
        };

        emph_parent_class = g_type_class_ref(e_plugin_hook_get_type());
        type = g_type_register_static(e_plugin_hook_get_type(), "EPopupHook", &info, 0);
    }
    
    return type;
}

/**
 * e_popup_hook_class_add_target_map:
 * @klass: The derived EPopupHook class.
 * @map: A map used to describe a single EPopupTarget type for this
 * class.
 * 
 * Add a target map to a concrete derived class of EPopup.  The target
 * map enumerates a single target type and the enable mask bit names,
 * so that the type can be loaded automatically by the EPopup class.
 **/
void e_popup_hook_class_add_target_map(EPopupHookClass *klass, const EPopupHookTargetMap *map)
{
    g_hash_table_insert(klass->target_map, (void *)map->type, (void *)map);
}