2 * AT-SPI - Assistive Technology Service Provider Interface
3 * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
5 * Copyright 2008, 2009, Codethink Ltd.
6 * Copyright 2001, 2002, 2003 Sun Microsystems Inc.,
7 * Copyright 2001, 2002, 2003 Ximian, Inc.
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Library General Public
11 * License as published by the Free Software Foundation; either
12 * version 2 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Library General Public License for more details.
19 * You should have received a copy of the GNU Library General Public
20 * License along with this library; if not, write to the
21 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 * Boston, MA 02111-1307, USA.
28 #include <droute/droute.h>
31 #include "accessible-register.h"
33 #include "spi-common/spi-dbus.h"
35 static GArray *listener_ids = NULL;
37 static gint atk_bridge_key_event_listener_id;
38 static gint atk_bridge_focus_tracker_id;
40 /*---------------------------------------------------------------------------*/
42 #define ITF_EVENT_OBJECT "org.freedesktop.atspi.Event.Object"
43 #define ITF_EVENT_WINDOW "org.freedesktop.atspi.Event.Window"
44 #define ITF_EVENT_DOCUMENT "org.freedekstop.atspi.Event.Document"
45 #define ITF_EVENT_FOCUS "org.freedesktop.atspi.Event.Focus"
47 /*---------------------------------------------------------------------------*/
49 /* When sending events it is safe to register an accessible object if
50 * one does not already exist for a given AtkObject.
51 * This is because the cache update signal should then be send before
52 * the event signal is sent.
55 get_object_path (AtkObject *accessible)
59 return atk_dbus_ref_to_path (ref);
62 /*---------------------------------------------------------------------------*/
65 Accessibility_DeviceEventController_notifyListenersSync(const Accessibility_DeviceEvent *key_event)
69 dbus_bool_t consumed = FALSE;
72 dbus_message_new_method_call(SPI_DBUS_NAME_REGISTRY,
73 SPI_DBUS_PATH_REGISTRY,
74 SPI_DBUS_INTERFACE_DEC,
75 "notifyListenersSync");
77 dbus_error_init(&error);
78 if (spi_dbus_marshal_deviceEvent(message, key_event))
80 DBusMessage *reply = dbus_connection_send_with_reply_and_block(atk_adaptor_app_data->bus, message, 1000, &error);
84 dbus_error_init(&error);
85 dbus_message_get_args(reply, &error, DBUS_TYPE_BOOLEAN, &consumed, DBUS_TYPE_INVALID);
86 dbus_message_unref(reply);
89 dbus_message_unref(message);
94 spi_init_keystroke_from_atk_key_event (Accessibility_DeviceEvent *keystroke,
95 AtkKeyEventStruct *event)
97 keystroke->id = (dbus_int32_t) event->keyval;
98 keystroke->hw_code = (dbus_int16_t) event->keycode;
99 keystroke->timestamp = (dbus_uint32_t) event->timestamp;
100 keystroke->modifiers = (dbus_uint16_t) (event->state & 0xFFFF);
105 keystroke->event_string = g_strdup (event->string);
106 c = g_utf8_get_char_validated (event->string, -1);
107 if (c > 0 && g_unichar_isprint (c))
108 keystroke->is_text = TRUE;
110 keystroke->is_text = FALSE;
114 keystroke->event_string = g_strdup ("");
115 keystroke->is_text = FALSE;
119 case (ATK_KEY_EVENT_PRESS):
120 keystroke->type = Accessibility_KEY_PRESSED_EVENT;
122 case (ATK_KEY_EVENT_RELEASE):
123 keystroke->type = Accessibility_KEY_RELEASED_EVENT;
130 g_print ("key_event type %d; val=%d code=%d modifiers=%x name=%s is_text=%d, time=%lx\n",
131 (int) keystroke->type, (int) keystroke->id, (int) keystroke->hw_code,
132 (int) keystroke->modifiers,
133 keystroke->event_string, (int) keystroke->is_text, (unsigned long) keystroke->timestamp);
139 spi_atk_bridge_key_listener (AtkKeyEventStruct *event, gpointer data)
142 Accessibility_DeviceEvent key_event;
144 spi_init_keystroke_from_atk_key_event (&key_event, event);
146 result = Accessibility_DeviceEventController_notifyListenersSync (&key_event);
148 if (key_event.event_string) g_free (key_event.event_string);
154 /*---------------------------------------------------------------------------*/
157 * Emits an AT-SPI event.
158 * AT-SPI events names are split into three parts:
160 * This is mapped onto D-Bus events as:
161 * D-Bus Interface:Signal Name:Detail argument
163 * Marshals a basic type into the 'any_data' attribute of
168 * This is a rather annoying function needed to replace
169 * NULL values of strings with the empty string. Null string
170 * values can be created by the atk_object_get_name or text selection
173 provide_defaults(const gint type,
178 case DBUS_TYPE_STRING:
179 case DBUS_TYPE_OBJECT_PATH:
190 emit(AtkObject *accessible,
194 dbus_int32_t detail1,
195 dbus_int32_t detail2,
200 DBusMessageIter iter, sub;
201 gchar *path, *cname, *t;
203 path = get_object_path (accessible);
205 /* Tough decision here
206 * We won't send events from accessible
207 * objects that have not yet been added to the accessible tree.
212 if (!klass) klass = "";
213 if (!major) major = "";
214 if (!minor) minor = "";
217 * This is very annoying, but as '-' isn't a legal signal
218 * name in D-Bus (Why not??!?) The names need converting
219 * on this side, and again on the client side.
221 cname = g_strdup(major);
222 while ((t = strchr(cname, '-')) != NULL) *t = '_';
224 sig = dbus_message_new_signal(path, klass, cname);
228 dbus_message_iter_init_append(sig, &iter);
230 dbus_message_iter_append_basic(&iter, DBUS_TYPE_STRING, &minor);
231 dbus_message_iter_append_basic(&iter, DBUS_TYPE_INT32, &detail1);
232 dbus_message_iter_append_basic(&iter, DBUS_TYPE_INT32, &detail2);
234 dbus_message_iter_open_container(&iter, DBUS_TYPE_VARIANT, type, &sub);
236 * I need to convert the string signature to an integer type signature.
237 * DBUS_TYPE_INT32 is defined as 'i' whereas the string is "i".
238 * I should just be able to cast the first character of the string to an
241 val = provide_defaults((int) *type, val);
242 dbus_message_iter_append_basic(&sub, (int) *type, &val);
243 dbus_message_iter_close_container(&iter, &sub);
245 dbus_connection_send(atk_adaptor_app_data->bus, sig, NULL);
246 dbus_message_unref(sig);
249 /*---------------------------------------------------------------------------*/
252 * Emits an AT-SPI event, marshalling a BoundingBox structure into the
253 * 'any_data' variant of the event.
256 emit_rect(AtkObject *accessible,
263 DBusMessageIter iter, variant, sub;
264 gchar *path, *cname, *t;
265 dbus_int32_t dummy = 0;
267 path = get_object_path (accessible);
269 /* Tough decision here
270 * We won't send events from accessible
271 * objects that have not yet been added to the accessible tree.
276 if (!klass) klass = "";
277 if (!major) major = "";
278 if (!minor) minor = "";
281 * This is very annoying, but as '-' isn't a legal signal
282 * name in D-Bus (Why not??!?) The names need converting
283 * on this side, and again on the client side.
285 cname = g_strdup(major);
286 while ((t = strchr(cname, '-')) != NULL) *t = '_';
288 sig = dbus_message_new_signal(path, klass, cname);
292 dbus_message_iter_init_append (sig, &iter);
293 dbus_message_iter_append_basic(&iter, DBUS_TYPE_STRING, &minor);
294 dbus_message_iter_append_basic (&iter, DBUS_TYPE_INT32, &dummy);
295 dbus_message_iter_append_basic (&iter, DBUS_TYPE_INT32, &dummy);
297 dbus_message_iter_open_container (&iter, DBUS_TYPE_VARIANT, "(iiii)", &variant);
298 dbus_message_iter_open_container (&variant, DBUS_TYPE_STRUCT, NULL, &sub);
299 dbus_message_iter_append_basic (&sub, DBUS_TYPE_INT32, &(rect->x));
300 dbus_message_iter_append_basic (&sub, DBUS_TYPE_INT32, &(rect->y));
301 dbus_message_iter_append_basic (&sub, DBUS_TYPE_INT32, &(rect->width));
302 dbus_message_iter_append_basic (&sub, DBUS_TYPE_INT32, &(rect->height));
303 dbus_message_iter_close_container (&variant, &sub);
304 dbus_message_iter_close_container (&iter, &variant);
306 dbus_connection_send(atk_adaptor_app_data->bus, sig, NULL);
309 /*---------------------------------------------------------------------------*/
312 * The focus listener handles the ATK 'focus' signal and forwards it
313 * as the AT-SPI event, 'focus:'
316 focus_tracker (AtkObject *accessible)
318 emit(accessible, ITF_EVENT_FOCUS, "focus", "", 0, 0, DBUS_TYPE_INT32_AS_STRING, 0);
321 /*---------------------------------------------------------------------------*/
323 #define PCHANGE "property-change"
326 * This handler handles the following ATK signals and
327 * converts them to AT-SPI events:
329 * Gtk:AtkObject:property-change -> object:property-change:(property-name)
331 * The property-name is part of the ATK property-change signal.
334 property_event_listener (GSignalInvocationHint *signal_hint,
335 guint n_param_values,
336 const GValue *param_values,
339 AtkObject *accessible;
340 AtkPropertyValues *values;
342 const gchar *pname = NULL;
348 accessible = g_value_get_object (¶m_values[0]);
349 values = (AtkPropertyValues*) g_value_get_pointer (¶m_values[1]);
351 pname = values[0].property_name;
353 /* TODO Could improve this control statement by matching
354 * on only the end of the signal names,
356 if (strcmp (pname, "accessible-table-summary") == 0)
358 otemp = atk_table_get_summary(ATK_TABLE (accessible));
359 stemp = get_object_path (otemp);
360 emit(accessible, ITF_EVENT_OBJECT, PCHANGE, pname, 0, 0, DBUS_TYPE_OBJECT_PATH_AS_STRING, stemp);
362 else if (strcmp (pname, "accessible-table-column-header") == 0)
364 i = g_value_get_int (&(values->new_value));
365 otemp = atk_table_get_column_header(ATK_TABLE (accessible), i);
366 stemp = get_object_path (otemp);
367 emit(accessible, ITF_EVENT_OBJECT, PCHANGE, pname, 0, 0, DBUS_TYPE_OBJECT_PATH_AS_STRING, stemp);
369 else if (strcmp (pname, "accessible-table-row-header") == 0)
371 i = g_value_get_int (&(values->new_value));
372 otemp = atk_table_get_row_header(ATK_TABLE (accessible), i);
373 stemp = get_object_path (otemp);
374 emit(accessible, ITF_EVENT_OBJECT, PCHANGE, pname, 0, 0, DBUS_TYPE_OBJECT_PATH_AS_STRING, stemp);
376 else if (strcmp (pname, "accessible-table-row-description") == 0)
378 i = g_value_get_int (&(values->new_value));
379 stemp = atk_table_get_row_description(ATK_TABLE (accessible), i);
380 emit(accessible, ITF_EVENT_OBJECT, PCHANGE, pname, 0, 0, DBUS_TYPE_STRING_AS_STRING, stemp);
382 else if (strcmp (pname, "accessible-table-column-description") == 0)
384 i = g_value_get_int (&(values->new_value));
385 stemp = atk_table_get_column_description(ATK_TABLE (accessible), i);
386 emit(accessible, ITF_EVENT_OBJECT, PCHANGE, pname, 0, 0, DBUS_TYPE_STRING_AS_STRING, stemp);
388 else if (strcmp (pname, "accessible-table-caption-object") == 0)
390 otemp = atk_table_get_caption(ATK_TABLE(accessible));
391 stemp = atk_object_get_name(otemp);
392 emit(accessible, ITF_EVENT_OBJECT, PCHANGE, pname, 0, 0, DBUS_TYPE_STRING_AS_STRING, stemp);
396 emit(accessible, ITF_EVENT_OBJECT, PCHANGE, pname, 0, 0, DBUS_TYPE_INT32_AS_STRING, 0);
401 /*---------------------------------------------------------------------------*/
403 #define STATE_CHANGED "state-changed"
406 * The state event listener handles 'Gtk:AtkObject:state-change' ATK signals
407 * and forwards them as object:state-changed:(param-name) AT-SPI events. Where
408 * the param-name is part of the ATK state-change signal.
411 state_event_listener (GSignalInvocationHint *signal_hint,
412 guint n_param_values,
413 const GValue *param_values,
416 AtkObject *accessible;
420 accessible = ATK_OBJECT(g_value_get_object (¶m_values[0]));
421 pname = g_strdup (g_value_get_string (¶m_values[1]));
423 /* TODO - Possibly ignore a change to the 'defunct' state.
424 * This is because without reference counting defunct objects should be removed.
426 detail1 = (g_value_get_boolean (¶m_values[2])) ? 1 : 0;
427 emit(accessible, ITF_EVENT_OBJECT, STATE_CHANGED, pname, detail1, 0, DBUS_TYPE_INT32_AS_STRING, 0);
432 /*---------------------------------------------------------------------------*/
435 * The window event listener handles the following ATK signals and forwards
436 * them as AT-SPI events:
438 * window:create -> window:create
439 * window:destroy -> window:destroy
440 * window:minimize -> window:minimize
441 * window:maximize -> window:maximize
442 * window:activate -> window:activate
443 * window:deactivate -> window:deactivate
446 window_event_listener (GSignalInvocationHint *signal_hint,
447 guint n_param_values,
448 const GValue *param_values,
451 AtkObject *accessible;
452 GSignalQuery signal_query;
453 const gchar *name, *s;
455 g_signal_query (signal_hint->signal_id, &signal_query);
456 name = signal_query.signal_name;
458 accessible = ATK_OBJECT(g_value_get_object(¶m_values[0]));
459 s = atk_object_get_name (accessible);
460 emit(accessible, ITF_EVENT_WINDOW, name, "", 0, 0, DBUS_TYPE_STRING_AS_STRING, s);
465 /*---------------------------------------------------------------------------*/
468 * The document event listener handles the following ATK signals
469 * and converts them to AT-SPI events:
471 * Gtk:AtkDocument:load-complete -> document:load-complete
472 * Gtk:AtkDocument:load-stopped -> document:load-stopped
473 * Gtk:AtkDocument:reload -> document:reload
476 document_event_listener (GSignalInvocationHint *signal_hint,
477 guint n_param_values,
478 const GValue *param_values,
481 AtkObject *accessible;
482 GSignalQuery signal_query;
483 const gchar *name, *s;
485 g_signal_query (signal_hint->signal_id, &signal_query);
486 name = signal_query.signal_name;
488 accessible = ATK_OBJECT(g_value_get_object(¶m_values[0]));
489 s = atk_object_get_name (accessible);
490 emit(accessible, ITF_EVENT_DOCUMENT, name, "", 0, 0, DBUS_TYPE_STRING_AS_STRING, s);
495 /*---------------------------------------------------------------------------*/
498 * Signal handler for "Gtk:AtkComponent:bounds-changed". Converts
499 * this to an AT-SPI event - "object:bounds-changed".
502 bounds_event_listener (GSignalInvocationHint *signal_hint,
503 guint n_param_values,
504 const GValue *param_values,
507 AtkObject *accessible;
508 AtkRectangle *atk_rect;
509 GSignalQuery signal_query;
510 const gchar *name, *s;
512 g_signal_query (signal_hint->signal_id, &signal_query);
513 name = signal_query.signal_name;
515 accessible = ATK_OBJECT(g_value_get_object(¶m_values[0]));
517 if (G_VALUE_HOLDS_BOXED (param_values + 1))
518 atk_rect = g_value_get_boxed (param_values + 1);
520 emit_rect(accessible, ITF_EVENT_OBJECT, name, "", atk_rect);
524 /*---------------------------------------------------------------------------*/
527 * Handles the ATK signal 'Gtk:AtkObject:active-descendant-changed' and
528 * converts it to the AT-SPI signal - 'object:active-descendant-changed'.
532 active_descendant_event_listener (GSignalInvocationHint *signal_hint,
533 guint n_param_values,
534 const GValue *param_values,
537 AtkObject *accessible;
539 GSignalQuery signal_query;
540 const gchar *name, *minor;
544 g_signal_query (signal_hint->signal_id, &signal_query);
545 name = signal_query.signal_name;
547 accessible = ATK_OBJECT(g_value_get_object(¶m_values[0]));
548 child = ATK_OBJECT(g_value_get_pointer (¶m_values[1]));
549 g_return_val_if_fail (ATK_IS_OBJECT (child), TRUE);
550 minor = g_quark_to_string (signal_hint->detail);
552 detail1 = atk_object_get_index_in_parent (child);
553 s = get_object_path (child);
555 emit(accessible, ITF_EVENT_OBJECT, name, "", detail1, 0, DBUS_TYPE_OBJECT_PATH_AS_STRING, s);
560 /*---------------------------------------------------------------------------*/
563 * Handles the ATK signal 'Gtk:AtkHypertext:link-selected' and
564 * converts it to the AT-SPI signal - 'object:link-selected'
568 link_selected_event_listener (GSignalInvocationHint *signal_hint,
569 guint n_param_values,
570 const GValue *param_values,
573 AtkObject *accessible;
574 GSignalQuery signal_query;
575 const gchar *name, *minor;
578 g_signal_query (signal_hint->signal_id, &signal_query);
579 name = signal_query.signal_name;
581 accessible = ATK_OBJECT(g_value_get_object(¶m_values[0]));
582 minor = g_quark_to_string (signal_hint->detail);
584 if (G_VALUE_TYPE (¶m_values[1]) == G_TYPE_INT)
585 detail1 = g_value_get_int (¶m_values[1]);
587 emit(accessible, ITF_EVENT_OBJECT, name, minor, detail1, 0, DBUS_TYPE_INT32_AS_STRING, 0);
591 /*---------------------------------------------------------------------------*/
594 * Handles the ATK signal 'Gtk:AtkText:text-changed' and
595 * converts it to the AT-SPI signal - 'object:text-changed'
599 text_changed_event_listener (GSignalInvocationHint *signal_hint,
600 guint n_param_values,
601 const GValue *param_values,
604 AtkObject *accessible;
605 GSignalQuery signal_query;
606 const gchar *name, *minor;
608 gint detail1, detail2;
610 g_signal_query (signal_hint->signal_id, &signal_query);
611 name = signal_query.signal_name;
613 accessible = ATK_OBJECT(g_value_get_object(¶m_values[0]));
614 minor = g_quark_to_string (signal_hint->detail);
616 if (G_VALUE_TYPE (¶m_values[1]) == G_TYPE_INT)
617 detail1 = g_value_get_int (¶m_values[1]);
619 if (G_VALUE_TYPE (¶m_values[2]) == G_TYPE_INT)
620 detail2 = g_value_get_int (¶m_values[2]);
622 selected = atk_text_get_text (ATK_TEXT (accessible), detail1, detail1+detail2);
624 emit(accessible, ITF_EVENT_OBJECT, name, minor, detail1, detail2, DBUS_TYPE_STRING_AS_STRING, selected);
628 /*---------------------------------------------------------------------------*/
631 * Handles the ATK signal 'Gtk:AtkText:text-selection-changed' and
632 * converts it to the AT-SPI signal - 'object:text-selection-changed'
636 text_selection_changed_event_listener (GSignalInvocationHint *signal_hint,
637 guint n_param_values,
638 const GValue *param_values,
641 AtkObject *accessible;
642 GSignalQuery signal_query;
643 const gchar *name, *minor;
644 gint detail1, detail2;
646 g_signal_query (signal_hint->signal_id, &signal_query);
647 name = signal_query.signal_name;
649 accessible = ATK_OBJECT(g_value_get_object(¶m_values[0]));
650 minor = g_quark_to_string (signal_hint->detail);
652 if (G_VALUE_TYPE (¶m_values[1]) == G_TYPE_INT)
653 detail1 = g_value_get_int (¶m_values[1]);
655 if (G_VALUE_TYPE (¶m_values[2]) == G_TYPE_INT)
656 detail2 = g_value_get_int (¶m_values[2]);
658 emit(accessible, ITF_EVENT_OBJECT, name, minor, detail1, detail2, DBUS_TYPE_STRING_AS_STRING, "");
662 /*---------------------------------------------------------------------------*/
665 * Generic signal converter and forwarder.
667 * Klass (Interface) org.freedesktop.atspi.Event.Object
668 * Major is the signal name.
675 generic_event_listener (GSignalInvocationHint *signal_hint,
676 guint n_param_values,
677 const GValue *param_values,
680 AtkObject *accessible;
681 GSignalQuery signal_query;
684 g_signal_query (signal_hint->signal_id, &signal_query);
685 name = signal_query.signal_name;
687 accessible = ATK_OBJECT(g_value_get_object(¶m_values[0]));
688 emit(accessible, ITF_EVENT_OBJECT, name, "", 0, 0, DBUS_TYPE_INT32_AS_STRING, 0);
692 /*---------------------------------------------------------------------------*/
695 * Registers the provided function as a handler for the given signal name
696 * and stores the signal id returned so that the function may be
697 * de-registered later.
700 add_signal_listener (GSignalEmissionHook listener, const char *signal_name)
704 id = atk_add_global_event_listener (listener, signal_name);
705 g_array_append_val (listener_ids, id);
709 * Initialization for the signal handlers.
711 * Registers all required signal handlers.
714 spi_atk_register_event_listeners (void)
717 * Kludge to make sure the Atk interface types are registered, otherwise
718 * the AtkText signal handlers below won't get registered
720 GObject *ao = g_object_new (ATK_TYPE_OBJECT, NULL);
721 AtkObject *bo = atk_no_op_object_new (ao);
723 g_object_unref (G_OBJECT (bo));
726 /* Register for focus event notifications, and register app with central registry */
727 listener_ids = g_array_sized_new (FALSE, TRUE, sizeof (guint), 16);
729 atk_bridge_focus_tracker_id = atk_add_focus_tracker (focus_tracker);
731 add_signal_listener (property_event_listener, "Gtk:AtkObject:property-change");
732 add_signal_listener (window_event_listener, "window:create");
733 add_signal_listener (window_event_listener, "window:destroy");
734 add_signal_listener (window_event_listener, "window:minimize");
735 add_signal_listener (window_event_listener, "window:maximize");
736 add_signal_listener (window_event_listener, "window:restore");
737 add_signal_listener (window_event_listener, "window:activate");
738 add_signal_listener (window_event_listener, "window:deactivate");
739 add_signal_listener (document_event_listener, "Gtk:AtkDocument:load-complete");
740 add_signal_listener (document_event_listener, "Gtk:AtkDocument:reload");
741 add_signal_listener (document_event_listener, "Gtk:AtkDocument:load-stopped");
742 add_signal_listener (state_event_listener, "Gtk:AtkObject:state-change");
743 add_signal_listener (active_descendant_event_listener, "Gtk:AtkObject:active-descendant-changed");
744 add_signal_listener (bounds_event_listener, "Gtk:AtkComponent:bounds-changed");
745 add_signal_listener (text_selection_changed_event_listener, "Gtk:AtkText:text-selection-changed");
746 add_signal_listener (text_changed_event_listener, "Gtk:AtkText:text-changed");
747 add_signal_listener (link_selected_event_listener, "Gtk:AtkHypertext:link-selected");
748 add_signal_listener (generic_event_listener, "Gtk:AtkObject:visible-data-changed");
749 add_signal_listener (generic_event_listener, "Gtk:AtkSelection:selection-changed");
750 add_signal_listener (generic_event_listener, "Gtk:AtkText:text-caret-moved");
751 add_signal_listener (generic_event_listener, "Gtk:AtkTable:row-inserted");
752 add_signal_listener (generic_event_listener, "Gtk:AtkTable:row-reordered");
753 add_signal_listener (generic_event_listener, "Gtk:AtkTable:row-deleted");
754 add_signal_listener (generic_event_listener, "Gtk:AtkTable:column-inserted");
755 add_signal_listener (generic_event_listener, "Gtk:AtkTable:column-reordered");
756 add_signal_listener (generic_event_listener, "Gtk:AtkTable:column-deleted");
757 add_signal_listener (generic_event_listener, "Gtk:AtkTable:model-changed");
760 * May add the following listeners to implement preemptive key listening for GTK+
762 * atk_add_global_event_listener (spi_atk_bridge_widgetkey_listener, "Gtk:GtkWidget:key-press-event");
763 * atk_add_global_event_listener (spi_atk_bridge_widgetkey_listener, "Gtk:GtkWidget:key-release-event");
765 atk_bridge_key_event_listener_id = atk_add_key_event_listener (spi_atk_bridge_key_listener, NULL);
768 /*---------------------------------------------------------------------------*/
771 * De-registers all ATK signal handlers.
774 spi_atk_deregister_event_listeners (void)
777 GArray *ids = listener_ids;
780 if (atk_bridge_focus_tracker_id)
781 atk_remove_focus_tracker (atk_bridge_focus_tracker_id);
783 for (i = 0; ids && i < ids->len; i++)
785 atk_remove_global_event_listener (g_array_index (ids, guint, i));
788 if (atk_bridge_key_event_listener_id)
789 atk_remove_key_event_listener (atk_bridge_key_event_listener_id);
792 /*---------------------------------------------------------------------------*/
795 * TODO This function seems out of place here.
797 * Emits fake deactivate signals on all top-level windows.
798 * Used when shutting down AT-SPI, ensuring that all
799 * windows have been removed on the client side.
802 spi_atk_tidy_windows (void)
808 root = atk_get_root ();
809 n_children = atk_object_get_n_accessible_children (root);
810 for (i = 0; i < n_children; i++)
813 AtkStateSet *stateset;
816 child = atk_object_ref_accessible_child (root, i);
817 stateset = atk_object_ref_state_set (child);
819 name = atk_object_get_name (child);
820 if (atk_state_set_contains_state (stateset, ATK_STATE_ACTIVE))
822 emit(child, ITF_EVENT_WINDOW, "deactivate", NULL, 0, 0, DBUS_TYPE_STRING_AS_STRING, name);
824 g_object_unref (stateset);
826 emit(child, ITF_EVENT_WINDOW, "destroy", NULL, 0, 0, DBUS_TYPE_STRING_AS_STRING, name);
827 g_object_unref (child);
831 /*END------------------------------------------------------------------------*/