summaryrefslogtreecommitdiff
path: root/gobject/gsignal.h
diff options
context:
space:
mode:
authorTim Janik <timj@gtk.org>2000-10-25 20:36:35 +0000
committerTim Janik <timj@src.gnome.org>2000-10-25 20:36:35 +0000
commitee23c09e83d06a0d131ebd234c132f1c3602c019 (patch)
treeb24f3cdd0758fed1a483abc645936ebae963b898 /gobject/gsignal.h
parentb13320f78ba3b484a26b6430152b35aaac24ff10 (diff)
added newly added gobject/ headers.
Tue Oct 24 22:09:14 2000 Tim Janik <timj@gtk.org> * glib-object.h: added newly added gobject/ headers. * gmesage.c: print g_message() output to stderr instead of stdout. Wed Oct 25 20:27:02 2000 Tim Janik <timj@gtk.org> * gtype.c (g_type_free_instance): for the moment, freeing object structures will fill their memory portion with 0xAA. there's a FIXME there, remove this line at a later point. Tue Oct 24 23:10:26 2000 Tim Janik <timj@gtk.org> * glib-genmarshal.1: * glib-genmarshal.c: added publically installed marshaller generator. * gtype.h: added G_TYPE_INSTANCE_GET_INTERFACE() to retrive a certain interface VTable from instances. Mon Oct 23 08:28:15 2000 Tim Janik <timj@gtk.org> * gobject.[hc]: new functions for closure maintenance: (g_object_watch_closure): maintain validity of the object and the closure for objects that are used as data part of a closure. (g_cclosure_new_object): convenience function to create C closures that have an object as data argument. (g_closure_new_object): convenience function to create closures that have an object as data argument. * gclosure.[hc]: implementation of GClosure mechanism. a closure is basically an encapsulation of a callback function and its environment. ideally, most places supporting callback functions will simply take a GClosure* pointer and thus unify callback environments wrg destroy notification etc. GClosure provides destroy notifiers for arbitrary data pointers, reference counting, invalidation notification (it can be invalidated which is merely a deactivate state) and a marshallinbg abstraction. GCClosure is also provided in these files, they present a specialized GClosure implementation for C language callbacks. * genum.c: macro cleanups. * gboxed.[hc]: new files, for boxed type abstraction. (g_boxed_copy): copy a boxed structure (g_boxed_free): free a boxed structure (g_value_set_boxed): (g_value_get_boxed): standard GValue functions for boxed types (g_boxed_type_register_static): convenience function for easy introduction of new G_TYPE_BOXED derivatives. * gparam.[hc]: introduced g_param_type_register_static(), a short hand for creation of new GParamSpec derived types. * gtype.[hc]: many fixes, introduced ability to flag individual type nodes as ABSTRACT upon registration, added value_peek_pointer() to the value table to peek at GValue contents as a pointer for types that support this. fixed up GValue checks. * gvalue.[hc]: added g_value_fits_pointer() and g_value_get_as_pointer() to peek at the value contents as pointer. * *.[hc]: adaptions to type macro fixes and changes in the type registration API. * many const corrections over the place. Sat Oct 21 02:49:56 2000 Tim Janik <timj@gtk.org> * gtype.c (g_type_conforms_to): this function basically behaves like and is_a check, except that it _additionally_ features interfaces for instantiatable types. enforce this in the second branch as well (`type' conforms_to `type') even if `type' is not an interface type. Fri Oct 20 15:31:04 2000 Tim Janik <timj@gtk.org> * gvaluetypes.[hc]: added G_TYPE_POINTER implementation from jrb. * gtype.[hc]: * gobject.c: * gvaluetypes.c: added GTypeValueTable.value_peek_pointer and suitable implementations of this for G_TYPE_STRING, G_TYPE_OBJECT and G_TYPE_POINTER. Mon Aug 21 04:13:37 2000 Tim Janik <timj@gtk.org> * gbsearcharray.[hc]: long standing needed generic implementation of a binary searchable, sorted and dynamically sized array.
Diffstat (limited to 'gobject/gsignal.h')
-rw-r--r--gobject/gsignal.h142
1 files changed, 142 insertions, 0 deletions
diff --git a/gobject/gsignal.h b/gobject/gsignal.h
new file mode 100644
index 000000000..f2be46f63
--- /dev/null
+++ b/gobject/gsignal.h
@@ -0,0 +1,142 @@
+/* GObject - GLib Type, Object, Parameter and Signal Library
+ * Copyright (C) 2000 Red Hat, Inc.
+ *
+ * This library is free software; you can redistribute it and/or
+ * 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
+ * Lesser General Public License for more details.
+ *
+ * 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.
+ */
+#ifndef __G_SIGNAL_H__
+#define __G_SIGNAL_H__
+
+
+#include <gobject/gclosure.h>
+#include <gobject/gvalue.h>
+#include <gobject/gparam.h>
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
+
+/* --- macros --- */
+#define G_SIGNAL_HINT_ID(hint) ((hint) >> 8)
+#define G_SIGNAL_HINT_RUN_TYPE(hint) ((hint) & 0xff)
+
+
+/* --- run & match types --- */
+typedef enum
+{
+ G_SIGNAL_RUN_FIRST = 1 << 0,
+ G_SIGNAL_RUN_LAST = 1 << 1,
+ G_SIGNAL_RUN_CLEANUP = 1 << 2,
+ G_SIGNAL_NO_RECURSE = 1 << 3,
+ G_SIGNAL_ACTION = 1 << 4,
+ G_SIGNAL_NO_HOOKS = 1 << 5
+} GSignalType;
+typedef enum
+{
+ G_SIGNAL_MATCH_ID = 1 << 0,
+ G_SIGNAL_MATCH_CLOSURE = 1 << 1,
+ G_SIGNAL_MATCH_FUNC = 1 << 2,
+ G_SIGNAL_MATCH_DATA = 1 << 3,
+ G_SIGNAL_MATCH_UNBLOCKED = 1 << 4,
+ G_SIGNAL_MATCH_MASK = 0x1f
+} GSignalMatchType;
+
+
+/* --- signal queries --- */
+typedef struct _GSignalQuery GSignalQuery;
+struct _GSignalQuery
+{
+ guint signal_id;
+ const gchar *signal_name;
+ GType itype;
+ GSignalType signal_flags;
+ GType return_type;
+ guint n_params;
+ const GType *param_types;
+};
+
+
+/* --- function types --- */
+typedef gboolean (*GSignalEmissionHook) (guint signal_id,
+ guint n_values,
+ const GValue *values);
+typedef gboolean (*GSignalAccumulator) (guint signal_id,
+ GValue *return_accu,
+ const GValue *return_value);
+typedef GClosureMarshal GSignalCMarshaller;
+
+
+/* --- signals --- */
+guint g_signal_newv (const gchar *signal_name,
+ GType itype,
+ GSignalType signal_flags,
+ GClosure *class_closure,
+ GSignalAccumulator accumulator,
+ GSignalCMarshaller c_marshaller,
+ GType return_type,
+ guint n_params,
+ GType *param_types);
+void g_signal_emitv (const GValue *instance_and_params,
+ guint signal_id,
+ GValue *return_value);
+guint g_signal_lookup (const gchar *name,
+ GType itype);
+gchar* g_signal_name (guint signal_id);
+void g_signal_query (guint signal_id,
+ GSignalQuery *query);
+
+
+/* --- signal handlers --- */
+guint g_signal_connect_closure (gpointer instance,
+ guint signal_id,
+ GClosure *closure,
+ gboolean after);
+void g_signal_handler_disconnect (gpointer instance,
+ guint handler_id);
+void g_signal_handler_block (gpointer instance,
+ guint handler_id);
+void g_signal_handler_unblock (gpointer instance,
+ guint handler_id);
+guint g_signal_handler_find (gpointer instance,
+ GSignalMatchType mask,
+ guint signal_id,
+ GClosure *closure,
+ gpointer func,
+ gpointer data);
+gboolean g_signal_has_handler_pending (gpointer instance,
+ guint signal_id,
+ gboolean may_be_blocked);
+
+
+/* --- signal emissions --- */
+void g_signal_stop_emission (gpointer instance,
+ guint signal_id);
+guint g_signal_add_emission_hook_full (guint signal_id,
+ GClosure *closure);
+void g_signal_remove_emission_hook (guint signal_id,
+ guint hook_id);
+
+/*< private >*/
+void g_signal_handlers_destroy (gpointer instance);
+void g_signals_destroy (GType itype);
+
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
+#endif /* __G_SIGNAL_H__ */