1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
20 #include "gtksignal.h"
21 #include "gtkargcollector.c"
22 #include "gtkmarshal.c"
25 /* the real parameter limit is of course given by GSignal, bu we need
26 * an upper limit for the implementations. so this should be adjusted
27 * with any future changes on the GSignal side of things.
29 #define SIGNAL_MAX_PARAMS 12
32 /* --- functions --- */
34 gtk_signal_newv (const gchar *name,
35 GtkSignalRunType signal_flags,
37 guint function_offset,
38 GtkSignalMarshaller marshaller,
45 g_return_val_if_fail (n_params < SIGNAL_MAX_PARAMS, 0);
47 closure = g_signal_type_closure_new (object_type, function_offset);
49 return g_signal_newv (name, object_type, signal_flags, closure, NULL, marshaller, return_val, n_params, params);
53 gtk_signal_new (const gchar *name,
54 GtkSignalRunType signal_flags,
56 guint function_offset,
57 GtkSignalMarshaller marshaller,
70 params = g_new (GtkType, n_params);
71 va_start (args, n_params);
72 for (i = 0; i < n_params; i++)
73 params[i] = va_arg (args, GtkType);
78 signal_id = gtk_signal_newv (name,
92 gtk_signal_emit_stop_by_name (GtkObject *object,
95 g_return_if_fail (GTK_IS_OBJECT (object));
97 g_signal_stop_emission (object, g_signal_lookup (name, G_OBJECT_TYPE (object)));
101 gtk_signal_connect_object_while_alive (GtkObject *object,
104 GtkObject *alive_object)
106 g_return_if_fail (GTK_IS_OBJECT (object));
108 g_signal_connect_closure (object,
109 g_signal_lookup (signal, G_OBJECT_TYPE (object)),
110 g_cclosure_new_object_swap (func, alive_object),
115 gtk_signal_connect_while_alive (GtkObject *object,
119 GtkObject *alive_object)
123 g_return_if_fail (GTK_IS_OBJECT (object));
125 closure = g_cclosure_new (func, func_data, NULL);
126 g_object_watch_closure (G_OBJECT (alive_object), closure);
127 g_signal_connect_closure (object,
128 g_signal_lookup (signal, G_OBJECT_TYPE (object)),
134 gtk_signal_connect_full (GtkObject *object,
137 GtkCallbackMarshal unsupported,
139 GtkDestroyNotify destroy_func,
143 g_return_val_if_fail (GTK_IS_OBJECT (object), 0);
144 g_return_val_if_fail (unsupported == NULL, 0);
146 return g_signal_connect_closure (object,
147 g_signal_lookup (name, G_OBJECT_TYPE (object)),
149 ? g_cclosure_new_swap
150 : g_cclosure_new) (func,
152 (GClosureNotify) destroy_func),
157 gtk_signal_compat_matched (GtkObject *object,
160 GSignalMatchType match,
165 g_return_if_fail (GTK_IS_OBJECT (object));
167 id = g_signal_handler_find (object, match, 0, NULL, func, data);
170 g_warning ("unable to find signal handler for object(%p) with func(%p) and data(%p)",
175 case 0: g_signal_handler_disconnect (object, id); break;
176 case 1: g_signal_handler_block (object, id); break;
177 case 2: g_signal_handler_unblock (object, id); break;
181 static inline gboolean
182 gtk_arg_to_value (GtkArg *arg,
185 switch (G_TYPE_FUNDAMENTAL (arg->type))
187 case G_TYPE_CHAR: g_value_set_char (value, GTK_VALUE_CHAR (*arg)); break;
188 case G_TYPE_UCHAR: g_value_set_uchar (value, GTK_VALUE_UCHAR (*arg)); break;
189 case G_TYPE_BOOLEAN: g_value_set_boolean (value, GTK_VALUE_BOOL (*arg)); break;
190 case G_TYPE_INT: g_value_set_int (value, GTK_VALUE_INT (*arg)); break;
191 case G_TYPE_UINT: g_value_set_uint (value, GTK_VALUE_UINT (*arg)); break;
192 case G_TYPE_LONG: g_value_set_long (value, GTK_VALUE_LONG (*arg)); break;
193 case G_TYPE_ULONG: g_value_set_ulong (value, GTK_VALUE_ULONG (*arg)); break;
194 case G_TYPE_ENUM: g_value_set_enum (value, GTK_VALUE_ENUM (*arg)); break;
195 case G_TYPE_FLAGS: g_value_set_flags (value, GTK_VALUE_FLAGS (*arg)); break;
196 case G_TYPE_FLOAT: g_value_set_float (value, GTK_VALUE_FLOAT (*arg)); break;
197 case G_TYPE_DOUBLE: g_value_set_double (value, GTK_VALUE_DOUBLE (*arg)); break;
198 case G_TYPE_STRING: g_value_set_string (value, GTK_VALUE_STRING (*arg)); break;
199 case G_TYPE_BOXED: g_value_set_boxed (value, GTK_VALUE_BOXED (*arg)); break;
200 case G_TYPE_POINTER: g_value_set_pointer (value, GTK_VALUE_POINTER (*arg)); break;
201 case G_TYPE_OBJECT: g_value_set_object (value, GTK_VALUE_POINTER (*arg)); break;
208 static inline gboolean
209 gtk_arg_static_to_value (GtkArg *arg,
212 switch (G_TYPE_FUNDAMENTAL (arg->type))
214 case G_TYPE_CHAR: g_value_set_char (value, GTK_VALUE_CHAR (*arg)); break;
215 case G_TYPE_UCHAR: g_value_set_uchar (value, GTK_VALUE_UCHAR (*arg)); break;
216 case G_TYPE_BOOLEAN: g_value_set_boolean (value, GTK_VALUE_BOOL (*arg)); break;
217 case G_TYPE_INT: g_value_set_int (value, GTK_VALUE_INT (*arg)); break;
218 case G_TYPE_UINT: g_value_set_uint (value, GTK_VALUE_UINT (*arg)); break;
219 case G_TYPE_LONG: g_value_set_long (value, GTK_VALUE_LONG (*arg)); break;
220 case G_TYPE_ULONG: g_value_set_ulong (value, GTK_VALUE_ULONG (*arg)); break;
221 case G_TYPE_ENUM: g_value_set_enum (value, GTK_VALUE_ENUM (*arg)); break;
222 case G_TYPE_FLAGS: g_value_set_flags (value, GTK_VALUE_FLAGS (*arg)); break;
223 case G_TYPE_FLOAT: g_value_set_float (value, GTK_VALUE_FLOAT (*arg)); break;
224 case G_TYPE_DOUBLE: g_value_set_double (value, GTK_VALUE_DOUBLE (*arg)); break;
225 case G_TYPE_STRING: g_value_set_static_string (value, GTK_VALUE_STRING (*arg)); break;
226 case G_TYPE_BOXED: g_value_set_static_boxed (value, GTK_VALUE_BOXED (*arg)); break;
227 case G_TYPE_POINTER: g_value_set_pointer (value, GTK_VALUE_POINTER (*arg)); break;
228 case G_TYPE_OBJECT: g_value_set_object (value, GTK_VALUE_POINTER (*arg)); break;
235 static inline gboolean
236 gtk_arg_set_from_value (GtkArg *arg,
238 gboolean copy_string)
240 switch (G_TYPE_FUNDAMENTAL (arg->type))
242 case G_TYPE_CHAR: GTK_VALUE_CHAR (*arg) = g_value_get_char (value); break;
243 case G_TYPE_UCHAR: GTK_VALUE_UCHAR (*arg) = g_value_get_uchar (value); break;
244 case G_TYPE_BOOLEAN: GTK_VALUE_BOOL (*arg) = g_value_get_boolean (value); break;
245 case G_TYPE_INT: GTK_VALUE_INT (*arg) = g_value_get_int (value); break;
246 case G_TYPE_UINT: GTK_VALUE_UINT (*arg) = g_value_get_uint (value); break;
247 case G_TYPE_LONG: GTK_VALUE_LONG (*arg) = g_value_get_long (value); break;
248 case G_TYPE_ULONG: GTK_VALUE_ULONG (*arg) = g_value_get_ulong (value); break;
249 case G_TYPE_ENUM: GTK_VALUE_ENUM (*arg) = g_value_get_enum (value); break;
250 case G_TYPE_FLAGS: GTK_VALUE_FLAGS (*arg) = g_value_get_flags (value); break;
251 case G_TYPE_FLOAT: GTK_VALUE_FLOAT (*arg) = g_value_get_float (value); break;
252 case G_TYPE_DOUBLE: GTK_VALUE_DOUBLE (*arg) = g_value_get_double (value); break;
253 case G_TYPE_BOXED: GTK_VALUE_BOXED (*arg) = g_value_get_boxed (value); break;
254 case G_TYPE_POINTER: GTK_VALUE_POINTER (*arg) = g_value_get_pointer (value); break;
255 case G_TYPE_OBJECT: GTK_VALUE_POINTER (*arg) = g_value_get_object (value); break;
256 case G_TYPE_STRING: if (copy_string)
257 GTK_VALUE_STRING (*arg) = g_value_dup_string (value);
259 GTK_VALUE_STRING (*arg) = g_value_get_string (value);
267 static inline gboolean
268 gtk_argloc_set_from_value (GtkArg *arg,
270 gboolean copy_string)
272 switch (G_TYPE_FUNDAMENTAL (arg->type))
274 case G_TYPE_CHAR: *GTK_RETLOC_CHAR (*arg) = g_value_get_char (value); break;
275 case G_TYPE_UCHAR: *GTK_RETLOC_UCHAR (*arg) = g_value_get_uchar (value); break;
276 case G_TYPE_BOOLEAN: *GTK_RETLOC_BOOL (*arg) = g_value_get_boolean (value); break;
277 case G_TYPE_INT: *GTK_RETLOC_INT (*arg) = g_value_get_int (value); break;
278 case G_TYPE_UINT: *GTK_RETLOC_UINT (*arg) = g_value_get_uint (value); break;
279 case G_TYPE_LONG: *GTK_RETLOC_LONG (*arg) = g_value_get_long (value); break;
280 case G_TYPE_ULONG: *GTK_RETLOC_ULONG (*arg) = g_value_get_ulong (value); break;
281 case G_TYPE_ENUM: *GTK_RETLOC_ENUM (*arg) = g_value_get_enum (value); break;
282 case G_TYPE_FLAGS: *GTK_RETLOC_FLAGS (*arg) = g_value_get_flags (value); break;
283 case G_TYPE_FLOAT: *GTK_RETLOC_FLOAT (*arg) = g_value_get_float (value); break;
284 case G_TYPE_DOUBLE: *GTK_RETLOC_DOUBLE (*arg) = g_value_get_double (value); break;
285 case G_TYPE_BOXED: *GTK_RETLOC_BOXED (*arg) = g_value_get_boxed (value); break;
286 case G_TYPE_POINTER: *GTK_RETLOC_POINTER (*arg) = g_value_get_pointer (value); break;
287 case G_TYPE_OBJECT: *GTK_RETLOC_POINTER (*arg) = g_value_get_object (value); break;
288 case G_TYPE_STRING: if (copy_string)
289 *GTK_RETLOC_STRING (*arg) = g_value_dup_string (value);
291 *GTK_RETLOC_STRING (*arg) = g_value_get_string (value);
300 gtk_signal_emitv (GtkObject *object,
305 GValue params[SIGNAL_MAX_PARAMS + 1] = { { 0, }, };
306 GValue rvalue = { 0, };
309 g_return_if_fail (GTK_IS_OBJECT (object));
311 g_signal_query (signal_id, &query);
312 g_return_if_fail (query.signal_id != 0);
313 g_return_if_fail (g_type_conforms_to (GTK_OBJECT_TYPE (object), query.itype));
314 g_return_if_fail (query.n_params < SIGNAL_MAX_PARAMS);
315 if (query.n_params > 0)
316 g_return_if_fail (args != NULL);
318 g_value_init (params + 0, GTK_OBJECT_TYPE (object));
319 g_value_set_object (params + 0, G_OBJECT (object));
320 for (i = 0; i < query.n_params; i++)
322 GValue *value = params + 1 + i;
323 GtkArg *arg = args + i;
325 g_value_init (value, arg->type);
326 if (!gtk_arg_static_to_value (arg, value))
328 g_warning ("%s: failed to convert arg type `%s' to value type `%s'",
329 G_STRLOC, g_type_name (arg->type), g_type_name (G_VALUE_TYPE (value)));
333 if (query.return_type != G_TYPE_NONE)
334 g_value_init (&rvalue, query.return_type);
336 g_signal_emitv (params, signal_id, &rvalue);
338 if (query.return_type != G_TYPE_NONE)
340 gtk_argloc_set_from_value (args + query.n_params, &rvalue, TRUE);
341 g_value_unset (&rvalue);
343 for (i = 0; i < query.n_params; i++)
344 g_value_unset (params + 1 + i);
345 g_value_unset (params + 0);
349 gtk_signal_collect_args (GtkArg *args,
351 const GtkType *arg_types,
355 register GtkArg *last_arg;
356 register gboolean failed = FALSE;
358 for (last_arg = args + n_args; args < last_arg; args++)
360 register gchar *error;
363 args->type = *(arg_types++);
364 GTK_ARG_COLLECT_VALUE (args,
370 g_warning ("gtk_signal_collect_args(): %s", error);
375 args->type = return_type;
378 return_type = GTK_FUNDAMENTAL_TYPE (return_type);
379 if (return_type != G_TYPE_NONE)
381 if (return_type != 0) /* FIXME: check for IS_ARG */
383 GTK_VALUE_POINTER (*args) = va_arg (var_args, gpointer);
385 if (GTK_VALUE_POINTER (*args) == NULL)
388 g_warning ("gtk_signal_collect_args(): invalid NULL pointer for return argument type `%s'",
389 gtk_type_name (args->type));
395 g_warning ("gtk_signal_collect_args(): unsupported return argument type `%s'",
396 gtk_type_name (args->type));
400 GTK_VALUE_POINTER (*args) = NULL;
406 gtk_signal_emit (GtkObject *object,
410 GtkArg args[SIGNAL_MAX_PARAMS + 1];
415 g_return_if_fail (GTK_IS_OBJECT (object));
417 g_signal_query (signal_id, &query);
418 g_return_if_fail (query.signal_id != 0);
419 g_return_if_fail (query.n_params < SIGNAL_MAX_PARAMS);
421 va_start (var_args, signal_id);
422 abort = gtk_signal_collect_args (args,
430 gtk_signal_emitv (object, signal_id, args);
434 gtk_signal_emit_by_name (GtkObject *object,
438 GtkArg args[SIGNAL_MAX_PARAMS + 1];
443 g_return_if_fail (GTK_IS_OBJECT (object));
444 g_return_if_fail (name != NULL);
446 g_signal_query (g_signal_lookup (name, GTK_OBJECT_TYPE (object)), &query);
447 g_return_if_fail (query.signal_id != 0);
448 g_return_if_fail (query.n_params < SIGNAL_MAX_PARAMS);
450 va_start (var_args, name);
451 abort = gtk_signal_collect_args (args,
459 gtk_signal_emitv (object, query.signal_id, args);
463 gtk_signal_emitv_by_name (GtkObject *object,
467 g_return_if_fail (GTK_IS_OBJECT (object));
469 gtk_signal_emitv (object, g_signal_lookup (name, GTK_OBJECT_TYPE (object)), args);