diff options
author | Tim Janik <timj@gtk.org> | 2000-10-25 20:36:35 +0000 |
---|---|---|
committer | Tim Janik <timj@src.gnome.org> | 2000-10-25 20:36:35 +0000 |
commit | ee23c09e83d06a0d131ebd234c132f1c3602c019 (patch) | |
tree | b24f3cdd0758fed1a483abc645936ebae963b898 /gobject/gsignal.h | |
parent | b13320f78ba3b484a26b6430152b35aaac24ff10 (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.h | 142 |
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__ */ |