2.34.0
[platform/upstream/at-spi2-core.git] / atspi / atspi-event-listener.h
index 64f31d7..b7ad327 100644 (file)
@@ -4,22 +4,23 @@
  *
  * Copyright 2002 Ximian, Inc.
  *           2002 Sun Microsystems Inc.
+ * Copyright 2010, 2011 Novell, Inc.
  *           
  *
  * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Library General Public
+ * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
+ * version 2.1 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Library General Public License for more details.
+ * Lesser General Public License for more details.
  *
- * You should have received a copy of the GNU Library General Public
+ * You should have received a copy of the GNU Lesser General Public
  * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
  */
 
 #ifndef _ATSPI_EVENT_LISTENER_H_
@@ -29,6 +30,8 @@
 
 #include "atspi-types.h"
 
+G_BEGIN_DECLS
+
 GType atspi_event_get_type (void);
 
 /**
@@ -39,7 +42,7 @@ GType atspi_event_get_type (void);
  * A function prototype for callbacks via which clients are notified of AT-SPI events.
  * 
  **/
-typedef void       (*AtspiEventListenerCB)     (const AtspiEvent     *event,
+typedef void       (*AtspiEventListenerCB)     (AtspiEvent     *event,
                                                     void                      *user_data);
 
 /**
@@ -76,34 +79,62 @@ struct _AtspiEventListenerClass
 GType atspi_event_listener_get_type (void);
 
 AtspiEventListener *
+atspi_event_listener_new (AtspiEventListenerCB callback,
+                                 gpointer user_data,
+                                 GDestroyNotify callback_destroyed);
+
+AtspiEventListener *
 atspi_event_listener_new_simple (AtspiEventListenerSimpleCB callback,
                                  GDestroyNotify callback_destroyed);
 
 gboolean
 atspi_event_listener_register (AtspiEventListener *listener,
-                                const gchar              *event_type);
+                                const gchar              *event_type,
+                                GError **error);
+
+gboolean
+atspi_event_listener_register_full (AtspiEventListener *listener,
+                                     const gchar              *event_type,
+                                      GArray *properties,
+                                     GError **error);
 
 gboolean
 atspi_event_listener_register_from_callback (AtspiEventListenerCB callback,
                                             void *user_data,
                                             GDestroyNotify callback_destroyed,
-                                            const gchar              *event_type);
+                                            const gchar              *event_type,
+                                            GError **error);
+
+gboolean
+atspi_event_listener_register_from_callback_full (AtspiEventListenerCB callback,
+                                                 void *user_data,
+                                                 GDestroyNotify callback_destroyed,
+                                                 const gchar              *event_type,
+                                                  GArray *properties,
+                                                 GError **error);
 
 gboolean
 atspi_event_listener_register_no_data (AtspiEventListenerSimpleCB callback,
                                 GDestroyNotify callback_destroyed,
-                                const gchar              *event_type);
+                                const gchar              *event_type,
+                                GError **error);
 
 gboolean
 atspi_event_listener_deregister (AtspiEventListener *listener,
-                                const gchar              *event_type);
+                                const gchar              *event_type,
+                                GError **error);
 
 gboolean
 atspi_event_listener_deregister_from_callback (AtspiEventListenerCB callback,
                                               void *user_data,
-                                              const gchar              *event_type);
+                                              const gchar              *event_type,
+                                              GError **error);
 
 gboolean
 atspi_event_listener_deregister_no_data (AtspiEventListenerSimpleCB callback,
-                                  const gchar              *event_type);
+                                  const gchar              *event_type,
+                                  GError **error);
+
+G_END_DECLS
+
 #endif /* _ATSPI_EVENT_LISTENER_H_ */