1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1998-2002 James Henstridge <james@daa.com.au>
3 * Copyright (C) 2006-2007 Async Open Source,
4 * Johan Dahlin <jdahlin@async.com.br>,
5 * Henrique Romano <henrique@async.com.br>
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
24 #include <errno.h> /* errno */
25 #include <stdlib.h> /* strtol, strtoul */
26 #include <string.h> /* strlen */
28 #include "gtkbuilder.h"
29 #include "gtkbuildable.h"
30 #include "gtkbuilderprivate.h"
33 #include "gtkprivate.h"
34 #include "gtktypebuiltins.h"
35 #include "gtkwindow.h"
36 #include "gtkicontheme.h"
40 static void gtk_builder_class_init (GtkBuilderClass *klass);
41 static void gtk_builder_init (GtkBuilder *builder);
42 static void gtk_builder_finalize (GObject *object);
43 static void gtk_builder_set_property (GObject *object,
47 static void gtk_builder_get_property (GObject *object,
51 static GType gtk_builder_real_get_type_from_name (GtkBuilder *builder,
52 const gchar *type_name);
56 PROP_TRANSLATION_DOMAIN,
59 struct _GtkBuilderPrivate
63 GSList *delayed_properties;
68 G_DEFINE_TYPE (GtkBuilder, gtk_builder, G_TYPE_OBJECT)
71 gtk_builder_class_init (GtkBuilderClass *klass)
73 GObjectClass *gobject_class;
75 gobject_class = G_OBJECT_CLASS (klass);
77 gobject_class->finalize = gtk_builder_finalize;
78 gobject_class->set_property = gtk_builder_set_property;
79 gobject_class->get_property = gtk_builder_get_property;
81 klass->get_type_from_name = gtk_builder_real_get_type_from_name;
84 * GtkBuilder:translation-domain:
86 * The translation domain used when translating property values that
87 * have been marked as translatable in interface descriptions.
88 * If the translation domain is %NULL, #GtkBuilder uses gettext(),
89 * otherwise g_dgettext().
93 g_object_class_install_property (gobject_class,
94 PROP_TRANSLATION_DOMAIN,
95 g_param_spec_string ("translation-domain",
96 P_("Translation Domain"),
97 P_("The translation domain used by gettext"),
99 GTK_PARAM_READWRITE));
101 g_type_class_add_private (gobject_class, sizeof (GtkBuilderPrivate));
105 gtk_builder_init (GtkBuilder *builder)
107 builder->priv = G_TYPE_INSTANCE_GET_PRIVATE (builder, GTK_TYPE_BUILDER,
109 builder->priv->domain = NULL;
110 builder->priv->objects = g_hash_table_new_full (g_str_hash, g_str_equal,
111 g_free, g_object_unref);
116 * GObject virtual methods
120 gtk_builder_finalize (GObject *object)
122 GtkBuilderPrivate *priv = GTK_BUILDER (object)->priv;
124 g_free (priv->domain);
125 g_free (priv->filename);
127 g_hash_table_destroy (priv->objects);
129 g_slist_foreach (priv->signals, (GFunc) _free_signal_info, NULL);
130 g_slist_free (priv->signals);
132 G_OBJECT_CLASS (gtk_builder_parent_class)->finalize (object);
136 gtk_builder_set_property (GObject *object,
141 GtkBuilder *builder = GTK_BUILDER (object);
145 case PROP_TRANSLATION_DOMAIN:
146 gtk_builder_set_translation_domain (builder, g_value_get_string (value));
149 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
155 gtk_builder_get_property (GObject *object,
160 GtkBuilder *builder = GTK_BUILDER (object);
164 case PROP_TRANSLATION_DOMAIN:
165 g_value_set_string (value, builder->priv->domain);
168 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
175 * Try to map a type name to a _get_type function
178 * GtkWindow -> gtk_window_get_type
179 * GtkHBox -> gtk_hbox_get_type
180 * GtkUIManager -> gtk_ui_manager_get_type
184 _gtk_builder_resolve_type_lazily (const gchar *name)
186 static GModule *module = NULL;
188 GString *symbol_name = g_string_new ("");
191 GType gtype = G_TYPE_INVALID;
194 module = g_module_open (NULL, 0);
196 for (i = 0; name[i] != '\0'; i++)
199 /* skip if uppercase, first or previous is uppercase */
200 if ((c == g_ascii_toupper (c) &&
201 i > 0 && name[i-1] != g_ascii_toupper (name[i-1])) ||
202 (i > 2 && name[i] == g_ascii_toupper (name[i]) &&
203 name[i-1] == g_ascii_toupper (name[i-1]) &&
204 name[i-2] == g_ascii_toupper (name[i-2])))
205 g_string_append_c (symbol_name, '_');
206 g_string_append_c (symbol_name, g_ascii_tolower (c));
208 g_string_append (symbol_name, "_get_type");
210 symbol = g_string_free (symbol_name, FALSE);
212 if (g_module_symbol (module, symbol, (gpointer)&func))
221 * GtkBuilder virtual methods
225 gtk_builder_real_get_type_from_name (GtkBuilder *builder,
226 const gchar *type_name)
230 gtype = g_type_from_name (type_name);
231 if (gtype != G_TYPE_INVALID)
234 return _gtk_builder_resolve_type_lazily (type_name);
245 gtk_builder_get_parameters (GtkBuilder *builder,
247 const gchar *object_name,
250 GArray **construct_parameters)
254 GObjectClass *oclass;
255 DelayedProperty *property;
256 GError *error = NULL;
258 oclass = g_type_class_ref (object_type);
259 g_assert (oclass != NULL);
261 *parameters = g_array_new (FALSE, FALSE, sizeof (GParameter));
262 *construct_parameters = g_array_new (FALSE, FALSE, sizeof (GParameter));
264 for (l = properties; l; l = l->next)
266 PropertyInfo *prop = (PropertyInfo*)l->data;
267 GParameter parameter = { NULL };
269 pspec = g_object_class_find_property (G_OBJECT_CLASS (oclass),
273 g_warning ("Unknown property: %s.%s",
274 g_type_name (object_type), prop->name);
278 parameter.name = prop->name;
280 if (G_IS_PARAM_SPEC_OBJECT (pspec) &&
281 (G_PARAM_SPEC_VALUE_TYPE (pspec) != GDK_TYPE_PIXBUF))
283 if (pspec->flags & G_PARAM_CONSTRUCT_ONLY)
286 object = gtk_builder_get_object (builder, prop->data);
289 g_warning ("Failed to get constuct only property "
290 "%s of %s with value `%s'",
291 prop->name, object_name, prop->data);
294 g_value_init (¶meter.value, G_OBJECT_TYPE (object));
295 g_value_set_object (¶meter.value, object);
299 property = g_slice_new (DelayedProperty);
300 property->object = g_strdup (object_name);
301 property->name = g_strdup (prop->name);
302 property->value = g_strdup (prop->data);
303 builder->priv->delayed_properties =
304 g_slist_prepend (builder->priv->delayed_properties, property);
309 else if (!gtk_builder_value_from_string (builder, pspec,
310 prop->data, ¶meter.value, &error))
312 g_warning ("Failed to set property %s.%s to %s: %s",
313 g_type_name (object_type), prop->name, prop->data,
315 g_error_free (error);
320 if (pspec->flags & G_PARAM_CONSTRUCT_ONLY)
321 g_array_append_val (*construct_parameters, parameter);
323 g_array_append_val (*parameters, parameter);
326 g_type_class_unref (oclass);
330 gtk_builder_get_internal_child (GtkBuilder *builder,
332 const gchar *childname,
342 info = (ObjectInfo*)((ChildInfo*)info->parent)->parent;
347 g_print ("Trying to get internal child %s from %s\n",
349 gtk_buildable_get_name (GTK_BUILDABLE (info->object))));
351 if (GTK_IS_BUILDABLE (info->object))
352 obj = gtk_buildable_get_internal_child (GTK_BUILDABLE (info->object),
361 GTK_BUILDER_ERROR_INVALID_VALUE,
362 "Unknown internal child: %s", childname);
368 _gtk_builder_construct (GtkBuilder *builder,
372 GArray *parameters, *construct_parameters;
376 GtkBuildableIface *iface;
377 gboolean custom_set_property;
378 GtkBuildable *buildable;
380 g_assert (info->class_name != NULL);
381 object_type = gtk_builder_get_type_from_name (builder, info->class_name);
382 if (object_type == G_TYPE_INVALID)
386 GTK_BUILDER_ERROR_INVALID_VALUE,
387 "Invalid object type `%s'",
392 gtk_builder_get_parameters (builder, object_type,
396 &construct_parameters);
398 if (info->constructor)
400 GObject *constructor;
402 constructor = gtk_builder_get_object (builder, info->constructor);
403 if (constructor == NULL)
407 GTK_BUILDER_ERROR_INVALID_VALUE,
408 "Unknown object constructor for %s: %s",
411 g_array_free (parameters, TRUE);
412 g_array_free (construct_parameters, TRUE);
415 obj = gtk_buildable_construct_child (GTK_BUILDABLE (constructor),
418 g_assert (obj != NULL);
419 if (construct_parameters->len)
420 g_warning ("Can't pass in construct-only parameters to %s", info->id);
422 else if (info->parent && ((ChildInfo*)info->parent)->internal_child != NULL)
424 gchar *childname = ((ChildInfo*)info->parent)->internal_child;
425 obj = gtk_builder_get_internal_child (builder, info, childname, error);
428 g_array_free (parameters, TRUE);
429 g_array_free (construct_parameters, TRUE);
432 if (construct_parameters->len)
433 g_warning ("Can't pass in construct-only parameters to %s", childname);
438 obj = g_object_newv (object_type,
439 construct_parameters->len,
440 (GParameter *)construct_parameters->data);
442 /* No matter what, make sure we have a reference.
444 * If it's an initially unowned object, sink it.
445 * If it's not initially unowned then we have the reference already.
447 * In the case that this is a window it will be sunk already and
448 * this is effectively a call to g_object_ref(). That's what
451 if (G_IS_INITIALLY_UNOWNED (obj))
452 g_object_ref_sink (obj);
455 g_print ("created %s of type %s\n", info->id, info->class_name));
457 for (i = 0; i < construct_parameters->len; i++)
459 GParameter *param = &g_array_index (construct_parameters,
461 g_value_unset (¶m->value);
464 g_array_free (construct_parameters, TRUE);
466 custom_set_property = FALSE;
469 if (GTK_IS_BUILDABLE (obj))
471 buildable = GTK_BUILDABLE (obj);
472 iface = GTK_BUILDABLE_GET_IFACE (obj);
473 if (iface->set_buildable_property)
474 custom_set_property = TRUE;
477 for (i = 0; i < parameters->len; i++)
479 GParameter *param = &g_array_index (parameters, GParameter, i);
480 if (custom_set_property)
481 iface->set_buildable_property (buildable, builder, param->name, ¶m->value);
483 g_object_set_property (obj, param->name, ¶m->value);
486 if (gtk_debug_flags & GTK_DEBUG_BUILDER)
488 gchar *str = g_strdup_value_contents ((const GValue*)¶m->value);
489 g_print ("set %s: %s = %s\n", info->id, param->name, str);
493 g_value_unset (¶m->value);
495 g_array_free (parameters, TRUE);
497 if (GTK_IS_BUILDABLE (obj))
498 gtk_buildable_set_name (buildable, info->id);
500 g_object_set_data_full (obj,
505 /* we already own a reference to obj. put it in the hash table. */
506 g_hash_table_insert (builder->priv->objects, g_strdup (info->id), obj);
513 _gtk_builder_add (GtkBuilder *builder,
514 ChildInfo *child_info)
519 /* Internal children are already added
520 * Also prevent us from being called twice.
523 child_info->internal_child ||
527 object = child_info->object;
531 if (!child_info->parent)
533 g_warning ("%s: Not adding, No parent",
534 gtk_buildable_get_name (GTK_BUILDABLE (object)));
538 g_assert (object != NULL);
540 parent = ((ObjectInfo*)child_info->parent)->object;
541 g_assert (GTK_IS_BUILDABLE (parent));
544 g_print ("adding %s to %s\n",
545 gtk_buildable_get_name (GTK_BUILDABLE (object)),
546 gtk_buildable_get_name (GTK_BUILDABLE (parent))));
548 gtk_buildable_add_child (GTK_BUILDABLE (parent), builder, object,
551 child_info->added = TRUE;
555 _gtk_builder_add_signals (GtkBuilder *builder,
558 builder->priv->signals = g_slist_concat (builder->priv->signals,
559 g_slist_copy (signals));
563 gtk_builder_apply_delayed_properties (GtkBuilder *builder)
566 DelayedProperty *property;
569 GObjectClass *oclass;
572 /* take the list over from the builder->priv.
574 * g_slist_reverse does not copy the list, so the list now
575 * belongs to us (and we free it at the end of this function).
577 props = g_slist_reverse (builder->priv->delayed_properties);
578 builder->priv->delayed_properties = NULL;
580 for (l = props; l; l = l->next)
582 property = (DelayedProperty*)l->data;
583 object = g_hash_table_lookup (builder->priv->objects, property->object);
584 g_assert (object != NULL);
586 object_type = G_OBJECT_TYPE (object);
587 g_assert (object_type != G_TYPE_INVALID);
589 oclass = g_type_class_ref (object_type);
590 g_assert (oclass != NULL);
592 pspec = g_object_class_find_property (G_OBJECT_CLASS (oclass),
595 g_warning ("Unknown property: %s.%s", g_type_name (object_type),
601 obj = g_hash_table_lookup (builder->priv->objects, property->value);
603 g_warning ("No object called: %s", property->value);
605 g_object_set (object, property->name, obj, NULL);
607 g_free (property->value);
608 g_free (property->object);
609 g_free (property->name);
610 g_slice_free (DelayedProperty, property);
611 g_type_class_unref (oclass);
613 g_slist_free (props);
617 _gtk_builder_finish (GtkBuilder *builder)
619 gtk_builder_apply_delayed_properties (builder);
625 * Creates a new builder object.
627 * Return value: a new #GtkBuilder object
632 gtk_builder_new (void)
634 return g_object_new (GTK_TYPE_BUILDER, NULL);
638 * gtk_builder_add_from_file:
639 * @builder: a #GtkBuilder
640 * @filename: the name of the file to parse
641 * @error: return location for an error, or %NULL
643 * Parses a file containing a <link linkend="BUILDER-UI">GtkBuilder
644 * UI definition</link> and merges it with the current contents of @builder.
646 * Returns: A positive value on success, 0 if an error occurred
651 gtk_builder_add_from_file (GtkBuilder *builder,
652 const gchar *filename,
659 g_return_val_if_fail (GTK_IS_BUILDER (builder), 0);
660 g_return_val_if_fail (filename != NULL, 0);
661 g_return_val_if_fail (error == NULL || *error == NULL, 0);
665 if (!g_file_get_contents (filename, &buffer, &length, &tmp_error))
667 g_propagate_error (error, tmp_error);
671 g_free (builder->priv->filename);
672 builder->priv->filename = g_strdup (filename);
674 _gtk_builder_parser_parse_buffer (builder, filename,
681 if (tmp_error != NULL)
683 g_propagate_error (error, tmp_error);
691 * gtk_builder_add_objects_from_file:
692 * @builder: a #GtkBuilder
693 * @filename: the name of the file to parse
694 * @object_ids: nul-terminated array of objects to build
695 * @error: return location for an error, or %NULL
697 * Parses a file containing a <link linkend="BUILDER-UI">GtkBuilder
698 * UI definition</link> building only the requested objects and merges
699 * them with the current contents of @builder.
702 * If you are adding an object that depends on an object that is not
703 * its child (for instance a #GtkTreeView that depends on its
704 * #GtkTreeModel), you have to explicitely list all of them in @object_ids.
707 * Returns: A positive value on success, 0 if an error occurred
712 gtk_builder_add_objects_from_file (GtkBuilder *builder,
713 const gchar *filename,
721 g_return_val_if_fail (GTK_IS_BUILDER (builder), 0);
722 g_return_val_if_fail (filename != NULL, 0);
723 g_return_val_if_fail (object_ids != NULL && object_ids[0] != NULL, 0);
724 g_return_val_if_fail (error == NULL || *error == NULL, 0);
728 if (!g_file_get_contents (filename, &buffer, &length, &tmp_error))
730 g_propagate_error (error, tmp_error);
734 g_free (builder->priv->filename);
735 builder->priv->filename = g_strdup (filename);
737 _gtk_builder_parser_parse_buffer (builder, filename,
744 if (tmp_error != NULL)
746 g_propagate_error (error, tmp_error);
754 * gtk_builder_add_from_string:
755 * @builder: a #GtkBuilder
756 * @buffer: the string to parse
757 * @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
758 * @error: return location for an error, or %NULL
760 * Parses a string containing a <link linkend="BUILDER-UI">GtkBuilder
761 * UI definition</link> and merges it with the current contents of @builder.
763 * Returns: A positive value on success, 0 if an error occurred
768 gtk_builder_add_from_string (GtkBuilder *builder,
775 g_return_val_if_fail (GTK_IS_BUILDER (builder), 0);
776 g_return_val_if_fail (buffer != NULL, 0);
777 g_return_val_if_fail (error == NULL || *error == NULL, 0);
781 g_free (builder->priv->filename);
782 builder->priv->filename = g_strdup (".");
784 _gtk_builder_parser_parse_buffer (builder, "<input>",
788 if (tmp_error != NULL)
790 g_propagate_error (error, tmp_error);
798 * gtk_builder_add_objects_from_string:
799 * @builder: a #GtkBuilder
800 * @buffer: the string to parse
801 * @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
802 * @object_ids: nul-terminated array of objects to build
803 * @error: return location for an error, or %NULL
805 * Parses a string containing a <link linkend="BUILDER-UI">GtkBuilder
806 * UI definition</link> building only the requested objects and merges
807 * them with the current contents of @builder.
810 * If you are adding an object that depends on an object that is not
811 * its child (for instance a #GtkTreeView that depends on its
812 * #GtkTreeModel), you have to explicitely list all of them in @object_ids.
815 * Returns: A positive value on success, 0 if an error occurred
820 gtk_builder_add_objects_from_string (GtkBuilder *builder,
828 g_return_val_if_fail (GTK_IS_BUILDER (builder), 0);
829 g_return_val_if_fail (buffer != NULL, 0);
830 g_return_val_if_fail (object_ids != NULL && object_ids[0] != NULL, 0);
831 g_return_val_if_fail (error == NULL || *error == NULL, 0);
835 g_free (builder->priv->filename);
836 builder->priv->filename = g_strdup (".");
838 _gtk_builder_parser_parse_buffer (builder, "<input>",
843 if (tmp_error != NULL)
845 g_propagate_error (error, tmp_error);
853 * gtk_builder_get_object:
854 * @builder: a #GtkBuilder
855 * @name: name of object to get
857 * Gets the object named @name. Note that this function does not
858 * increment the reference count of the returned object.
860 * Return value: the object named @name or %NULL if it could not be
861 * found in the object tree.
866 gtk_builder_get_object (GtkBuilder *builder,
869 g_return_val_if_fail (GTK_IS_BUILDER (builder), NULL);
870 g_return_val_if_fail (name != NULL, NULL);
872 return g_hash_table_lookup (builder->priv->objects, name);
876 object_add_to_list (gchar *object_id,
880 *list = g_slist_prepend (*list, object);
884 * gtk_builder_get_objects:
885 * @builder: a #GtkBuilder
887 * Gets all objects that have been constructed by @builder. Note that
888 * this function does not increment the reference counts of the returned
891 * Return value: a newly-allocated #GSList containing all the objects
892 * constructed by the #GtkBuilder instance. It should be freed by
898 gtk_builder_get_objects (GtkBuilder *builder)
900 GSList *objects = NULL;
902 g_return_val_if_fail (GTK_IS_BUILDER (builder), NULL);
904 g_hash_table_foreach (builder->priv->objects, (GHFunc)object_add_to_list, &objects);
906 return g_slist_reverse (objects);
910 * gtk_builder_set_translation_domain:
911 * @builder: a #GtkBuilder
912 * @domain: the translation domain or %NULL
914 * Sets the translation domain of @builder.
915 * See #GtkBuilder:translation-domain.
920 gtk_builder_set_translation_domain (GtkBuilder *builder,
925 g_return_if_fail (GTK_IS_BUILDER (builder));
927 new_domain = g_strdup (domain);
928 g_free (builder->priv->domain);
929 builder->priv->domain = new_domain;
931 g_object_notify (G_OBJECT (builder), "translation-domain");
935 * gtk_builder_get_translation_domain:
936 * @builder: a #GtkBuilder
938 * Gets the translation domain of @builder.
940 * Return value: the translation domain. This string is owned
941 * by the builder object and must not be modified or freed.
946 gtk_builder_get_translation_domain (GtkBuilder *builder)
948 g_return_val_if_fail (GTK_IS_BUILDER (builder), NULL);
950 return builder->priv->domain;
959 gtk_builder_connect_signals_default (GtkBuilder *builder,
961 const gchar *signal_name,
962 const gchar *handler_name,
963 GObject *connect_object,
968 connect_args *args = (connect_args*)user_data;
970 if (!g_module_symbol (args->module, handler_name, (gpointer)&func))
972 g_warning ("Could not find signal handler '%s'", handler_name);
977 g_signal_connect_object (object, signal_name, func, connect_object, flags);
979 g_signal_connect_data (object, signal_name, func, args->data, NULL, flags);
984 * gtk_builder_connect_signals:
985 * @builder: a #GtkBuilder
986 * @user_data: a pointer to a structure sent in as user data to all signals
988 * This method is a simpler variation of gtk_builder_connect_signals_full().
989 * It uses #GModule's introspective features (by opening the module %NULL)
990 * to look at the application's symbol table. From here it tries to match
991 * the signal handler names given in the interface description with
992 * symbols in the application and connects the signals.
994 * Note that this function will not work correctly if #GModule is not
995 * supported on the platform.
997 * When compiling applications for Windows, you must declare signal callbacks
998 * with #G_MODULE_EXPORT, or they will not be put in the symbol table.
999 * On Linux and Unices, this is not necessary; applications should instead
1000 * be compiled with the -Wl,--export-dynamic CFLAGS, and linked against
1001 * gmodule-export-2.0.
1006 gtk_builder_connect_signals (GtkBuilder *builder,
1011 g_return_if_fail (GTK_IS_BUILDER (builder));
1013 if (!g_module_supported ())
1014 g_error ("gtk_builder_connect_signals() requires working GModule");
1016 args = g_slice_new0 (connect_args);
1017 args->module = g_module_open (NULL, G_MODULE_BIND_LAZY);
1018 args->data = user_data;
1020 gtk_builder_connect_signals_full (builder,
1021 gtk_builder_connect_signals_default,
1023 g_module_close (args->module);
1025 g_slice_free (connect_args, args);
1029 * GtkBuilderConnectFunc:
1030 * @builder: a #GtkBuilder
1031 * @object: object to connect a signal to
1032 * @signal_name: name of the signal
1033 * @handler_name: name of the handler
1034 * @connect_object: a #GObject, if non-%NULL, use g_signal_connect_object()
1035 * @flags: #GConnectFlags to use
1036 * @user_data: user data
1038 * This is the signature of a function used to connect signals. It is used
1039 * by the gtk_builder_connect_signals() and gtk_builder_connect_signals_full()
1040 * methods. It is mainly intended for interpreted language bindings, but
1041 * could be useful where the programmer wants more control over the signal
1042 * connection process.
1048 * gtk_builder_connect_signals_full:
1049 * @builder: a #GtkBuilder
1050 * @func: the function used to connect the signals
1051 * @user_data: arbitrary data that will be passed to the connection function
1053 * This function can be thought of the interpreted language binding
1054 * version of gtk_builder_connect_signals(), except that it does not
1055 * require GModule to function correctly.
1060 gtk_builder_connect_signals_full (GtkBuilder *builder,
1061 GtkBuilderConnectFunc func,
1066 GObject *connect_object;
1068 g_return_if_fail (GTK_IS_BUILDER (builder));
1069 g_return_if_fail (func != NULL);
1071 if (!builder->priv->signals)
1074 builder->priv->signals = g_slist_reverse (builder->priv->signals);
1075 for (l = builder->priv->signals; l; l = l->next)
1077 SignalInfo *signal = (SignalInfo*)l->data;
1079 g_assert (signal != NULL);
1080 g_assert (signal->name != NULL);
1082 object = g_hash_table_lookup (builder->priv->objects,
1083 signal->object_name);
1084 g_assert (object != NULL);
1086 connect_object = NULL;
1088 if (signal->connect_object_name)
1090 connect_object = g_hash_table_lookup (builder->priv->objects,
1091 signal->connect_object_name);
1092 if (!connect_object)
1093 g_warning ("Could not lookup object %s on signal %s of object %s",
1094 signal->connect_object_name, signal->name,
1095 signal->object_name);
1098 func (builder, object, signal->name, signal->handler,
1099 connect_object, signal->flags, user_data);
1102 g_slist_foreach (builder->priv->signals, (GFunc)_free_signal_info, NULL);
1103 g_slist_free (builder->priv->signals);
1104 builder->priv->signals = NULL;
1108 * gtk_builder_value_from_string:
1109 * @builder: a #GtkBuilder
1110 * @pspec: the #GParamSpec for the property
1111 * @string: the string representation of the value
1112 * @value: the #GValue to store the result in
1113 * @error: return location for an error, or %NULL
1115 * This function demarshals a value from a string. This function
1116 * calls g_value_init() on the @value argument, so it need not be
1117 * initialised beforehand.
1119 * This function can handle char, uchar, boolean, int, uint, long,
1120 * ulong, enum, flags, float, double, string, #GdkColor and
1121 * #GtkAdjustment type values. Support for #GtkWidget type values is
1124 * Returns: %TRUE on success
1129 gtk_builder_value_from_string (GtkBuilder *builder,
1131 const gchar *string,
1135 g_return_val_if_fail (GTK_IS_BUILDER (builder), FALSE);
1136 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1137 g_return_val_if_fail (string != NULL, FALSE);
1138 g_return_val_if_fail (value != NULL, FALSE);
1139 g_return_val_if_fail (error == NULL || *error == NULL, FALSE);
1142 * GParamSpecUnichar has the internal type G_TYPE_UINT,
1143 * so we cannot handle this in the switch, do it separately
1145 if (G_IS_PARAM_SPEC_UNICHAR (pspec))
1148 g_value_init (value, G_TYPE_UINT);
1149 c = g_utf8_get_char_validated (string, strlen (string));
1151 g_value_set_uint (value, c);
1155 return gtk_builder_value_from_string_type (builder,
1156 G_PARAM_SPEC_VALUE_TYPE (pspec),
1157 string, value, error);
1161 * gtk_builder_value_from_string_type:
1162 * @builder: a #GtkBuilder
1163 * @type: the #GType of the value
1164 * @string: the string representation of the value
1165 * @value: the #GValue to store the result in
1166 * @error: return location for an error, or %NULL
1168 * Like gtk_builder_value_from_string(), this function demarshals
1169 * a value from a string, but takes a #GType instead of #GParamSpec.
1170 * This function calls g_value_init() on the @value argument, so it
1171 * need not be initialised beforehand.
1173 * Returns: %TRUE on success
1178 gtk_builder_value_from_string_type (GtkBuilder *builder,
1180 const gchar *string,
1184 gboolean ret = TRUE;
1186 g_return_val_if_fail (type != G_TYPE_INVALID, FALSE);
1187 g_return_val_if_fail (string != NULL, FALSE);
1188 g_return_val_if_fail (error == NULL || *error == NULL, FALSE);
1190 g_value_init (value, type);
1192 switch (G_TYPE_FUNDAMENTAL (type))
1195 g_value_set_char (value, string[0]);
1198 g_value_set_uchar (value, (guchar)string[0]);
1200 case G_TYPE_BOOLEAN:
1204 if (!_gtk_builder_boolean_from_string (string, &b, error))
1209 g_value_set_boolean (value, b);
1218 l = strtol (string, &endptr, 0);
1219 if (errno || endptr == string)
1223 GTK_BUILDER_ERROR_INVALID_VALUE,
1224 "Could not parse integer `%s'",
1229 if (G_VALUE_HOLDS_INT (value))
1230 g_value_set_int (value, l);
1232 g_value_set_long (value, l);
1241 ul = strtoul (string, &endptr, 0);
1242 if (errno || endptr == string)
1246 GTK_BUILDER_ERROR_INVALID_VALUE,
1247 "Could not parse unsigned integer `%s'",
1252 if (G_VALUE_HOLDS_UINT (value))
1253 g_value_set_uint (value, ul);
1255 g_value_set_ulong (value, ul);
1261 if (!_gtk_builder_enum_from_string (type, string, &enum_value, error))
1266 g_value_set_enum (value, enum_value);
1273 if (!_gtk_builder_flags_from_string (type, string, &flags_value, error))
1278 g_value_set_flags (value, flags_value);
1287 d = g_ascii_strtod (string, &endptr);
1288 if (errno || endptr == string)
1292 GTK_BUILDER_ERROR_INVALID_VALUE,
1293 "Could not parse double `%s'",
1298 if (G_VALUE_HOLDS_FLOAT (value))
1299 g_value_set_float (value, d);
1301 g_value_set_double (value, d);
1305 g_value_set_string (value, string);
1308 if (G_VALUE_HOLDS (value, GDK_TYPE_COLOR))
1310 GdkColor colour = { 0, };
1312 if (gdk_color_parse (string, &colour) &&
1313 gdk_colormap_alloc_color (gtk_widget_get_default_colormap (),
1314 &colour, FALSE, TRUE))
1315 g_value_set_boxed (value, &colour);
1320 GTK_BUILDER_ERROR_INVALID_VALUE,
1321 "Could not parse color `%s'",
1326 else if (G_VALUE_HOLDS (value, G_TYPE_STRV))
1328 gchar **vector = g_strsplit (string, "\n", 0);
1329 g_value_take_boxed (value, vector);
1335 if (G_VALUE_HOLDS (value, GDK_TYPE_PIXBUF))
1338 GError *tmp_error = NULL;
1341 if (gtk_builder_get_object (builder, string))
1345 GTK_BUILDER_ERROR_INVALID_VALUE,
1346 "Could not load image '%s': "
1347 " '%s' is already used as object id",
1352 filename = _gtk_builder_get_absolute_filename (builder, string);
1353 pixbuf = gdk_pixbuf_new_from_file (filename, &tmp_error);
1357 GtkIconTheme *theme;
1359 g_warning ("Could not load image '%s': %s",
1360 string, tmp_error->message);
1361 g_error_free (tmp_error);
1363 /* fall back to a missing image */
1364 theme = gtk_icon_theme_get_default ();
1365 pixbuf = gtk_icon_theme_load_icon (theme,
1366 GTK_STOCK_MISSING_IMAGE,
1368 GTK_ICON_LOOKUP_USE_BUILTIN,
1374 g_value_set_object (value, pixbuf);
1375 g_object_unref (G_OBJECT (pixbuf));
1388 GTK_BUILDER_ERROR_INVALID_VALUE,
1389 "Unsupported GType `%s'",
1390 g_type_name (type));
1399 _gtk_builder_enum_from_string (GType type,
1400 const gchar *string,
1410 g_return_val_if_fail (G_TYPE_IS_ENUM (type), FALSE);
1411 g_return_val_if_fail (string != NULL, FALSE);
1415 value = strtoul (string, &endptr, 0);
1416 if (endptr != string) /* parsed a number */
1417 *enum_value = value;
1420 eclass = g_type_class_ref (type);
1421 ev = g_enum_get_value_by_name (eclass, string);
1423 ev = g_enum_get_value_by_nick (eclass, string);
1426 *enum_value = ev->value;
1431 GTK_BUILDER_ERROR_INVALID_VALUE,
1432 "Could not parse enum: `%s'",
1437 g_type_class_unref (eclass);
1444 _gtk_builder_flags_from_string (GType type,
1445 const gchar *string,
1449 GFlagsClass *fclass;
1450 gchar *endptr, *prevptr;
1458 g_return_val_if_fail (G_TYPE_IS_FLAGS (type), FALSE);
1459 g_return_val_if_fail (string != 0, FALSE);
1463 value = strtoul (string, &endptr, 0);
1464 if (endptr != string) /* parsed a number */
1465 *flags_value = value;
1468 fclass = g_type_class_ref (type);
1470 flagstr = g_strdup (string);
1471 for (value = i = j = 0; ; i++)
1474 eos = flagstr[i] == '\0';
1476 if (!eos && flagstr[i] != '|')
1480 endptr = &flagstr[i];
1484 flagstr[i++] = '\0';
1491 ch = g_utf8_get_char (flag);
1492 if (!g_unichar_isspace (ch))
1494 flag = g_utf8_next_char (flag);
1497 while (endptr > flag)
1499 prevptr = g_utf8_prev_char (endptr);
1500 ch = g_utf8_get_char (prevptr);
1501 if (!g_unichar_isspace (ch))
1509 fv = g_flags_get_value_by_name (fclass, flag);
1512 fv = g_flags_get_value_by_nick (fclass, flag);
1520 GTK_BUILDER_ERROR_INVALID_VALUE,
1521 "Unknown flag: `%s'",
1530 *flags_value = value;
1537 g_type_class_unref (fclass);
1544 * gtk_builder_get_type_from_name:
1545 * @builder: a #GtkBuilder
1546 * @type_name: type name to lookup
1548 * Looks up a type by name, using the virtual function that
1549 * #GtkBuilder has for that purpose. This is mainly used when
1550 * implementing the #GtkBuildable interface on a type.
1552 * Returns: the #GType found for @type_name or #G_TYPE_INVALID
1553 * if no type was found
1558 gtk_builder_get_type_from_name (GtkBuilder *builder,
1559 const gchar *type_name)
1561 g_return_val_if_fail (GTK_IS_BUILDER (builder), G_TYPE_INVALID);
1562 g_return_val_if_fail (type_name != NULL, G_TYPE_INVALID);
1564 return GTK_BUILDER_GET_CLASS (builder)->get_type_from_name (builder, type_name);
1568 gtk_builder_error_quark (void)
1570 return g_quark_from_static_string ("gtk-builder-error-quark");
1574 _gtk_builder_get_absolute_filename (GtkBuilder *builder, const gchar *string)
1577 gchar *dirname = NULL;
1579 if (g_path_is_absolute (string))
1580 return g_strdup (string);
1582 if (builder->priv->filename &&
1583 strcmp (builder->priv->filename, ".") != 0)
1585 dirname = g_path_get_dirname (builder->priv->filename);
1587 if (strcmp (dirname, ".") == 0)
1590 dirname = g_get_current_dir ();
1594 dirname = g_get_current_dir ();
1596 filename = g_build_filename (dirname, string, NULL);
1602 #define __GTK_BUILDER_C__
1603 #include "gtkaliasdef.c"