atspi/atspi-event-listener.c

   1 /*
   2  * AT-SPI - Assistive Technology Service Provider Interface
   3  * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
   4  *
   5  * Copyright 2002 Ximian Inc.
   6  * Copyright 2002 Sun Microsystems, Inc.
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Library General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Library General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Library General Public
  19  * License along with this library; if not, write to the
  20  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  21  * Boston, MA 02111-1307, USA.
  22  */
  23
  24 #include "atspi-private.h"
  25 #include <string.h>
  26
  27 typedef struct
  28 {
  29   AtspiEventListenerCB callback;
  30   void *user_data;
  31   GDestroyNotify callback_destroyed;
  32   char *category;
  33   char *name;
  34   char *detail;
  35 } EventListenerEntry;
  36
  37 G_DEFINE_TYPE (AtspiEventListener, atspi_event_listener, G_TYPE_OBJECT)
  38
  39 void
  40 atspi_event_listener_init (AtspiEventListener *listener)
  41 {
  42 }
  43
  44 void
  45 atspi_event_listener_class_init (AtspiEventListenerClass *klass)
  46 {
  47 }
  48
  49 static void
  50 remove_datum (const AtspiEvent *event, void *user_data)
  51 {
  52   AtspiEventListenerSimpleCB cb = user_data;
  53   cb (event);
  54 }
  55
  56 typedef struct
  57 {
  58   gpointer callback;
  59   GDestroyNotify callback_destroyed;
  60   gint ref_count;
  61 } CallbackInfo;
  62 static GHashTable *callbacks;
  63
  64 void
  65 callback_ref (void *callback, GDestroyNotify callback_destroyed)
  66 {
  67   CallbackInfo *info;
  68
  69   if (!callbacks)
  70   {
  71     callbacks = g_hash_table_new (g_direct_hash, g_direct_equal);
  72     if (!callbacks)
  73       return;
  74   }
  75
  76   info = g_hash_table_lookup (callbacks, callback);
  77   if (!info)
  78   {
  79     info = g_new (CallbackInfo, 1);
  80     if (!info)
  81       return;
  82     info->callback = callback;
  83     info->callback_destroyed = callback_destroyed;
  84     info->ref_count = 1;
  85     g_hash_table_insert (callbacks, callback, info);
  86   }
  87   else
  88     info->ref_count++;
  89 }
  90
  91 void
  92 callback_unref (gpointer callback)
  93 {
  94   CallbackInfo *info;
  95
  96   if (!callbacks)
  97     return;
  98   info = g_hash_table_lookup (callbacks, callback);
  99   if (!info)
 100   {
 101     g_warning ("Atspi: Dereferencing invalid callback %p\n", callback);
 102     return;
 103   }
 104   info->ref_count--;
 105   if (info->ref_count == 0)
 106   {
 107 #if 0
 108     /* TODO: Figure out why this seg faults from Python */
 109     if (info->callback_destroyed)
 110       (*info->callback_destroyed) (info->callback);
 111 #endif
 112     g_free (info);
 113     g_hash_table_remove (callbacks, callback);
 114   }
 115 }
 116
 117 /**
 118  * atspi_event_listener_new_simple:
 119  * @callback: (scope notified): An #AtspiEventListenerSimpleCB to be called
 120  * when an event is fired.
 121  * @callback_destroyed: A #GDestroyNotify called when the listener is freed
 122  * and data associated with the callback should be freed.  Can be NULL.
 123  *
 124  * Returns: (transfer full): A new #AtspiEventListener.
 125  */
 126 AtspiEventListener *
 127 atspi_event_listener_new_simple (AtspiEventListenerSimpleCB callback,
 128                                  GDestroyNotify callback_destroyed)
 129 {
 130   AtspiEventListener *listener = g_object_new (ATSPI_TYPE_EVENT_LISTENER, NULL);
 131   listener->callback = remove_datum;
 132   callback_ref (remove_datum, callback_destroyed);
 133   listener->user_data = callback;
 134   listener->cb_destroyed = callback_destroyed;
 135   return listener;
 136 }
 137
 138 static GList *event_listeners = NULL;
 139
 140 static gchar *
 141 convert_name_from_dbus (const char *name)
 142 {
 143   gchar *ret = g_malloc (g_utf8_strlen (name, -1) * 2 + 1);
 144   const char *p = name;
 145   gchar *q = ret;
 146
 147   if (!ret)
 148     return NULL;
 149
 150   while (*p)
 151   {
 152     if (isupper (*p))
 153     {
 154       if (q > ret)
 155         *q++ = '-';
 156       *q++ = tolower (*p++);
 157     }
 158     else
 159       *q++ = *p++;
 160   }
 161   *q = '\0';
 162   return ret;
 163 }
 164
 165 static void
 166 cache_process_children_changed (AtspiEvent *event)
 167 {
 168   AtspiAccessible *child;
 169
 170   if (!G_VALUE_HOLDS (&event->any_data, ATSPI_TYPE_ACCESSIBLE) ||
 171       !event->source->children ||
 172       atspi_state_set_contains (event->source->states, ATSPI_STATE_MANAGES_DESCENDANTS))
 173     return;
 174
 175   child = g_value_get_object (&event->any_data);
 176
 177   if (!strncmp (event->type, "object:children-changed:add", 27))
 178   {
 179     if (g_list_find (event->source->children, child))
 180       return;
 181     GList *new_list = g_list_insert (event->source->children, g_object_ref (child), event->detail1);
 182     if (new_list)
 183       event->source->children = new_list;
 184   }
 185   else if (g_list_find (event->source->children, child))
 186   {
 187     event->source->children = g_list_remove (event->source->children, child);
 188     if (child == child->parent.app->root)
 189       g_object_run_dispose (child->parent.app);
 190     g_object_unref (child);
 191   }
 192 }
 193
 194 static void
 195 cache_process_property_change (AtspiEvent *event)
 196 {
 197   if (!strcmp (event->type, "object:property-change:accessible-parent"))
 198   {
 199     if (event->source->accessible_parent)
 200       g_object_unref (event->source->accessible_parent);
 201     if (G_VALUE_HOLDS (&event->any_data, ATSPI_TYPE_ACCESSIBLE))
 202     {
 203       event->source->accessible_parent = g_value_dup_object (&event->any_data);
 204       event->source->cached_properties |= ATSPI_CACHE_PARENT;
 205     }
 206     else
 207     {
 208       event->source->accessible_parent = NULL;
 209       event->source->cached_properties &= ~ATSPI_CACHE_PARENT;
 210     }
 211   }
 212   else if (!strcmp (event->type, "object:property-change:accessible-name"))
 213   {
 214     if (event->source->name)
 215       g_free (event->source->name);
 216     if (G_VALUE_HOLDS_STRING (&event->any_data))
 217     {
 218       event->source->name = g_value_dup_string (&event->any_data);
 219       event->source->cached_properties |= ATSPI_CACHE_NAME;
 220     }
 221     else
 222     {
 223       event->source->name = NULL;
 224       event->source->cached_properties &= ~ATSPI_CACHE_NAME;
 225     }
 226   }
 227   else if (!strcmp (event->type, "object:property-change:accessible-description"))
 228   {
 229     if (event->source->description)
 230       g_free (event->source->description);
 231     if (G_VALUE_HOLDS_STRING (&event->any_data))
 232     {
 233       event->source->description = g_value_dup_string (&event->any_data);
 234       event->source->cached_properties |= ATSPI_CACHE_DESCRIPTION;
 235     }
 236     else
 237     {
 238       event->source->description = NULL;
 239       event->source->cached_properties &= ~ATSPI_CACHE_DESCRIPTION;
 240     }
 241   }
 242 }
 243
 244 static void
 245 cache_process_state_changed (AtspiEvent *event)
 246 {
 247   if (event->source->states)
 248     atspi_state_set_set_by_name (event->source->states, event->type + 21,
 249                                  event->detail1);
 250 }
 251
 252 static dbus_bool_t
 253 demarshal_rect (DBusMessageIter *iter, AtspiRect *rect)
 254 {
 255   dbus_int32_t x, y, width, height;
 256   DBusMessageIter iter_struct;
 257
 258   dbus_message_iter_recurse (iter, &iter_struct);
 259   if (dbus_message_iter_get_arg_type (&iter_struct) != DBUS_TYPE_INT32) return FALSE;
 260   dbus_message_iter_get_basic (&iter_struct, &x);
 261   dbus_message_iter_next (&iter_struct);
 262   if (dbus_message_iter_get_arg_type (&iter_struct) != DBUS_TYPE_INT32) return FALSE;
 263   dbus_message_iter_get_basic (&iter_struct, &y);
 264   dbus_message_iter_next (&iter_struct);
 265   if (dbus_message_iter_get_arg_type (&iter_struct) != DBUS_TYPE_INT32) return FALSE;
 266   dbus_message_iter_get_basic (&iter_struct, &width);
 267   dbus_message_iter_next (&iter_struct);
 268   if (dbus_message_iter_get_arg_type (&iter_struct) != DBUS_TYPE_INT32) return FALSE;
 269   dbus_message_iter_get_basic (&iter_struct, &height);
 270   rect->x = x;
 271   rect->y = y;
 272   rect->width = width;
 273   rect->height = height;
 274   return TRUE;
 275 }
 276
 277 static gchar *
 278 strdup_and_adjust_for_dbus (const char *s)
 279 {
 280   gchar *d = g_strdup (s);
 281   gchar *p;
 282   int parts = 0;
 283
 284   if (!d)
 285     return NULL;
 286
 287   for (p = d; *p; p++)
 288   {
 289     if (*p == '-')
 290     {
 291       memmove (p, p + 1, g_utf8_strlen (p, -1));
 292       *p = toupper (*p);
 293     }
 294     else if (*p == ':')
 295     {
 296       parts++;
 297       if (parts == 2)
 298         break;
 299       p [1] = toupper (p [1]);
 300     }
 301   }
 302
 303   d [0] = toupper (d [0]);
 304   return d;
 305 }
 306
 307 static gboolean
 308 convert_event_type_to_dbus (const char *eventType, char **categoryp, char **namep, char **detailp, char **matchrule)
 309 {
 310   gchar *tmp = strdup_and_adjust_for_dbus (eventType);
 311   char *category = NULL, *name = NULL, *detail = NULL;
 312   char *saveptr = NULL;
 313   char *p;
 314
 315   if (tmp == NULL) return FALSE;
 316   category = strtok_r (tmp, ":", &saveptr);
 317   if (category) category = g_strdup (category);
 318   if (!category) goto oom;
 319   name = strtok_r (NULL, ":", &saveptr);
 320   if (name)
 321   {
 322     name = g_strdup (name);
 323     if (!name) goto oom;
 324     detail = strtok_r (NULL, ":", &saveptr);
 325     if (detail) detail = g_strdup (detail);
 326   }
 327   if (matchrule)
 328   {
 329     *matchrule = g_strdup_printf ("type='signal',interface='org.a11y.atspi.Event.%s'", category);
 330     if (!*matchrule) goto oom;
 331     if (name && name [0])
 332     {
 333       gchar *new_str = g_strconcat (*matchrule, ",member='", name, "'", NULL);
 334       if (new_str)
 335       {
 336         g_free (*matchrule);
 337         *matchrule = new_str;
 338       }
 339     }
 340     if (detail && detail [0])
 341     {
 342       gchar *new_str = g_strconcat (*matchrule, ",arg0='", detail, "'", NULL);
 343       if (new_str)
 344       {
 345         g_free (*matchrule);
 346         *matchrule = new_str;
 347       }
 348     }
 349   }
 350   if (categoryp) *categoryp = category;
 351   else g_free (category);
 352   if (namep) *namep = name;
 353   else if (name) g_free (name);
 354   if (detailp) *detailp = detail;
 355   else if (detail) g_free (detail);
 356   g_free (tmp);
 357   return TRUE;
 358 oom:
 359   if (tmp) g_free (tmp);
 360   if (category) g_free (category);
 361   if (name) g_free (name);
 362   if (detail) g_free (detail);
 363   return FALSE;
 364 }
 365
 366 static void
 367 listener_entry_free (EventListenerEntry *e)
 368 {
 369   gpointer callback = (e->callback = remove_datum ? e->user_data : e->callback);
 370   g_free (e->category);
 371   g_free (e->name);
 372   if (e->detail) g_free (e->detail);
 373   callback_unref (callback);
 374   g_free (e);
 375 }
 376
 377 /**
 378  * atspi_event_listener_register:
 379  * @listener: The #AtspiEventListener to register against an event type.
 380  * @event_type: a character string indicating the type of events for which
 381  *            notification is requested.  Format is
 382  *            EventClass:major_type:minor_type:detail
 383  *            where all subfields other than EventClass are optional.
 384  *            EventClasses include "object", "window", "mouse",
 385  *            and toolkit events (e.g. "Gtk", "AWT").
 386  *            Examples: "focus:", "Gtk:GtkWidget:button_press_event".
 387  *
 388  * Legal object event types:
 389  *
 390  *    (property change events)
 391  *
 392  *            object:property-change
 393  *            object:property-change:accessible-name
 394  *            object:property-change:accessible-description
 395  *            object:property-change:accessible-parent
 396  *            object:property-change:accessible-value
 397  *            object:property-change:accessible-role
 398  *            object:property-change:accessible-table-caption
 399  *            object:property-change:accessible-table-column-description
 400  *            object:property-change:accessible-table-column-header
 401  *            object:property-change:accessible-table-row-description
 402  *            object:property-change:accessible-table-row-header
 403  *            object:property-change:accessible-table-summary
 404  *
 405  *    (other object events)
 406  *
 407  *            object:state-changed
 408  *            object:children-changed
 409  *            object:visible-data-changed
 410  *            object:selection-changed
 411  *            object:text-selection-changed
 412  *            object:text-changed
 413  *            object:text-caret-moved
 414  *            object:row-inserted
 415  *            object:row-reordered
 416  *            object:row-deleted
 417  *            object:column-inserted
 418  *            object:column-reordered
 419  *            object:column-deleted
 420  *            object:model-changed
 421  *            object:active-descendant-changed
 422  *
 423  *  (window events)
 424  *
 425  *            window:minimize
 426  *            window:maximize
 427  *            window:restore
 428  *            window:close
 429  *            window:create
 430  *            window:reparent
 431  *            window:desktop-create
 432  *            window:desktop-destroy
 433  *            window:activate
 434  *            window:deactivate
 435  *            window:raise
 436  *            window:lower
 437  *            window:move
 438  *            window:resize
 439  *            window:shade
 440  *            window:unshade
 441  *            window:restyle
 442  *
 443  *  (other events)
 444  *
 445  *            focus:
 446  *            mouse:abs
 447  *            mouse:rel
 448  *            mouse:b1p
 449  *            mouse:b1r
 450  *            mouse:b2p
 451  *            mouse:b2r
 452  *            mouse:b3p
 453  *            mouse:b3r
 454  *
 455  * NOTE: this string may be UTF-8, but should not contain byte value 56
 456  *            (ascii ':'), except as a delimiter, since non-UTF-8 string
 457  *            delimiting functions are used internally.
 458  *            In general, listening to
 459  *            toolkit-specific events is not recommended.
 460  *
 461  * Add an in-process callback function to an existing AtspiEventListener.
 462  *
 463  * Returns: #TRUE if successful, otherwise #FALSE.
 464  **/
 465 gboolean
 466 atspi_event_listener_register (AtspiEventListener *listener,
 467                                              const gchar              *event_type)
 468 {
 469   /* TODO: Keep track of which events have been registered, so that we
 470  * deregister all of them when the event listener is destroyed */
 471
 472   return atspi_event_listener_register_from_callback (listener->callback,
 473                                                       listener->user_data,
 474                                                       listener->cb_destroyed,
 475                                                       event_type);
 476 }
 477
 478 /**
 479  * atspi_event_listener_register_from_callback:
 480  * @callback: (scope notified): the #AtspiEventListenerCB to be registered against
 481  *            an event type.
 482  * @user_data: (closure): User data to be passed to the callback.
 483  * @callback_destroyed: A #GDestroyNotify called when the callback is destroyed.
 484  * @event_type: a character string indicating the type of events for which
 485  *            notification is requested.  See #atspi_event_listener_register
 486  * for a description of the format.
 487  */
 488 gboolean
 489 atspi_event_listener_register_from_callback (AtspiEventListenerCB callback,
 490                                              void *user_data,
 491                                              GDestroyNotify callback_destroyed,
 492                                              const gchar              *event_type)
 493 {
 494   EventListenerEntry *e;
 495   char *matchrule;
 496   DBusError error;
 497   GList *new_list;
 498   DBusMessage *message, *reply;
 499
 500   if (!callback)
 501     {
 502       return FALSE;
 503     }
 504
 505   e = g_new (EventListenerEntry, 1);
 506   if (!e) return FALSE;
 507   e->callback = callback;
 508   e->user_data = user_data;
 509   e->callback_destroyed = callback_destroyed;
 510   callback_ref (callback == remove_datum ? user_data : callback,
 511                 callback_destroyed);
 512   if (!convert_event_type_to_dbus (event_type, &e->category, &e->name, &e->detail, &matchrule))
 513   {
 514     g_free (e);
 515     return FALSE;
 516   }
 517   new_list = g_list_prepend (event_listeners, e);
 518   if (!new_list)
 519   {
 520     listener_entry_free (e);
 521     return FALSE;
 522   }
 523   event_listeners = new_list;
 524   dbus_error_init (&error);
 525   dbus_bus_add_match (_atspi_bus(), matchrule, &error);
 526   if (error.message)
 527   {
 528     g_warning ("Atspi: Adding match: %s", error.message);
 529   }
 530
 531   dbus_error_init (&error);
 532   message = dbus_message_new_method_call (atspi_bus_registry,
 533         atspi_path_registry,
 534         atspi_interface_registry,
 535         "RegisterEvent");
 536   if (!message)
 537     return;
 538   dbus_message_append_args (message, DBUS_TYPE_STRING, &event_type, DBUS_TYPE_INVALID);
 539   reply = _atspi_dbus_send_with_reply_and_block (message);
 540   if (reply)
 541     dbus_message_unref (reply);
 542
 543   return TRUE;
 544 }
 545
 546 /**
 547  * atspi_event_listener_register_no_data:
 548  * @callback: (scope notified): the #AtspiEventListenerSimpleCB to be
 549  *            registered against an event type.
 550  * @callback_destroyed: A #GDestroyNotify called when the callback is destroyed.
 551  * @event_type: a character string indicating the type of events for which
 552  *            notification is requested.  Format is
 553  *            EventClass:major_type:minor_type:detail
 554  *            where all subfields other than EventClass are optional.
 555  *            EventClasses include "object", "window", "mouse",
 556  *            and toolkit events (e.g. "Gtk", "AWT").
 557  *            Examples: "focus:", "Gtk:GtkWidget:button_press_event".
 558  *
 559  * Like atspi_event_listener_register, but callback takes no user_data.
 560  **/
 561 gboolean
 562 atspi_event_listener_register_no_data (AtspiEventListenerSimpleCB callback,
 563                                  GDestroyNotify callback_destroyed,
 564                                  const gchar              *event_type)
 565 {
 566   return atspi_event_listener_register_from_callback (remove_datum, callback, callback_destroyed, event_type);
 567 }
 568
 569 static gboolean
 570 is_superset (const gchar *super, const gchar *sub)
 571 {
 572   if (!super || !super [0])
 573     return TRUE;
 574   return (strcmp (super, sub) == 0);
 575 }
 576
 577 /**
 578  * atspi_event_listener_deregister:
 579  * @listener: The #AtspiEventListener to deregister.
 580  * @event_type: a string specifying the event type for which this
 581  *             listener is to be deregistered.
 582  *
 583  * deregisters an #AtspiEventListener from the registry, for a specific
 584  *             event type.
 585  *
 586  * Returns: #TRUE if successful, otherwise #FALSE.
 587  **/
 588 gboolean
 589 atspi_event_listener_deregister (AtspiEventListener *listener,
 590                                                const gchar              *event_type)
 591 {
 592   atspi_event_listener_deregister_from_callback (listener->callback, listener->user_data, event_type);
 593 }
 594
 595 /**
 596  * atspi_event_listener_deregister_from_callback:
 597  * @callback: (scope call): the #AtspiEventListenerCB registered against an
 598  *            event type.
 599  * @user_data: (closure): User data that was passed in for this callback.
 600  * @event_type: a string specifying the event type for which this
 601  *             listener is to be deregistered.
 602  *
 603  * deregisters an #AtspiEventListenerCB from the registry, for a specific
 604  *             event type.
 605  *
 606  * Returns: #TRUE if successful, otherwise #FALSE.
 607  **/
 608 gboolean
 609 atspi_event_listener_deregister_from_callback (AtspiEventListenerCB callback,
 610                                                void *user_data,
 611                                                const gchar              *event_type)
 612 {
 613   char *category, *name, *detail, *matchrule;
 614   GList *l;
 615
 616   if (!convert_event_type_to_dbus (event_type, &category, &name, &detail, &matchrule))
 617   {
 618     return FALSE;
 619   }
 620   if (!callback)
 621     {
 622       return FALSE;
 623     }
 624
 625   for (l = event_listeners; l;)
 626   {
 627     EventListenerEntry *e = l->data;
 628     if (e->callback == callback &&
 629         e->user_data == user_data &&
 630         is_superset (category, e->category) &&
 631         is_superset (name, e->name) &&
 632         is_superset (detail, e->detail))
 633     {
 634       gboolean need_replace;
 635       DBusError error;
 636       DBusMessage *message, *reply;
 637       need_replace = (l == event_listeners);
 638       l = g_list_remove (l, e);
 639       if (need_replace)
 640         event_listeners = l;
 641       dbus_error_init (&error);
 642       dbus_bus_remove_match (_atspi_bus(), matchrule, &error);
 643       dbus_error_init (&error);
 644       message = dbus_message_new_method_call (atspi_bus_registry,
 645             atspi_path_registry,
 646             atspi_interface_registry,
 647             "RegisterEvent");
 648       if (!message)
 649       return;
 650       dbus_message_append_args (message, DBUS_TYPE_STRING, &event_type, DBUS_TYPE_INVALID);
 651       reply = _atspi_dbus_send_with_reply_and_block (message);
 652       dbus_message_unref (reply);
 653
 654       listener_entry_free (e);
 655     }
 656     else l = g_list_next (l);
 657   }
 658   g_free (category);
 659   g_free (name);
 660   if (detail) g_free (detail);
 661   g_free (matchrule);
 662   return TRUE;
 663 }
 664
 665 /**
 666  * atspi_event_listener_deregister_no_data:
 667  * @callback: (scope call): the #AtspiEventListenerSimpleCB registered against
 668  *            an event type.
 669  * @event_type: a string specifying the event type for which this
 670  *             listener is to be deregistered.
 671  *
 672  * deregisters an #AtspiEventListenerSimpleCB from the registry, for a specific
 673  *             event type.
 674  *
 675  * Returns: #TRUE if successful, otherwise #FALSE.
 676  **/
 677 gboolean
 678 atspi_event_listener_deregister_no_data (AtspiEventListenerSimpleCB callback,
 679                                    const gchar              *event_type)
 680 {
 681   return atspi_event_listener_deregister_from_callback (remove_datum, callback,
 682                                                         event_type);
 683 }
 684
 685 static AtspiEvent *
 686 atspi_event_copy (AtspiEvent *src)
 687 {
 688   AtspiEvent *dst = g_new0 (AtspiEvent, 1);
 689   dst->type = g_strdup (src->type);
 690   dst->source = g_object_ref (src->source);
 691   dst->detail1 = src->detail1;
 692   dst->detail2 = src->detail2;
 693   g_value_init (&dst->any_data, G_VALUE_TYPE (&src->any_data));
 694   g_value_copy (&src->any_data, &dst->any_data);
 695   return dst;
 696 }
 697
 698 static void
 699 atspi_event_free (AtspiEvent *event)
 700 {
 701   g_object_unref (event->source);
 702   g_free (event->type);
 703   g_value_unset (&event->any_data);
 704   g_free (event);
 705 }
 706
 707 void
 708 _atspi_send_event (AtspiEvent *e)
 709 {
 710   char *category, *name, *detail;
 711   GList *l;
 712
 713   /* Ensure that the value is set to avoid a Python exception */
 714   /* TODO: Figure out how to do this without using a private field */
 715   if (e->any_data.g_type == 0)
 716   {
 717     g_value_init (&e->any_data, G_TYPE_INT);
 718     g_value_set_int (&e->any_data, 0);
 719   }
 720
 721   if (!convert_event_type_to_dbus (e->type, &category, &name, &detail, NULL))
 722   {
 723     g_warning ("Atspi: Couldn't parse event: %s\n", e->type);
 724     return;
 725   }
 726   for (l = event_listeners; l; l = g_list_next (l))
 727   {
 728     EventListenerEntry *entry = l->data;
 729     if (!strcmp (category, entry->category) &&
 730         (entry->name == NULL || !strcmp (name, entry->name)) &&
 731         (entry->detail == NULL || !strcmp (detail, entry->detail)))
 732     {
 733         entry->callback (atspi_event_copy (e), entry->user_data);
 734     }
 735   }
 736   if (detail) g_free (detail);
 737   g_free (name);
 738   g_free (category);
 739 }
 740
 741 DBusHandlerResult
 742 atspi_dbus_handle_event (DBusConnection *bus, DBusMessage *message, void *data)
 743 {
 744   char *detail = NULL;
 745   const char *category = dbus_message_get_interface (message);
 746   const char *member = dbus_message_get_member (message);
 747   const char *signature = dbus_message_get_signature (message);
 748   gchar *name;
 749   gchar *converted_type;
 750   DBusMessageIter iter, iter_variant;
 751   dbus_message_iter_init (message, &iter);
 752   AtspiEvent e;
 753   dbus_int32_t detail1, detail2;
 754   char *p;
 755
 756   if (strcmp (signature, "siiv(so)") != 0)
 757   {
 758     g_warning (_("Got invalid signature %s for signal %s from interface %s\n"), signature, member, category);
 759     return;
 760   }
 761
 762   memset (&e, 0, sizeof (e));
 763
 764   if (category)
 765   {
 766     category = g_utf8_strrchr (category, -1, '.');
 767     if (category == NULL)
 768     {
 769       // TODO: Error
 770       return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
 771     }
 772     category++;
 773   }
 774   dbus_message_iter_get_basic (&iter, &detail);
 775   dbus_message_iter_next (&iter);
 776   dbus_message_iter_get_basic (&iter, &detail1);
 777   e.detail1 = detail1;
 778   dbus_message_iter_next (&iter);
 779   dbus_message_iter_get_basic (&iter, &detail2);
 780   e.detail2 = detail2;
 781   dbus_message_iter_next (&iter);
 782
 783   converted_type = convert_name_from_dbus (category);
 784   name = convert_name_from_dbus (member);
 785   detail = convert_name_from_dbus (detail);
 786
 787   if (strcasecmp  (category, name) != 0)
 788   {
 789     p = g_strconcat (converted_type, ":", name, NULL);
 790     if (p)
 791     {
 792       g_free (converted_type);
 793       converted_type = p;
 794     }
 795   }
 796   else if (detail [0] == '\0')
 797   {
 798     p = g_strconcat (converted_type, ":",  NULL);
 799     if (p)
 800     {
 801       g_free (converted_type);
 802       converted_type = p;
 803     }
 804   }
 805
 806   if (detail[0] != '\0')
 807   {
 808     p = g_strconcat (converted_type, ":", detail, NULL);
 809     if (p)
 810     {
 811       g_free (converted_type);
 812       converted_type = p;
 813     }
 814   }
 815   e.type = converted_type;
 816   e.source = _atspi_ref_accessible (dbus_message_get_sender(message), dbus_message_get_path(message));
 817
 818   dbus_message_iter_recurse (&iter, &iter_variant);
 819   switch (dbus_message_iter_get_arg_type (&iter_variant))
 820   {
 821     case DBUS_TYPE_STRUCT:
 822     {
 823       AtspiRect rect;
 824       if (demarshal_rect (&iter_variant, &rect))
 825       {
 826         g_value_init (&e.any_data, ATSPI_TYPE_RECT);
 827         g_value_set_boxed (&e.any_data, &rect);
 828       }
 829       else
 830       {
 831         AtspiAccessible *accessible;
 832         accessible = _atspi_dbus_return_accessible_from_iter (&iter_variant);
 833         g_value_init (&e.any_data, ATSPI_TYPE_ACCESSIBLE);
 834         g_value_set_instance (&e.any_data, accessible);
 835         g_object_unref (accessible);    /* value now owns it */
 836       }
 837       break;
 838     }
 839     case DBUS_TYPE_STRING:
 840     {
 841       dbus_message_iter_get_basic (&iter_variant, &p);
 842       g_value_init (&e.any_data, G_TYPE_STRING);
 843       g_value_set_string (&e.any_data, p);
 844       break;
 845     }
 846   default:
 847     break;
 848   }
 849
 850   if (!strncmp (e.type, "object:children-changed", 23))
 851   {
 852     cache_process_children_changed (&e);
 853   }
 854   else if (!strncmp (e.type, "object:property-change", 22))
 855   {
 856     cache_process_property_change (&e);
 857   }
 858   else if (!strncmp (e.type, "object:state-changed", 20))
 859   {
 860     cache_process_state_changed (&e);
 861   }
 862
 863   _atspi_send_event (&e);
 864
 865   g_free (converted_type);
 866   g_free (name);
 867   g_free (detail);
 868   g_object_unref (e.source);
 869   g_value_unset (&e.any_data);
 870   return DBUS_HANDLER_RESULT_HANDLED;
 871 }
 872
 873 G_DEFINE_BOXED_TYPE (AtspiEvent, atspi_event, atspi_event_copy, atspi_event_free)