* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
*
* 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.
*
* 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.
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
*
- * You should have received a copy of the GNU Library General Public
- * License along with this library; if not, write to the Free
- * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ * 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.
*/
+
+/*
+ * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
+ * file for a list of people on the GTK+ Team. See the ChangeLog
+ * files for a list of changes. These files are distributed with
+ * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
+ */
+
#ifndef __GTK_SIGNAL_H__
#define __GTK_SIGNAL_H__
-#include <gdk/gdk.h>
#include <gtk/gtkenums.h>
#include <gtk/gtkobject.h>
+#include <gtk/gtkmarshal.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
-
-
-#ifdef offsetof
-#define GTK_SIGNAL_OFFSET(t, f) ((int) offsetof (t, f))
-#else /* offsetof */
-#define GTK_SIGNAL_OFFSET(t, f) ((int) ((char*) &((t*) 0)->f))
-#endif /* offsetof */
-
+G_BEGIN_DECLS
-typedef void (*GtkSignalMarshal) (GtkObject *object,
- gpointer data,
- gint nparams,
- GtkArg *args,
- GtkType *arg_types,
- GtkType return_type);
-typedef void (*GtkSignalDestroy) (gpointer data);
-
-typedef struct _GtkSignalQuery GtkSignalQuery;
-
-struct _GtkSignalQuery
-{
- gint object_type;
- const gchar *signal_name;
- gboolean is_user_signal;
- GtkSignalRunType run_type;
- GtkType return_val;
- guint nparams;
- const GtkType *params;
-};
-
-gint gtk_signal_new (const gchar *name,
- GtkSignalRunType run_type,
- gint object_type,
- gint function_offset,
- GtkSignalMarshaller marshaller,
- GtkType return_val,
- gint nparams,
- ...);
-gint gtk_signal_newv (const gchar *name,
- GtkSignalRunType run_type,
- gint object_type,
- gint function_offset,
- GtkSignalMarshaller marshaller,
- GtkType return_val,
- gint nparams,
- GtkType *params);
-gint gtk_signal_lookup (const gchar *name,
- gint object_type);
-gchar* gtk_signal_name (gint signal_num);
-void gtk_signal_emit (GtkObject *object,
- gint signal_type,
- ...);
-void gtk_signal_emit_by_name (GtkObject *object,
- const gchar *name,
- ...);
-void gtk_signal_emit_stop (GtkObject *object,
- gint signal_type);
-void gtk_signal_emit_stop_by_name (GtkObject *object,
- const gchar *name);
-gint gtk_signal_connect (GtkObject *object,
- const gchar *name,
- GtkSignalFunc func,
- gpointer func_data);
-gint gtk_signal_connect_after (GtkObject *object,
- const gchar *name,
- GtkSignalFunc func,
- gpointer func_data);
-gint gtk_signal_connect_object (GtkObject *object,
- const gchar *name,
- GtkSignalFunc func,
- GtkObject *slot_object);
-gint gtk_signal_connect_object_after (GtkObject *object,
- const gchar *name,
- GtkSignalFunc func,
- GtkObject *slot_object);
-gint gtk_signal_connect_interp (GtkObject *object,
- gchar *name,
- GtkCallbackMarshal func,
- gpointer data,
- GtkDestroyNotify destroy_func,
- gint after);
-
-void gtk_signal_connect_object_while_alive (GtkObject *object,
- const gchar *signal,
- GtkSignalFunc func,
- GtkObject *alive_object);
-
-void gtk_signal_disconnect (GtkObject *object,
- gint anid);
-void gtk_signal_disconnect_by_data (GtkObject *object,
- gpointer data);
-void gtk_signal_handler_block (GtkObject *object,
- gint anid);
-void gtk_signal_handler_block_by_data (GtkObject *object,
- gpointer data);
-void gtk_signal_handler_unblock (GtkObject *object,
- gint anid);
-void gtk_signal_handler_unblock_by_data (GtkObject *object,
- gpointer data);
-void gtk_signal_handlers_destroy (GtkObject *object);
-void gtk_signal_default_marshaller (GtkObject *object,
- GtkSignalFunc func,
- gpointer func_data,
- GtkArg *args);
-void gtk_signal_set_funcs (GtkSignalMarshal marshal_func,
- GtkSignalDestroy destroy_func);
-
-/* Report internal information about a signal. The caller has the response
- * to invoke a supsequent g_free (returned_data); but must leave the
- * contents of GtkSignalQuery untouched.
- */
-GtkSignalQuery* gtk_signal_query (gint signal_num);
-
-
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
-
+#ifndef GTK_DISABLE_DEPRECATED
+
+#define gtk_signal_default_marshaller g_cclosure_marshal_VOID__VOID
+
+
+/* --- compat defines --- */
+#define GTK_SIGNAL_OFFSET GTK_STRUCT_OFFSET
+#define gtk_signal_lookup(name,object_type) \
+ g_signal_lookup ((name), (object_type))
+#define gtk_signal_name(signal_id) \
+ g_signal_name (signal_id)
+#define gtk_signal_emit_stop(object,signal_id) \
+ g_signal_stop_emission ((object), (signal_id), 0)
+#define gtk_signal_connect(object,name,func,func_data) \
+ gtk_signal_connect_full ((object), (name), (func), 0, (func_data), 0, 0, 0)
+#define gtk_signal_connect_after(object,name,func,func_data) \
+ gtk_signal_connect_full ((object), (name), (func), 0, (func_data), 0, 0, 1)
+#define gtk_signal_connect_object(object,name,func,slot_object) \
+ gtk_signal_connect_full ((object), (name), (func), 0, (slot_object), 0, 1, 0)
+#define gtk_signal_connect_object_after(object,name,func,slot_object) \
+ gtk_signal_connect_full ((object), (name), (func), 0, (slot_object), 0, 1, 1)
+#define gtk_signal_disconnect(object,handler_id) \
+ g_signal_handler_disconnect ((object), (handler_id))
+#define gtk_signal_handler_block(object,handler_id) \
+ g_signal_handler_block ((object), (handler_id))
+#define gtk_signal_handler_unblock(object,handler_id) \
+ g_signal_handler_unblock ((object), (handler_id))
+#define gtk_signal_disconnect_by_func(object,func,data) \
+ gtk_signal_compat_matched ((object), (func), (data), G_SIGNAL_MATCH_FUNC | \
+ G_SIGNAL_MATCH_DATA, 0)
+#define gtk_signal_disconnect_by_data(object,data) \
+ gtk_signal_compat_matched ((object), 0, (data), G_SIGNAL_MATCH_DATA, 0)
+#define gtk_signal_handler_block_by_func(object,func,data) \
+ gtk_signal_compat_matched ((object), (func), (data), G_SIGNAL_MATCH_FUNC | \
+ G_SIGNAL_MATCH_DATA, 1)
+#define gtk_signal_handler_block_by_data(object,data) \
+ gtk_signal_compat_matched ((object), 0, (data), G_SIGNAL_MATCH_DATA, 1)
+#define gtk_signal_handler_unblock_by_func(object,func,data) \
+ gtk_signal_compat_matched ((object), (func), (data), G_SIGNAL_MATCH_FUNC | \
+ G_SIGNAL_MATCH_DATA, 2)
+#define gtk_signal_handler_unblock_by_data(object,data) \
+ gtk_signal_compat_matched ((object), 0, (data), G_SIGNAL_MATCH_DATA, 2)
+#define gtk_signal_handler_pending(object,signal_id,may_be_blocked) \
+ g_signal_has_handler_pending ((object), (signal_id), 0, (may_be_blocked))
+#define gtk_signal_handler_pending_by_func(object,signal_id,may_be_blocked,func,data) \
+ (g_signal_handler_find ((object), G_SIGNAL_MATCH_ID | \
+ G_SIGNAL_MATCH_FUNC | \
+ G_SIGNAL_MATCH_DATA | \
+ ((may_be_blocked) ? 0 : G_SIGNAL_MATCH_UNBLOCKED),\
+ (signal_id), 0, 0, (func), (data)) != 0)
+
+
+/* --- compat functions --- */
+guint gtk_signal_newv (const gchar *name,
+ GtkSignalRunType signal_flags,
+ GtkType object_type,
+ guint function_offset,
+ GtkSignalMarshaller marshaller,
+ GtkType return_val,
+ guint n_args,
+ GtkType *args);
+guint gtk_signal_new (const gchar *name,
+ GtkSignalRunType signal_flags,
+ GtkType object_type,
+ guint function_offset,
+ GtkSignalMarshaller marshaller,
+ GtkType return_val,
+ guint n_args,
+ ...);
+void gtk_signal_emit_stop_by_name (GtkObject *object,
+ const gchar *name);
+void gtk_signal_connect_object_while_alive (GtkObject *object,
+ const gchar *name,
+ GtkSignalFunc func,
+ GtkObject *alive_object);
+void gtk_signal_connect_while_alive (GtkObject *object,
+ const gchar *name,
+ GtkSignalFunc func,
+ gpointer func_data,
+ GtkObject *alive_object);
+gulong gtk_signal_connect_full (GtkObject *object,
+ const gchar *name,
+ GtkSignalFunc func,
+ GtkCallbackMarshal unsupported,
+ gpointer data,
+ GtkDestroyNotify destroy_func,
+ gint object_signal,
+ gint after);
+void gtk_signal_emitv (GtkObject *object,
+ guint signal_id,
+ GtkArg *args);
+void gtk_signal_emit (GtkObject *object,
+ guint signal_id,
+ ...);
+void gtk_signal_emit_by_name (GtkObject *object,
+ const gchar *name,
+ ...);
+void gtk_signal_emitv_by_name (GtkObject *object,
+ const gchar *name,
+ GtkArg *args);
+void gtk_signal_compat_matched (GtkObject *object,
+ GtkSignalFunc func,
+ gpointer data,
+ GSignalMatchType match,
+ guint action);
+
+#endif /* GTK_DISABLE_DEPRECATED */
+
+G_END_DECLS
#endif /* __GTK_SIGNAL_H__ */
projects / ~andy / gtk / blobdiff