1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 2000 Red Hat, Inc.
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 Free
16 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
19 #include "gtksettings.h"
22 #include "gtkwidget.h"
24 typedef struct _GtkSettingsValuePrivate GtkSettingsValuePrivate;
28 GTK_SETTINGS_SOURCE_DEFAULT,
29 GTK_SETTINGS_SOURCE_RC_FILE,
30 GTK_SETTINGS_SOURCE_APPLICATION
33 struct _GtkSettingsValuePrivate
35 GtkSettingsValue public;
36 GtkSettingsSource source;
39 struct _GtkSettingsPropertyValue
42 GtkSettingsSource source;
45 #ifdef GDK_WINDOWING_X11
46 #include <X11/Xft/Xft.h>
47 #include <pango/pangoxft.h>
48 #include <gdk/x11/gdkx.h>
53 PROP_DOUBLE_CLICK_TIME,
54 PROP_DOUBLE_CLICK_DISTANCE,
56 PROP_CURSOR_BLINK_TIME,
62 PROP_DND_DRAG_THRESHOLD,
73 /* --- prototypes --- */
74 static void gtk_settings_init (GtkSettings *settings);
75 static void gtk_settings_class_init (GtkSettingsClass *class);
76 static void gtk_settings_finalize (GObject *object);
77 static void gtk_settings_get_property (GObject *object,
81 static void gtk_settings_set_property (GObject *object,
85 static void gtk_settings_notify (GObject *object,
87 static guint settings_install_property_parser (GtkSettingsClass *class,
89 GtkRcPropertyParser parser);
90 static void settings_update_double_click (GtkSettings *settings);
93 /* --- variables --- */
94 static gpointer parent_class = NULL;
95 static GQuark quark_property_parser = 0;
96 static GSList *object_list = NULL;
97 static guint class_n_properties = 0;
100 /* --- functions --- */
102 gtk_settings_get_type (void)
104 static GType settings_type = 0;
108 static const GTypeInfo settings_info =
110 sizeof (GtkSettingsClass),
111 NULL, /* base_init */
112 NULL, /* base_finalize */
113 (GClassInitFunc) gtk_settings_class_init,
114 NULL, /* class_finalize */
115 NULL, /* class_data */
116 sizeof (GtkSettings),
118 (GInstanceInitFunc) gtk_settings_init,
121 settings_type = g_type_register_static (G_TYPE_OBJECT, "GtkSettings",
125 return settings_type;
128 #ifdef GDK_WINDOWING_X11
130 gtk_default_substitute (FcPattern *pattern,
133 GtkSettings *settings = data;
141 g_object_get (G_OBJECT (settings),
142 "gtk-xft-antialias", &antialias,
143 "gtk-xft-hinting", &hinting,
144 "gtk-xft-hintstyle", &hintstyle,
145 "gtk-xft-rgba", &rgba,
149 if (antialias >= 0 &&
150 FcPatternGet (pattern, FC_ANTIALIAS, 0, &v) == FcResultNoMatch)
151 FcPatternAddBool (pattern, FC_ANTIALIAS, antialias != 0);
154 FcPatternGet (pattern, FC_HINTING, 0, &v) == FcResultNoMatch)
155 FcPatternAddBool (pattern, FC_HINTING, hinting != 0);
158 if (hintstyle && FcPatternGet (pattern, FC_HINT_STYLE, 0, &v) == FcResultNoMatch)
160 int val = FC_HINT_FULL; /* Quiet GCC */
161 gboolean found = TRUE;
163 if (strcmp (hintstyle, "hintnone") == 0)
165 else if (strcmp (hintstyle, "hintslight") == 0)
166 val = FC_HINT_SLIGHT;
167 else if (strcmp (hintstyle, "hintmedium") == 0)
168 val = FC_HINT_MEDIUM;
169 else if (strcmp (hintstyle, "hintfull") == 0)
175 FcPatternAddInteger (pattern, FC_HINT_STYLE, val);
177 #endif /* FC_HINT_STYLE */
179 if (rgba && FcPatternGet (pattern, FC_RGBA, 0, &v) == FcResultNoMatch)
181 int val = FC_RGBA_NONE; /* Quiet GCC */
182 gboolean found = TRUE;
184 if (strcmp (rgba, "none") == 0)
186 else if (strcmp (rgba, "rgb") == 0)
188 else if (strcmp (rgba, "bgr") == 0)
190 else if (strcmp (rgba, "vrgb") == 0)
192 else if (strcmp (rgba, "vbgr") == 0)
198 FcPatternAddInteger (pattern, FC_RGBA, val);
201 if (dpi >= 0 && FcPatternGet (pattern, FC_DPI, 0, &v) == FcResultNoMatch)
202 FcPatternAddDouble (pattern, FC_DPI, dpi / 1024.);
207 #endif /* GDK_WINDOWING_X11 */
210 gtk_settings_init (GtkSettings *settings)
212 GParamSpec **pspecs, **p;
215 g_datalist_init (&settings->queued_settings);
216 object_list = g_slist_prepend (object_list, settings);
218 /* build up property array for all yet existing properties and queue
219 * notification for them (at least notification for internal properties
220 * will instantly be caught)
222 pspecs = g_object_class_list_properties (G_OBJECT_GET_CLASS (settings), NULL);
223 for (p = pspecs; *p; p++)
224 if ((*p)->owner_type == G_OBJECT_TYPE (settings))
226 settings->property_values = g_new0 (GtkSettingsPropertyValue, i);
228 g_object_freeze_notify (G_OBJECT (settings));
229 for (p = pspecs; *p; p++)
231 GParamSpec *pspec = *p;
233 if (pspec->owner_type != G_OBJECT_TYPE (settings))
235 g_value_init (&settings->property_values[i].value, G_PARAM_SPEC_VALUE_TYPE (pspec));
236 g_param_value_set_default (pspec, &settings->property_values[i].value);
237 g_object_notify (G_OBJECT (settings), pspec->name);
238 settings->property_values[i].source = GTK_SETTINGS_SOURCE_DEFAULT;
241 g_object_thaw_notify (G_OBJECT (settings));
246 gtk_settings_class_init (GtkSettingsClass *class)
248 GObjectClass *gobject_class = G_OBJECT_CLASS (class);
251 parent_class = g_type_class_peek_parent (class);
253 gobject_class->finalize = gtk_settings_finalize;
254 gobject_class->get_property = gtk_settings_get_property;
255 gobject_class->set_property = gtk_settings_set_property;
256 gobject_class->notify = gtk_settings_notify;
258 quark_property_parser = g_quark_from_static_string ("gtk-rc-property-parser");
260 result = settings_install_property_parser (class,
261 g_param_spec_int ("gtk-double-click-time",
262 P_("Double Click Time"),
263 P_("Maximum time allowed between two clicks for them to be considered a double click (in milliseconds)"),
267 g_assert (result == PROP_DOUBLE_CLICK_TIME);
268 result = settings_install_property_parser (class,
269 g_param_spec_int ("gtk-double-click-distance",
270 P_("Double Click Distance"),
271 P_("Maximum distance allowed between two clicks for them to be considered a double click (in pixels)"),
275 g_assert (result == PROP_DOUBLE_CLICK_DISTANCE);
276 result = settings_install_property_parser (class,
277 g_param_spec_boolean ("gtk-cursor-blink",
279 P_("Whether the cursor should blink"),
283 g_assert (result == PROP_CURSOR_BLINK);
284 result = settings_install_property_parser (class,
285 g_param_spec_int ("gtk-cursor-blink-time",
286 P_("Cursor Blink Time"),
287 P_("Length of the cursor blink cycle, in milleseconds"),
291 g_assert (result == PROP_CURSOR_BLINK_TIME);
292 result = settings_install_property_parser (class,
293 g_param_spec_boolean ("gtk-split-cursor",
295 P_("Whether two cursors should be displayed for mixed left-to-right and right-to-left text"),
299 g_assert (result == PROP_SPLIT_CURSOR);
300 result = settings_install_property_parser (class,
301 g_param_spec_string ("gtk-theme-name",
303 P_("Name of theme RC file to load"),
307 g_assert (result == PROP_THEME_NAME);
308 result = settings_install_property_parser (class,
309 g_param_spec_string ("gtk-icon-theme-name",
310 P_("Icon Theme Name"),
311 P_("Name of icon theme to use"),
315 g_assert (result == PROP_ICON_THEME_NAME);
317 result = settings_install_property_parser (class,
318 g_param_spec_string ("gtk-key-theme-name",
319 P_("Key Theme Name"),
320 P_("Name of key theme RC file to load"),
324 g_assert (result == PROP_KEY_THEME_NAME);
326 result = settings_install_property_parser (class,
327 g_param_spec_string ("gtk-menu-bar-accel",
328 P_("Menu bar accelerator"),
329 P_("Keybinding to activate the menu bar"),
333 g_assert (result == PROP_MENU_BAR_ACCEL);
335 result = settings_install_property_parser (class,
336 g_param_spec_int ("gtk-dnd-drag-threshold",
337 P_("Drag threshold"),
338 P_("Number of pixels the cursor can move before dragging"),
342 g_assert (result == PROP_DND_DRAG_THRESHOLD);
344 result = settings_install_property_parser (class,
345 g_param_spec_string ("gtk-font-name",
347 P_("Name of default font to use"),
351 g_assert (result == PROP_FONT_NAME);
353 result = settings_install_property_parser (class,
354 g_param_spec_string ("gtk-icon-sizes",
356 P_("List of icon sizes (gtk-menu=16,16;gtk-button=20,20..."),
360 g_assert (result == PROP_ICON_SIZES);
362 #ifdef GDK_WINDOWING_X11
363 result = settings_install_property_parser (class,
364 g_param_spec_int ("gtk-xft-antialias",
366 P_("Whether to antialias Xft fonts; 0=no, 1=yes, -1=default"),
371 g_assert (result == PROP_XFT_ANTIALIAS);
373 result = settings_install_property_parser (class,
374 g_param_spec_int ("gtk-xft-hinting",
376 P_("Whether to hint Xft fonts; 0=no, 1=yes, -1=default"),
381 g_assert (result == PROP_XFT_HINTING);
383 result = settings_install_property_parser (class,
384 g_param_spec_string ("gtk-xft-hintstyle",
385 P_("Xft Hint Style"),
386 P_("What degree of hinting to use; none, slight, medium, or full"),
391 g_assert (result == PROP_XFT_HINTSTYLE);
393 result = settings_install_property_parser (class,
394 g_param_spec_string ("gtk-xft-rgba",
396 P_("Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr"),
401 g_assert (result == PROP_XFT_RGBA);
403 result = settings_install_property_parser (class,
404 g_param_spec_int ("gtk-xft-dpi",
406 P_("Resolution for Xft, in 1024 * dots/inch. -1 to use default value"),
411 g_assert (result == PROP_XFT_DPI);
412 #endif /* GDK_WINDOWING_X11 */
416 gtk_settings_finalize (GObject *object)
418 GtkSettings *settings = GTK_SETTINGS (object);
421 object_list = g_slist_remove (object_list, settings);
423 for (i = 0; i < class_n_properties; i++)
424 g_value_unset (&settings->property_values[i].value);
425 g_free (settings->property_values);
427 g_datalist_clear (&settings->queued_settings);
429 G_OBJECT_CLASS (parent_class)->finalize (object);
433 * gtk_settings_get_for_screen:
434 * @screen : a #GdkScreen.
436 * Gets the #GtkSettings object for @screen, creating it if necessary.
438 * Return value: a #GtkSettings object.
443 gtk_settings_get_for_screen (GdkScreen *screen)
445 GtkSettings *settings;
447 g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
449 settings = g_object_get_data (G_OBJECT (screen), "gtk-settings");
452 settings = g_object_new (GTK_TYPE_SETTINGS, NULL);
453 settings->screen = screen;
454 g_object_set_data (G_OBJECT (screen), "gtk-settings", settings);
456 #ifdef GDK_WINDOWING_X11
457 /* Set the default substitution function for the Pango fontmap.
459 pango_xft_set_default_substitute (GDK_SCREEN_XDISPLAY (screen),
460 GDK_SCREEN_XNUMBER (screen),
461 gtk_default_substitute,
463 #endif /* GDK_WINDOWING_X11 */
465 gtk_rc_reparse_all_for_settings (settings, TRUE);
466 settings_update_double_click (settings);
473 * gtk_settings_get_default:
475 * Gets the #GtkSettings object for the default GDK screen, creating
476 * it if necessary. See gtk_settings_get_for_screen().
478 * Return value: a #GtkSettings object. If there is no default
479 * screen, then returns %NULL.
482 gtk_settings_get_default (void)
484 GdkScreen *screen = gdk_screen_get_default ();
487 return gtk_settings_get_for_screen (screen);
493 gtk_settings_set_property (GObject *object,
498 GtkSettings *settings = GTK_SETTINGS (object);
500 g_value_copy (value, &settings->property_values[property_id - 1].value);
501 settings->property_values[property_id - 1].source = GTK_SETTINGS_SOURCE_APPLICATION;
505 gtk_settings_get_property (GObject *object,
510 GtkSettings *settings = GTK_SETTINGS (object);
511 GType value_type = G_VALUE_TYPE (value);
512 GType fundamental_type = G_TYPE_FUNDAMENTAL (value_type);
514 /* For enums and strings, we need to get the value as a string,
515 * not as an int, since we support using names/nicks as the setting
518 if ((g_value_type_transformable (G_TYPE_INT, value_type) &&
519 !(fundamental_type == G_TYPE_ENUM || fundamental_type == G_TYPE_FLAGS)) ||
520 g_value_type_transformable (G_TYPE_STRING, G_VALUE_TYPE (value)) ||
521 g_value_type_transformable (GDK_TYPE_COLOR, G_VALUE_TYPE (value)))
523 if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION ||
524 !gdk_screen_get_setting (settings->screen, pspec->name, value))
525 g_value_copy (&settings->property_values[property_id - 1].value, value);
527 g_param_value_validate (pspec, value);
533 /* Try to get xsetting as a string and parse it. */
535 g_value_init (&val, G_TYPE_STRING);
537 if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION ||
538 !gdk_screen_get_setting (settings->screen, pspec->name, &val))
540 g_value_copy (&settings->property_values[property_id - 1].value, value);
544 GValue tmp_value = { 0, };
545 GValue gstring_value = { 0, };
546 GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser);
548 g_value_init (&gstring_value, G_TYPE_GSTRING);
550 g_value_set_boxed (&gstring_value,
551 g_string_new (g_value_get_string (&val)));
553 g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
555 if (parser && _gtk_settings_parse_convert (parser, &gstring_value,
558 g_value_copy (&tmp_value, value);
559 g_param_value_validate (pspec, value);
563 g_value_copy (&settings->property_values[property_id - 1].value, value);
566 g_value_unset (&gstring_value);
567 g_value_unset (&tmp_value);
570 g_value_unset (&val);
575 gtk_settings_notify (GObject *object,
578 GtkSettings *settings = GTK_SETTINGS (object);
579 guint property_id = pspec->param_id;
581 if (settings->screen == NULL) /* initialization */
586 case PROP_DOUBLE_CLICK_TIME:
587 case PROP_DOUBLE_CLICK_DISTANCE:
588 settings_update_double_click (settings);
590 #ifdef GDK_WINDOWING_X11
591 case PROP_XFT_ANTIALIAS:
592 case PROP_XFT_HINTING:
593 case PROP_XFT_HINTSTYLE:
596 pango_xft_substitute_changed (GDK_SCREEN_XDISPLAY (settings->screen),
597 GDK_SCREEN_XNUMBER (settings->screen));
598 /* This is a hack because with gtk_rc_reset_styles() doesn't get
599 * widgets with gtk_widget_style_set(), and also causes more
600 * recomputation than necessary.
602 gtk_rc_reset_styles (GTK_SETTINGS (object));
604 #endif /* GDK_WINDOWING_X11 */
609 _gtk_settings_parse_convert (GtkRcPropertyParser parser,
610 const GValue *src_value,
614 gboolean success = FALSE;
616 g_return_val_if_fail (G_VALUE_HOLDS (dest_value, G_PARAM_SPEC_VALUE_TYPE (pspec)), FALSE);
621 gboolean free_gstring = TRUE;
623 if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING))
625 gstring = g_value_get_boxed (src_value);
626 free_gstring = FALSE;
628 else if (G_VALUE_HOLDS_LONG (src_value))
630 gstring = g_string_new (NULL);
631 g_string_append_printf (gstring, "%ld", g_value_get_long (src_value));
633 else if (G_VALUE_HOLDS_DOUBLE (src_value))
635 gstring = g_string_new (NULL);
636 g_string_append_printf (gstring, "%f", g_value_get_double (src_value));
638 else if (G_VALUE_HOLDS_STRING (src_value))
640 gchar *tstr = g_strescape (g_value_get_string (src_value), NULL);
642 gstring = g_string_new ("\"");
643 g_string_append (gstring, tstr);
644 g_string_append_c (gstring, '\"');
649 g_return_val_if_fail (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING), FALSE);
650 gstring = NULL; /* silence compiler */
653 success = (parser (pspec, gstring, dest_value) &&
654 !g_param_value_validate (pspec, dest_value));
657 g_string_free (gstring, TRUE);
659 else if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING))
661 if (G_VALUE_HOLDS (dest_value, G_TYPE_STRING))
663 GString *gstring = g_value_get_boxed (src_value);
665 g_value_set_string (dest_value, gstring ? gstring->str : NULL);
666 success = !g_param_value_validate (pspec, dest_value);
669 else if (g_value_type_transformable (G_VALUE_TYPE (src_value), G_VALUE_TYPE (dest_value)))
670 success = g_param_value_convert (pspec, src_value, dest_value, TRUE);
676 apply_queued_setting (GtkSettings *data,
678 GtkSettingsValuePrivate *qvalue)
680 GValue tmp_value = { 0, };
681 GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser);
683 g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
684 if (_gtk_settings_parse_convert (parser, &qvalue->public.value,
687 g_object_set_property (G_OBJECT (data), pspec->name, &tmp_value);
688 data->property_values[pspec->param_id - 1].source = qvalue->source;
692 gchar *debug = g_strdup_value_contents (&qvalue->public.value);
694 g_message ("%s: failed to retrieve property `%s' of type `%s' from rc file value \"%s\" of type `%s'",
695 qvalue->public.origin,
697 g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)),
699 G_VALUE_TYPE_NAME (&tmp_value));
702 g_value_unset (&tmp_value);
706 settings_install_property_parser (GtkSettingsClass *class,
708 GtkRcPropertyParser parser)
712 switch (G_TYPE_FUNDAMENTAL (G_PARAM_SPEC_VALUE_TYPE (pspec)))
728 g_warning (G_STRLOC ": parser needs to be specified for property \"%s\" of type `%s'",
729 pspec->name, g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)));
733 if (g_object_class_find_property (G_OBJECT_CLASS (class), pspec->name))
735 g_warning (G_STRLOC ": an rc-data property \"%s\" already exists",
740 for (node = object_list; node; node = node->next)
741 g_object_freeze_notify (node->data);
743 g_object_class_install_property (G_OBJECT_CLASS (class), ++class_n_properties, pspec);
744 g_param_spec_set_qdata (pspec, quark_property_parser, (gpointer) parser);
746 for (node = object_list; node; node = node->next)
748 GtkSettings *settings = node->data;
749 GtkSettingsValuePrivate *qvalue;
751 settings->property_values = g_renew (GtkSettingsPropertyValue, settings->property_values, class_n_properties);
752 settings->property_values[class_n_properties - 1].value.g_type = 0;
753 g_value_init (&settings->property_values[class_n_properties - 1].value, G_PARAM_SPEC_VALUE_TYPE (pspec));
754 g_param_value_set_default (pspec, &settings->property_values[class_n_properties - 1].value);
755 settings->property_values[class_n_properties - 1].source = GTK_SETTINGS_SOURCE_DEFAULT;
756 g_object_notify (G_OBJECT (settings), pspec->name);
758 qvalue = g_datalist_get_data (&settings->queued_settings, pspec->name);
760 apply_queued_setting (settings, pspec, qvalue);
763 for (node = object_list; node; node = next)
766 g_object_thaw_notify (node->data);
769 return class_n_properties;
773 _gtk_rc_property_parser_from_type (GType type)
775 if (type == GDK_TYPE_COLOR)
776 return gtk_rc_property_parse_color;
777 else if (type == GTK_TYPE_REQUISITION)
778 return gtk_rc_property_parse_requisition;
779 else if (type == GTK_TYPE_BORDER)
780 return gtk_rc_property_parse_border;
781 else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_ENUM && G_TYPE_IS_DERIVED (type))
782 return gtk_rc_property_parse_enum;
783 else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_FLAGS && G_TYPE_IS_DERIVED (type))
784 return gtk_rc_property_parse_flags;
790 gtk_settings_install_property (GParamSpec *pspec)
792 GtkRcPropertyParser parser;
794 g_return_if_fail (G_IS_PARAM_SPEC (pspec));
796 parser = _gtk_rc_property_parser_from_type (G_PARAM_SPEC_VALUE_TYPE (pspec));
798 settings_install_property_parser (gtk_type_class (GTK_TYPE_SETTINGS), pspec, parser);
802 gtk_settings_install_property_parser (GParamSpec *pspec,
803 GtkRcPropertyParser parser)
805 g_return_if_fail (G_IS_PARAM_SPEC (pspec));
806 g_return_if_fail (parser != NULL);
808 settings_install_property_parser (gtk_type_class (GTK_TYPE_SETTINGS), pspec, parser);
812 free_value (gpointer data)
814 GtkSettingsValuePrivate *qvalue = data;
816 g_value_unset (&qvalue->public.value);
817 g_free (qvalue->public.origin);
822 gtk_settings_set_property_value_internal (GtkSettings *settings,
823 const gchar *prop_name,
824 const GtkSettingsValue *new_value,
825 GtkSettingsSource source)
827 GtkSettingsValuePrivate *qvalue;
832 if (!G_VALUE_HOLDS_LONG (&new_value->value) &&
833 !G_VALUE_HOLDS_DOUBLE (&new_value->value) &&
834 !G_VALUE_HOLDS_STRING (&new_value->value) &&
835 !G_VALUE_HOLDS (&new_value->value, G_TYPE_GSTRING))
837 g_warning (G_STRLOC ": value type invalid");
841 name = g_strdup (prop_name);
842 g_strcanon (name, G_CSET_A_2_Z G_CSET_a_2_z G_CSET_DIGITS "-", '-');
843 name_quark = g_quark_from_string (name);
846 qvalue = g_datalist_id_get_data (&settings->queued_settings, name_quark);
849 qvalue = g_new0 (GtkSettingsValuePrivate, 1);
850 g_datalist_id_set_data_full (&settings->queued_settings, name_quark, qvalue, free_value);
854 g_free (qvalue->public.origin);
855 g_value_unset (&qvalue->public.value);
857 qvalue->public.origin = g_strdup (new_value->origin);
858 g_value_init (&qvalue->public.value, G_VALUE_TYPE (&new_value->value));
859 g_value_copy (&new_value->value, &qvalue->public.value);
860 qvalue->source = source;
861 pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (settings), g_quark_to_string (name_quark));
863 apply_queued_setting (settings, pspec, qvalue);
867 gtk_settings_set_property_value (GtkSettings *settings,
868 const gchar *prop_name,
869 const GtkSettingsValue *new_value)
871 g_return_if_fail (GTK_SETTINGS (settings));
872 g_return_if_fail (prop_name != NULL);
873 g_return_if_fail (new_value != NULL);
874 g_return_if_fail (new_value->origin != NULL);
876 gtk_settings_set_property_value_internal (settings, prop_name, new_value,
877 GTK_SETTINGS_SOURCE_APPLICATION);
881 _gtk_settings_set_property_value_from_rc (GtkSettings *settings,
882 const gchar *prop_name,
883 const GtkSettingsValue *new_value)
885 g_return_if_fail (GTK_SETTINGS (settings));
886 g_return_if_fail (prop_name != NULL);
887 g_return_if_fail (new_value != NULL);
888 g_return_if_fail (new_value->origin != NULL);
890 gtk_settings_set_property_value_internal (settings, prop_name, new_value,
891 GTK_SETTINGS_SOURCE_RC_FILE);
895 gtk_settings_set_string_property (GtkSettings *settings,
897 const gchar *v_string,
900 GtkSettingsValue svalue = { NULL, { 0, }, };
902 g_return_if_fail (GTK_SETTINGS (settings));
903 g_return_if_fail (name != NULL);
904 g_return_if_fail (v_string != NULL);
905 g_return_if_fail (origin != NULL);
907 svalue.origin = (gchar*) origin;
908 g_value_init (&svalue.value, G_TYPE_STRING);
909 g_value_set_static_string (&svalue.value, v_string);
910 gtk_settings_set_property_value (settings, name, &svalue);
911 g_value_unset (&svalue.value);
915 gtk_settings_set_long_property (GtkSettings *settings,
920 GtkSettingsValue svalue = { NULL, { 0, }, };
922 g_return_if_fail (GTK_SETTINGS (settings));
923 g_return_if_fail (name != NULL);
924 g_return_if_fail (origin != NULL);
926 svalue.origin = (gchar*) origin;
927 g_value_init (&svalue.value, G_TYPE_LONG);
928 g_value_set_long (&svalue.value, v_long);
929 gtk_settings_set_property_value (settings, name, &svalue);
930 g_value_unset (&svalue.value);
934 gtk_settings_set_double_property (GtkSettings *settings,
939 GtkSettingsValue svalue = { NULL, { 0, }, };
941 g_return_if_fail (GTK_SETTINGS (settings));
942 g_return_if_fail (name != NULL);
943 g_return_if_fail (origin != NULL);
945 svalue.origin = (gchar*) origin;
946 g_value_init (&svalue.value, G_TYPE_DOUBLE);
947 g_value_set_double (&svalue.value, v_double);
948 gtk_settings_set_property_value (settings, name, &svalue);
949 g_value_unset (&svalue.value);
953 * gtk_rc_property_parse_color:
954 * @pspec: a #GParamSpec
955 * @gstring: the #GString to be parsed
956 * @property_value: a #GValue which must hold #GdkColor values.
958 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
959 * or gtk_widget_class_install_style_property_parser() which parses a
960 * color given either by its name or in the form
961 * <literal>{ red, green, blue }</literal> where %red, %green and
962 * %blue are integers between 0 and 65535 or floating-point numbers
965 * Return value: %TRUE if @gstring could be parsed and @property_value
966 * has been set to the resulting #GdkColor.
969 gtk_rc_property_parse_color (const GParamSpec *pspec,
970 const GString *gstring,
971 GValue *property_value)
973 GdkColor color = { 0, 0, 0, 0, };
977 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
978 g_return_val_if_fail (G_VALUE_HOLDS (property_value, GDK_TYPE_COLOR), FALSE);
980 scanner = gtk_rc_scanner_new ();
981 g_scanner_input_text (scanner, gstring->str, gstring->len);
982 if (gtk_rc_parse_color (scanner, &color) == G_TOKEN_NONE &&
983 g_scanner_get_next_token (scanner) == G_TOKEN_EOF)
985 g_value_set_boxed (property_value, &color);
990 g_scanner_destroy (scanner);
996 * gtk_rc_property_parse_enum:
997 * @pspec: a #GParamSpec
998 * @gstring: the #GString to be parsed
999 * @property_value: a #GValue which must hold enum values.
1001 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1002 * or gtk_widget_class_install_style_property_parser() which parses a single
1003 * enumeration value.
1005 * The enumeration value can be specified by its name, its nickname or
1006 * its numeric value. For consistency with flags parsing, the value
1007 * may be surrounded by parentheses.
1009 * Return value: %TRUE if @gstring could be parsed and @property_value
1010 * has been set to the resulting #GEnumValue.
1013 gtk_rc_property_parse_enum (const GParamSpec *pspec,
1014 const GString *gstring,
1015 GValue *property_value)
1017 gboolean need_closing_brace = FALSE, success = FALSE;
1019 GEnumValue *enum_value = NULL;
1021 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1022 g_return_val_if_fail (G_VALUE_HOLDS_ENUM (property_value), FALSE);
1024 scanner = gtk_rc_scanner_new ();
1025 g_scanner_input_text (scanner, gstring->str, gstring->len);
1027 /* we just want to parse _one_ value, but for consistency with flags parsing
1028 * we support optional parenthesis
1030 g_scanner_get_next_token (scanner);
1031 if (scanner->token == '(')
1033 need_closing_brace = TRUE;
1034 g_scanner_get_next_token (scanner);
1036 if (scanner->token == G_TOKEN_IDENTIFIER)
1038 GEnumClass *class = G_PARAM_SPEC_ENUM (pspec)->enum_class;
1040 enum_value = g_enum_get_value_by_name (class, scanner->value.v_identifier);
1042 enum_value = g_enum_get_value_by_nick (class, scanner->value.v_identifier);
1045 g_value_set_enum (property_value, enum_value->value);
1049 else if (scanner->token == G_TOKEN_INT)
1051 g_value_set_enum (property_value, scanner->value.v_int);
1054 if (need_closing_brace && g_scanner_get_next_token (scanner) != ')')
1056 if (g_scanner_get_next_token (scanner) != G_TOKEN_EOF)
1059 g_scanner_destroy (scanner);
1065 parse_flags_value (GScanner *scanner,
1069 g_scanner_get_next_token (scanner);
1070 if (scanner->token == G_TOKEN_IDENTIFIER)
1072 GFlagsValue *flags_value;
1074 flags_value = g_flags_get_value_by_name (class, scanner->value.v_identifier);
1076 flags_value = g_flags_get_value_by_nick (class, scanner->value.v_identifier);
1079 *number |= flags_value->value;
1080 return G_TOKEN_NONE;
1083 else if (scanner->token == G_TOKEN_INT)
1085 *number |= scanner->value.v_int;
1086 return G_TOKEN_NONE;
1088 return G_TOKEN_IDENTIFIER;
1092 * gtk_rc_property_parse_flags:
1093 * @pspec: a #GParamSpec
1094 * @gstring: the #GString to be parsed
1095 * @property_value: a #GValue which must hold flags values.
1097 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1098 * or gtk_widget_class_install_style_property_parser() which parses flags.
1100 * Flags can be specified by their name, their nickname or
1101 * numerically. Multiple flags can be specified in the form
1102 * <literal>"( flag1 | flag2 | ... )"</literal>.
1104 * Return value: %TRUE if @gstring could be parsed and @property_value
1105 * has been set to the resulting flags value.
1108 gtk_rc_property_parse_flags (const GParamSpec *pspec,
1109 const GString *gstring,
1110 GValue *property_value)
1113 gboolean success = FALSE;
1116 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1117 g_return_val_if_fail (G_VALUE_HOLDS_FLAGS (property_value), FALSE);
1119 class = G_PARAM_SPEC_FLAGS (pspec)->flags_class;
1120 scanner = gtk_rc_scanner_new ();
1121 g_scanner_input_text (scanner, gstring->str, gstring->len);
1123 /* parse either a single flags value or a "\( ... [ \| ... ] \)" compound */
1124 if (g_scanner_peek_next_token (scanner) == G_TOKEN_IDENTIFIER ||
1125 scanner->next_token == G_TOKEN_INT)
1127 guint token, flags_value = 0;
1129 token = parse_flags_value (scanner, class, &flags_value);
1131 if (token == G_TOKEN_NONE && g_scanner_peek_next_token (scanner) == G_TOKEN_EOF)
1134 g_value_set_flags (property_value, flags_value);
1138 else if (g_scanner_get_next_token (scanner) == '(')
1140 guint token, flags_value = 0;
1142 /* parse first value */
1143 token = parse_flags_value (scanner, class, &flags_value);
1145 /* parse nth values, preceeded by '|' */
1146 while (token == G_TOKEN_NONE && g_scanner_get_next_token (scanner) == '|')
1147 token = parse_flags_value (scanner, class, &flags_value);
1149 /* done, last token must have closed expression */
1150 if (token == G_TOKEN_NONE && scanner->token == ')' &&
1151 g_scanner_peek_next_token (scanner) == G_TOKEN_EOF)
1153 g_value_set_flags (property_value, flags_value);
1157 g_scanner_destroy (scanner);
1163 get_braced_int (GScanner *scanner,
1170 g_scanner_get_next_token (scanner);
1171 if (scanner->token != '{')
1175 g_scanner_get_next_token (scanner);
1176 if (scanner->token != G_TOKEN_INT)
1179 *value = scanner->value.v_int;
1183 g_scanner_get_next_token (scanner);
1184 if (scanner->token != '}')
1189 g_scanner_get_next_token (scanner);
1190 if (scanner->token != ',')
1198 * gtk_rc_property_parse_requisition:
1199 * @pspec: a #GParamSpec
1200 * @gstring: the #GString to be parsed
1201 * @property_value: a #GValue which must hold boxed values.
1203 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1204 * or gtk_widget_class_install_style_property_parser() which parses a
1205 * requisition in the form
1206 * <literal>"{ width, height }"</literal> for integers %width and %height.
1208 * Return value: %TRUE if @gstring could be parsed and @property_value
1209 * has been set to the resulting #GtkRequisition.
1212 gtk_rc_property_parse_requisition (const GParamSpec *pspec,
1213 const GString *gstring,
1214 GValue *property_value)
1216 GtkRequisition requisition;
1218 gboolean success = FALSE;
1220 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1221 g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE);
1223 scanner = gtk_rc_scanner_new ();
1224 g_scanner_input_text (scanner, gstring->str, gstring->len);
1226 if (get_braced_int (scanner, TRUE, FALSE, &requisition.width) &&
1227 get_braced_int (scanner, FALSE, TRUE, &requisition.height))
1229 g_value_set_boxed (property_value, &requisition);
1233 g_scanner_destroy (scanner);
1239 * gtk_rc_property_parse_border:
1240 * @pspec: a #GParamSpec
1241 * @gstring: the #GString to be parsed
1242 * @property_value: a #GValue which must hold boxed values.
1244 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1245 * or gtk_widget_class_install_style_property_parser() which parses
1246 * borders in the form
1247 * <literal>"{ left, right, top, bottom }"</literal> for integers
1248 * %left, %right, %top and %bottom.
1250 * Return value: %TRUE if @gstring could be parsed and @property_value
1251 * has been set to the resulting #GtkBorder.
1254 gtk_rc_property_parse_border (const GParamSpec *pspec,
1255 const GString *gstring,
1256 GValue *property_value)
1260 gboolean success = FALSE;
1262 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1263 g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE);
1265 scanner = gtk_rc_scanner_new ();
1266 g_scanner_input_text (scanner, gstring->str, gstring->len);
1268 if (get_braced_int (scanner, TRUE, FALSE, &border.left) &&
1269 get_braced_int (scanner, FALSE, FALSE, &border.right) &&
1270 get_braced_int (scanner, FALSE, FALSE, &border.top) &&
1271 get_braced_int (scanner, FALSE, TRUE, &border.bottom))
1273 g_value_set_boxed (property_value, &border);
1277 g_scanner_destroy (scanner);
1283 _gtk_settings_handle_event (GdkEventSetting *event)
1285 GtkSettings *settings = gtk_settings_get_for_screen (gdk_drawable_get_screen (event->window));
1287 if (g_object_class_find_property (G_OBJECT_GET_CLASS (settings), event->name))
1288 g_object_notify (G_OBJECT (settings), event->name);
1292 reset_rc_values_foreach (GQuark key_id,
1296 GtkSettingsValuePrivate *qvalue = data;
1297 GSList **to_reset = user_data;
1299 if (qvalue->source == GTK_SETTINGS_SOURCE_RC_FILE)
1300 *to_reset = g_slist_prepend (*to_reset, GUINT_TO_POINTER (key_id));
1304 _gtk_settings_reset_rc_values (GtkSettings *settings)
1306 GSList *to_reset = NULL;
1308 GParamSpec **pspecs, **p;
1311 /* Remove any queued settings
1313 g_datalist_foreach (&settings->queued_settings,
1314 reset_rc_values_foreach,
1317 for (tmp_list = to_reset; tmp_list; tmp_list = tmp_list->next)
1319 GQuark key_id = GPOINTER_TO_UINT (tmp_list->data);
1320 g_datalist_id_remove_data (&settings->queued_settings, key_id);
1323 /* Now reset the active settings
1325 pspecs = g_object_class_list_properties (G_OBJECT_GET_CLASS (settings), NULL);
1328 g_object_freeze_notify (G_OBJECT (settings));
1329 for (p = pspecs; *p; p++)
1331 if (settings->property_values[i].source == GTK_SETTINGS_SOURCE_RC_FILE)
1333 GParamSpec *pspec = *p;
1335 g_param_value_set_default (pspec, &settings->property_values[i].value);
1336 g_object_notify (G_OBJECT (settings), pspec->name);
1340 g_object_thaw_notify (G_OBJECT (settings));
1345 settings_update_double_click (GtkSettings *settings)
1347 if (gdk_screen_get_number (settings->screen) == 0)
1349 GdkDisplay *display = gdk_screen_get_display (settings->screen);
1350 gint double_click_time;
1351 gint double_click_distance;
1353 g_object_get (settings,
1354 "gtk-double-click-time", &double_click_time,
1355 "gtk-double-click-distance", &double_click_distance,
1358 gdk_display_set_double_click_time (display, double_click_time);
1359 gdk_display_set_double_click_distance (display, double_click_distance);