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.
23 #include "gtkmodules.h"
24 #include "gtksettings.h"
27 #include "gtkwidget.h"
28 #include "gtkprivate.h"
31 #ifdef GDK_WINDOWING_X11
35 typedef struct _GtkSettingsValuePrivate GtkSettingsValuePrivate;
39 GTK_SETTINGS_SOURCE_DEFAULT,
40 GTK_SETTINGS_SOURCE_RC_FILE,
41 GTK_SETTINGS_SOURCE_APPLICATION
44 struct _GtkSettingsValuePrivate
46 GtkSettingsValue public;
47 GtkSettingsSource source;
50 struct _GtkSettingsPropertyValue
53 GtkSettingsSource source;
58 PROP_DOUBLE_CLICK_TIME,
59 PROP_DOUBLE_CLICK_DISTANCE,
61 PROP_CURSOR_BLINK_TIME,
67 PROP_DND_DRAG_THRESHOLD,
71 #ifdef GDK_WINDOWING_X11
77 PROP_CURSOR_THEME_NAME,
78 PROP_CURSOR_THEME_SIZE,
80 PROP_ALTERNATIVE_BUTTON_ORDER
84 /* --- prototypes --- */
85 static void gtk_settings_init (GtkSettings *settings);
86 static void gtk_settings_class_init (GtkSettingsClass *class);
87 static void gtk_settings_finalize (GObject *object);
88 static void gtk_settings_get_property (GObject *object,
92 static void gtk_settings_set_property (GObject *object,
96 static void gtk_settings_notify (GObject *object,
98 static guint settings_install_property_parser (GtkSettingsClass *class,
100 GtkRcPropertyParser parser);
101 static void settings_update_double_click (GtkSettings *settings);
102 static void settings_update_modules (GtkSettings *settings);
104 #ifdef GDK_WINDOWING_X11
105 static void settings_update_cursor_theme (GtkSettings *settings);
106 static void settings_update_resolution (GtkSettings *settings);
107 static void settings_update_font_options (GtkSettings *settings);
112 /* --- variables --- */
113 static gpointer parent_class = NULL;
114 static GQuark quark_property_parser = 0;
115 static GSList *object_list = NULL;
116 static guint class_n_properties = 0;
119 /* --- functions --- */
121 gtk_settings_get_type (void)
123 static GType settings_type = 0;
127 static const GTypeInfo settings_info =
129 sizeof (GtkSettingsClass),
130 NULL, /* base_init */
131 NULL, /* base_finalize */
132 (GClassInitFunc) gtk_settings_class_init,
133 NULL, /* class_finalize */
134 NULL, /* class_data */
135 sizeof (GtkSettings),
137 (GInstanceInitFunc) gtk_settings_init,
140 settings_type = g_type_register_static (G_TYPE_OBJECT, I_("GtkSettings"),
144 return settings_type;
148 gtk_settings_init (GtkSettings *settings)
150 GParamSpec **pspecs, **p;
153 g_datalist_init (&settings->queued_settings);
154 object_list = g_slist_prepend (object_list, settings);
156 /* build up property array for all yet existing properties and queue
157 * notification for them (at least notification for internal properties
158 * will instantly be caught)
160 pspecs = g_object_class_list_properties (G_OBJECT_GET_CLASS (settings), NULL);
161 for (p = pspecs; *p; p++)
162 if ((*p)->owner_type == G_OBJECT_TYPE (settings))
164 settings->property_values = g_new0 (GtkSettingsPropertyValue, i);
166 g_object_freeze_notify (G_OBJECT (settings));
167 for (p = pspecs; *p; p++)
169 GParamSpec *pspec = *p;
171 if (pspec->owner_type != G_OBJECT_TYPE (settings))
173 g_value_init (&settings->property_values[i].value, G_PARAM_SPEC_VALUE_TYPE (pspec));
174 g_param_value_set_default (pspec, &settings->property_values[i].value);
175 g_object_notify (G_OBJECT (settings), pspec->name);
176 settings->property_values[i].source = GTK_SETTINGS_SOURCE_DEFAULT;
179 g_object_thaw_notify (G_OBJECT (settings));
184 gtk_settings_class_init (GtkSettingsClass *class)
186 GObjectClass *gobject_class = G_OBJECT_CLASS (class);
189 parent_class = g_type_class_peek_parent (class);
191 gobject_class->finalize = gtk_settings_finalize;
192 gobject_class->get_property = gtk_settings_get_property;
193 gobject_class->set_property = gtk_settings_set_property;
194 gobject_class->notify = gtk_settings_notify;
196 quark_property_parser = g_quark_from_static_string ("gtk-rc-property-parser");
198 result = settings_install_property_parser (class,
199 g_param_spec_int ("gtk-double-click-time",
200 P_("Double Click Time"),
201 P_("Maximum time allowed between two clicks for them to be considered a double click (in milliseconds)"),
203 GTK_PARAM_READWRITE),
205 g_assert (result == PROP_DOUBLE_CLICK_TIME);
206 result = settings_install_property_parser (class,
207 g_param_spec_int ("gtk-double-click-distance",
208 P_("Double Click Distance"),
209 P_("Maximum distance allowed between two clicks for them to be considered a double click (in pixels)"),
211 GTK_PARAM_READWRITE),
213 g_assert (result == PROP_DOUBLE_CLICK_DISTANCE);
214 result = settings_install_property_parser (class,
215 g_param_spec_boolean ("gtk-cursor-blink",
217 P_("Whether the cursor should blink"),
219 GTK_PARAM_READWRITE),
221 g_assert (result == PROP_CURSOR_BLINK);
222 result = settings_install_property_parser (class,
223 g_param_spec_int ("gtk-cursor-blink-time",
224 P_("Cursor Blink Time"),
225 P_("Length of the cursor blink cycle, in milleseconds"),
227 GTK_PARAM_READWRITE),
229 g_assert (result == PROP_CURSOR_BLINK_TIME);
230 result = settings_install_property_parser (class,
231 g_param_spec_boolean ("gtk-split-cursor",
233 P_("Whether two cursors should be displayed for mixed left-to-right and right-to-left text"),
235 GTK_PARAM_READWRITE),
237 g_assert (result == PROP_SPLIT_CURSOR);
238 result = settings_install_property_parser (class,
239 g_param_spec_string ("gtk-theme-name",
241 P_("Name of theme RC file to load"),
243 GTK_PARAM_READWRITE),
245 g_assert (result == PROP_THEME_NAME);
246 result = settings_install_property_parser (class,
247 g_param_spec_string ("gtk-icon-theme-name",
248 P_("Icon Theme Name"),
249 P_("Name of icon theme to use"),
251 GTK_PARAM_READWRITE),
253 g_assert (result == PROP_ICON_THEME_NAME);
255 result = settings_install_property_parser (class,
256 g_param_spec_string ("gtk-key-theme-name",
257 P_("Key Theme Name"),
258 P_("Name of key theme RC file to load"),
260 GTK_PARAM_READWRITE),
262 g_assert (result == PROP_KEY_THEME_NAME);
264 result = settings_install_property_parser (class,
265 g_param_spec_string ("gtk-menu-bar-accel",
266 P_("Menu bar accelerator"),
267 P_("Keybinding to activate the menu bar"),
269 GTK_PARAM_READWRITE),
271 g_assert (result == PROP_MENU_BAR_ACCEL);
273 result = settings_install_property_parser (class,
274 g_param_spec_int ("gtk-dnd-drag-threshold",
275 P_("Drag threshold"),
276 P_("Number of pixels the cursor can move before dragging"),
278 GTK_PARAM_READWRITE),
280 g_assert (result == PROP_DND_DRAG_THRESHOLD);
282 result = settings_install_property_parser (class,
283 g_param_spec_string ("gtk-font-name",
285 P_("Name of default font to use"),
287 GTK_PARAM_READWRITE),
289 g_assert (result == PROP_FONT_NAME);
291 result = settings_install_property_parser (class,
292 g_param_spec_string ("gtk-icon-sizes",
294 P_("List of icon sizes (gtk-menu=16,16:gtk-button=20,20..."),
296 GTK_PARAM_READWRITE),
298 g_assert (result == PROP_ICON_SIZES);
300 result = settings_install_property_parser (class,
301 g_param_spec_string ("gtk-modules",
303 P_("List of currently active GTK modules"),
305 GTK_PARAM_READWRITE),
307 g_assert (result == PROP_MODULES);
309 #ifdef GDK_WINDOWING_X11
310 result = settings_install_property_parser (class,
311 g_param_spec_int ("gtk-xft-antialias",
313 P_("Whether to antialias Xft fonts; 0=no, 1=yes, -1=default"),
315 GTK_PARAM_READWRITE),
318 g_assert (result == PROP_XFT_ANTIALIAS);
320 result = settings_install_property_parser (class,
321 g_param_spec_int ("gtk-xft-hinting",
323 P_("Whether to hint Xft fonts; 0=no, 1=yes, -1=default"),
325 GTK_PARAM_READWRITE),
328 g_assert (result == PROP_XFT_HINTING);
330 result = settings_install_property_parser (class,
331 g_param_spec_string ("gtk-xft-hintstyle",
332 P_("Xft Hint Style"),
333 P_("What degree of hinting to use; hintnone, hintslight, hintmedium, or hintfull"),
335 GTK_PARAM_READWRITE),
338 g_assert (result == PROP_XFT_HINTSTYLE);
340 result = settings_install_property_parser (class,
341 g_param_spec_string ("gtk-xft-rgba",
343 P_("Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr"),
345 GTK_PARAM_READWRITE),
348 g_assert (result == PROP_XFT_RGBA);
350 result = settings_install_property_parser (class,
351 g_param_spec_int ("gtk-xft-dpi",
353 P_("Resolution for Xft, in 1024 * dots/inch. -1 to use default value"),
355 GTK_PARAM_READWRITE),
358 g_assert (result == PROP_XFT_DPI);
360 result = settings_install_property_parser (class,
361 g_param_spec_string ("gtk-cursor-theme-name",
362 P_("Cursor theme name"),
363 P_("Name of the cursor theme to use"),
365 GTK_PARAM_READWRITE),
367 g_assert (result == PROP_CURSOR_THEME_NAME);
369 result = settings_install_property_parser (class,
370 g_param_spec_int ("gtk-cursor-theme-size",
371 P_("Cursor theme size"),
372 P_("Size to use for cursors"),
374 GTK_PARAM_READWRITE),
377 g_assert (result == PROP_CURSOR_THEME_SIZE);
379 #endif /* GDK_WINDOWING_X11 */
380 result = settings_install_property_parser (class,
381 g_param_spec_boolean ("gtk-alternative-button-order",
382 P_("Alternative button order"),
383 P_("Whether buttons in dialogs should use the alternative button order"),
385 GTK_PARAM_READWRITE),
387 g_assert (result == PROP_ALTERNATIVE_BUTTON_ORDER);
391 gtk_settings_finalize (GObject *object)
393 GtkSettings *settings = GTK_SETTINGS (object);
396 object_list = g_slist_remove (object_list, settings);
398 for (i = 0; i < class_n_properties; i++)
399 g_value_unset (&settings->property_values[i].value);
400 g_free (settings->property_values);
402 g_datalist_clear (&settings->queued_settings);
404 G_OBJECT_CLASS (parent_class)->finalize (object);
408 * gtk_settings_get_for_screen:
409 * @screen : a #GdkScreen.
411 * Gets the #GtkSettings object for @screen, creating it if necessary.
413 * Return value: a #GtkSettings object.
418 gtk_settings_get_for_screen (GdkScreen *screen)
420 GtkSettings *settings;
422 g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
424 settings = g_object_get_data (G_OBJECT (screen), "gtk-settings");
427 settings = g_object_new (GTK_TYPE_SETTINGS, NULL);
428 settings->screen = screen;
429 g_object_set_data (G_OBJECT (screen), I_("gtk-settings"), settings);
431 gtk_rc_reparse_all_for_settings (settings, TRUE);
432 settings_update_double_click (settings);
433 #ifdef GDK_WINDOWING_X11
434 settings_update_cursor_theme (settings);
435 settings_update_resolution (settings);
436 settings_update_font_options (settings);
444 * gtk_settings_get_default:
446 * Gets the #GtkSettings object for the default GDK screen, creating
447 * it if necessary. See gtk_settings_get_for_screen().
449 * Return value: a #GtkSettings object. If there is no default
450 * screen, then returns %NULL.
453 gtk_settings_get_default (void)
455 GdkScreen *screen = gdk_screen_get_default ();
458 return gtk_settings_get_for_screen (screen);
464 gtk_settings_set_property (GObject *object,
469 GtkSettings *settings = GTK_SETTINGS (object);
471 g_value_copy (value, &settings->property_values[property_id - 1].value);
472 settings->property_values[property_id - 1].source = GTK_SETTINGS_SOURCE_APPLICATION;
476 gtk_settings_get_property (GObject *object,
481 GtkSettings *settings = GTK_SETTINGS (object);
482 GType value_type = G_VALUE_TYPE (value);
483 GType fundamental_type = G_TYPE_FUNDAMENTAL (value_type);
485 /* For enums and strings, we need to get the value as a string,
486 * not as an int, since we support using names/nicks as the setting
489 if ((g_value_type_transformable (G_TYPE_INT, value_type) &&
490 !(fundamental_type == G_TYPE_ENUM || fundamental_type == G_TYPE_FLAGS)) ||
491 g_value_type_transformable (G_TYPE_STRING, G_VALUE_TYPE (value)) ||
492 g_value_type_transformable (GDK_TYPE_COLOR, G_VALUE_TYPE (value)))
494 if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION ||
495 !gdk_screen_get_setting (settings->screen, pspec->name, value))
496 g_value_copy (&settings->property_values[property_id - 1].value, value);
498 g_param_value_validate (pspec, value);
504 /* Try to get xsetting as a string and parse it. */
506 g_value_init (&val, G_TYPE_STRING);
508 if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION ||
509 !gdk_screen_get_setting (settings->screen, pspec->name, &val))
511 g_value_copy (&settings->property_values[property_id - 1].value, value);
515 GValue tmp_value = { 0, };
516 GValue gstring_value = { 0, };
517 GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser);
519 g_value_init (&gstring_value, G_TYPE_GSTRING);
521 g_value_take_boxed (&gstring_value,
522 g_string_new (g_value_get_string (&val)));
524 g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
526 if (parser && _gtk_settings_parse_convert (parser, &gstring_value,
529 g_value_copy (&tmp_value, value);
530 g_param_value_validate (pspec, value);
534 g_value_copy (&settings->property_values[property_id - 1].value, value);
537 g_value_unset (&gstring_value);
538 g_value_unset (&tmp_value);
541 g_value_unset (&val);
546 gtk_settings_notify (GObject *object,
549 GtkSettings *settings = GTK_SETTINGS (object);
550 guint property_id = pspec->param_id;
552 if (settings->screen == NULL) /* initialization */
558 settings_update_modules (settings);
560 case PROP_DOUBLE_CLICK_TIME:
561 case PROP_DOUBLE_CLICK_DISTANCE:
562 settings_update_double_click (settings);
564 #ifdef GDK_WINDOWING_X11
566 settings_update_resolution (settings);
567 /* This is a hack because with gtk_rc_reset_styles() doesn't get
568 * widgets with gtk_widget_style_set(), and also causes more
569 * recomputation than necessary.
571 gtk_rc_reset_styles (GTK_SETTINGS (object));
573 case PROP_XFT_ANTIALIAS:
574 case PROP_XFT_HINTING:
575 case PROP_XFT_HINTSTYLE:
577 settings_update_font_options (settings);
578 gtk_rc_reset_styles (GTK_SETTINGS (object));
580 case PROP_CURSOR_THEME_NAME:
581 case PROP_CURSOR_THEME_SIZE:
582 settings_update_cursor_theme (settings);
584 #endif /* GDK_WINDOWING_X11 */
589 _gtk_settings_parse_convert (GtkRcPropertyParser parser,
590 const GValue *src_value,
594 gboolean success = FALSE;
596 g_return_val_if_fail (G_VALUE_HOLDS (dest_value, G_PARAM_SPEC_VALUE_TYPE (pspec)), FALSE);
601 gboolean free_gstring = TRUE;
603 if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING))
605 gstring = g_value_get_boxed (src_value);
606 free_gstring = FALSE;
608 else if (G_VALUE_HOLDS_LONG (src_value))
610 gstring = g_string_new (NULL);
611 g_string_append_printf (gstring, "%ld", g_value_get_long (src_value));
613 else if (G_VALUE_HOLDS_DOUBLE (src_value))
615 gstring = g_string_new (NULL);
616 g_string_append_printf (gstring, "%f", g_value_get_double (src_value));
618 else if (G_VALUE_HOLDS_STRING (src_value))
620 gchar *tstr = g_strescape (g_value_get_string (src_value), NULL);
622 gstring = g_string_new ("\"");
623 g_string_append (gstring, tstr);
624 g_string_append_c (gstring, '\"');
629 g_return_val_if_fail (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING), FALSE);
630 gstring = NULL; /* silence compiler */
633 success = (parser (pspec, gstring, dest_value) &&
634 !g_param_value_validate (pspec, dest_value));
637 g_string_free (gstring, TRUE);
639 else if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING))
641 if (G_VALUE_HOLDS (dest_value, G_TYPE_STRING))
643 GString *gstring = g_value_get_boxed (src_value);
645 g_value_set_string (dest_value, gstring ? gstring->str : NULL);
646 success = !g_param_value_validate (pspec, dest_value);
649 else if (g_value_type_transformable (G_VALUE_TYPE (src_value), G_VALUE_TYPE (dest_value)))
650 success = g_param_value_convert (pspec, src_value, dest_value, TRUE);
656 apply_queued_setting (GtkSettings *data,
658 GtkSettingsValuePrivate *qvalue)
660 GValue tmp_value = { 0, };
661 GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser);
663 g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
664 if (_gtk_settings_parse_convert (parser, &qvalue->public.value,
667 if (data->property_values[pspec->param_id - 1].source <= qvalue->source)
669 g_object_set_property (G_OBJECT (data), pspec->name, &tmp_value);
670 data->property_values[pspec->param_id - 1].source = qvalue->source;
675 gchar *debug = g_strdup_value_contents (&qvalue->public.value);
677 g_message ("%s: failed to retrieve property `%s' of type `%s' from rc file value \"%s\" of type `%s'",
678 qvalue->public.origin,
680 g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)),
682 G_VALUE_TYPE_NAME (&tmp_value));
685 g_value_unset (&tmp_value);
689 settings_install_property_parser (GtkSettingsClass *class,
691 GtkRcPropertyParser parser)
695 switch (G_TYPE_FUNDAMENTAL (G_PARAM_SPEC_VALUE_TYPE (pspec)))
711 g_warning (G_STRLOC ": parser needs to be specified for property \"%s\" of type `%s'",
712 pspec->name, g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)));
716 if (g_object_class_find_property (G_OBJECT_CLASS (class), pspec->name))
718 g_warning (G_STRLOC ": an rc-data property \"%s\" already exists",
723 for (node = object_list; node; node = node->next)
724 g_object_freeze_notify (node->data);
726 g_object_class_install_property (G_OBJECT_CLASS (class), ++class_n_properties, pspec);
727 g_param_spec_set_qdata (pspec, quark_property_parser, (gpointer) parser);
729 for (node = object_list; node; node = node->next)
731 GtkSettings *settings = node->data;
732 GtkSettingsValuePrivate *qvalue;
734 settings->property_values = g_renew (GtkSettingsPropertyValue, settings->property_values, class_n_properties);
735 settings->property_values[class_n_properties - 1].value.g_type = 0;
736 g_value_init (&settings->property_values[class_n_properties - 1].value, G_PARAM_SPEC_VALUE_TYPE (pspec));
737 g_param_value_set_default (pspec, &settings->property_values[class_n_properties - 1].value);
738 settings->property_values[class_n_properties - 1].source = GTK_SETTINGS_SOURCE_DEFAULT;
739 g_object_notify (G_OBJECT (settings), pspec->name);
741 qvalue = g_datalist_get_data (&settings->queued_settings, pspec->name);
743 apply_queued_setting (settings, pspec, qvalue);
746 for (node = object_list; node; node = next)
749 g_object_thaw_notify (node->data);
752 return class_n_properties;
756 _gtk_rc_property_parser_from_type (GType type)
758 if (type == GDK_TYPE_COLOR)
759 return gtk_rc_property_parse_color;
760 else if (type == GTK_TYPE_REQUISITION)
761 return gtk_rc_property_parse_requisition;
762 else if (type == GTK_TYPE_BORDER)
763 return gtk_rc_property_parse_border;
764 else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_ENUM && G_TYPE_IS_DERIVED (type))
765 return gtk_rc_property_parse_enum;
766 else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_FLAGS && G_TYPE_IS_DERIVED (type))
767 return gtk_rc_property_parse_flags;
773 gtk_settings_install_property (GParamSpec *pspec)
775 GtkRcPropertyParser parser;
777 g_return_if_fail (G_IS_PARAM_SPEC (pspec));
779 parser = _gtk_rc_property_parser_from_type (G_PARAM_SPEC_VALUE_TYPE (pspec));
781 settings_install_property_parser (gtk_type_class (GTK_TYPE_SETTINGS), pspec, parser);
785 gtk_settings_install_property_parser (GParamSpec *pspec,
786 GtkRcPropertyParser parser)
788 g_return_if_fail (G_IS_PARAM_SPEC (pspec));
789 g_return_if_fail (parser != NULL);
791 settings_install_property_parser (gtk_type_class (GTK_TYPE_SETTINGS), pspec, parser);
795 free_value (gpointer data)
797 GtkSettingsValuePrivate *qvalue = data;
799 g_value_unset (&qvalue->public.value);
800 g_free (qvalue->public.origin);
805 gtk_settings_set_property_value_internal (GtkSettings *settings,
806 const gchar *prop_name,
807 const GtkSettingsValue *new_value,
808 GtkSettingsSource source)
810 GtkSettingsValuePrivate *qvalue;
815 if (!G_VALUE_HOLDS_LONG (&new_value->value) &&
816 !G_VALUE_HOLDS_DOUBLE (&new_value->value) &&
817 !G_VALUE_HOLDS_STRING (&new_value->value) &&
818 !G_VALUE_HOLDS (&new_value->value, G_TYPE_GSTRING))
820 g_warning (G_STRLOC ": value type invalid");
824 name = g_strdup (prop_name);
825 g_strcanon (name, G_CSET_A_2_Z G_CSET_a_2_z G_CSET_DIGITS "-", '-');
826 name_quark = g_quark_from_string (name);
829 qvalue = g_datalist_id_get_data (&settings->queued_settings, name_quark);
832 qvalue = g_new0 (GtkSettingsValuePrivate, 1);
833 g_datalist_id_set_data_full (&settings->queued_settings, name_quark, qvalue, free_value);
837 g_free (qvalue->public.origin);
838 g_value_unset (&qvalue->public.value);
840 qvalue->public.origin = g_strdup (new_value->origin);
841 g_value_init (&qvalue->public.value, G_VALUE_TYPE (&new_value->value));
842 g_value_copy (&new_value->value, &qvalue->public.value);
843 qvalue->source = source;
844 pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (settings), g_quark_to_string (name_quark));
846 apply_queued_setting (settings, pspec, qvalue);
850 gtk_settings_set_property_value (GtkSettings *settings,
851 const gchar *prop_name,
852 const GtkSettingsValue *new_value)
854 g_return_if_fail (GTK_SETTINGS (settings));
855 g_return_if_fail (prop_name != NULL);
856 g_return_if_fail (new_value != NULL);
857 g_return_if_fail (new_value->origin != NULL);
859 gtk_settings_set_property_value_internal (settings, prop_name, new_value,
860 GTK_SETTINGS_SOURCE_APPLICATION);
864 _gtk_settings_set_property_value_from_rc (GtkSettings *settings,
865 const gchar *prop_name,
866 const GtkSettingsValue *new_value)
868 g_return_if_fail (GTK_SETTINGS (settings));
869 g_return_if_fail (prop_name != NULL);
870 g_return_if_fail (new_value != NULL);
871 g_return_if_fail (new_value->origin != NULL);
873 gtk_settings_set_property_value_internal (settings, prop_name, new_value,
874 GTK_SETTINGS_SOURCE_RC_FILE);
878 gtk_settings_set_string_property (GtkSettings *settings,
880 const gchar *v_string,
883 GtkSettingsValue svalue = { NULL, { 0, }, };
885 g_return_if_fail (GTK_SETTINGS (settings));
886 g_return_if_fail (name != NULL);
887 g_return_if_fail (v_string != NULL);
888 g_return_if_fail (origin != NULL);
890 svalue.origin = (gchar*) origin;
891 g_value_init (&svalue.value, G_TYPE_STRING);
892 g_value_set_static_string (&svalue.value, v_string);
893 gtk_settings_set_property_value (settings, name, &svalue);
894 g_value_unset (&svalue.value);
898 gtk_settings_set_long_property (GtkSettings *settings,
903 GtkSettingsValue svalue = { NULL, { 0, }, };
905 g_return_if_fail (GTK_SETTINGS (settings));
906 g_return_if_fail (name != NULL);
907 g_return_if_fail (origin != NULL);
909 svalue.origin = (gchar*) origin;
910 g_value_init (&svalue.value, G_TYPE_LONG);
911 g_value_set_long (&svalue.value, v_long);
912 gtk_settings_set_property_value (settings, name, &svalue);
913 g_value_unset (&svalue.value);
917 gtk_settings_set_double_property (GtkSettings *settings,
922 GtkSettingsValue svalue = { NULL, { 0, }, };
924 g_return_if_fail (GTK_SETTINGS (settings));
925 g_return_if_fail (name != NULL);
926 g_return_if_fail (origin != NULL);
928 svalue.origin = (gchar*) origin;
929 g_value_init (&svalue.value, G_TYPE_DOUBLE);
930 g_value_set_double (&svalue.value, v_double);
931 gtk_settings_set_property_value (settings, name, &svalue);
932 g_value_unset (&svalue.value);
936 * gtk_rc_property_parse_color:
937 * @pspec: a #GParamSpec
938 * @gstring: the #GString to be parsed
939 * @property_value: a #GValue which must hold #GdkColor values.
941 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
942 * or gtk_widget_class_install_style_property_parser() which parses a
943 * color given either by its name or in the form
944 * <literal>{ red, green, blue }</literal> where %red, %green and
945 * %blue are integers between 0 and 65535 or floating-point numbers
948 * Return value: %TRUE if @gstring could be parsed and @property_value
949 * has been set to the resulting #GdkColor.
952 gtk_rc_property_parse_color (const GParamSpec *pspec,
953 const GString *gstring,
954 GValue *property_value)
956 GdkColor color = { 0, 0, 0, 0, };
960 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
961 g_return_val_if_fail (G_VALUE_HOLDS (property_value, GDK_TYPE_COLOR), FALSE);
963 scanner = gtk_rc_scanner_new ();
964 g_scanner_input_text (scanner, gstring->str, gstring->len);
965 if (gtk_rc_parse_color (scanner, &color) == G_TOKEN_NONE &&
966 g_scanner_get_next_token (scanner) == G_TOKEN_EOF)
968 g_value_set_boxed (property_value, &color);
973 g_scanner_destroy (scanner);
979 * gtk_rc_property_parse_enum:
980 * @pspec: a #GParamSpec
981 * @gstring: the #GString to be parsed
982 * @property_value: a #GValue which must hold enum values.
984 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
985 * or gtk_widget_class_install_style_property_parser() which parses a single
988 * The enumeration value can be specified by its name, its nickname or
989 * its numeric value. For consistency with flags parsing, the value
990 * may be surrounded by parentheses.
992 * Return value: %TRUE if @gstring could be parsed and @property_value
993 * has been set to the resulting #GEnumValue.
996 gtk_rc_property_parse_enum (const GParamSpec *pspec,
997 const GString *gstring,
998 GValue *property_value)
1000 gboolean need_closing_brace = FALSE, success = FALSE;
1002 GEnumValue *enum_value = NULL;
1004 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1005 g_return_val_if_fail (G_VALUE_HOLDS_ENUM (property_value), FALSE);
1007 scanner = gtk_rc_scanner_new ();
1008 g_scanner_input_text (scanner, gstring->str, gstring->len);
1010 /* we just want to parse _one_ value, but for consistency with flags parsing
1011 * we support optional parenthesis
1013 g_scanner_get_next_token (scanner);
1014 if (scanner->token == '(')
1016 need_closing_brace = TRUE;
1017 g_scanner_get_next_token (scanner);
1019 if (scanner->token == G_TOKEN_IDENTIFIER)
1021 GEnumClass *class = G_PARAM_SPEC_ENUM (pspec)->enum_class;
1023 enum_value = g_enum_get_value_by_name (class, scanner->value.v_identifier);
1025 enum_value = g_enum_get_value_by_nick (class, scanner->value.v_identifier);
1028 g_value_set_enum (property_value, enum_value->value);
1032 else if (scanner->token == G_TOKEN_INT)
1034 g_value_set_enum (property_value, scanner->value.v_int);
1037 if (need_closing_brace && g_scanner_get_next_token (scanner) != ')')
1039 if (g_scanner_get_next_token (scanner) != G_TOKEN_EOF)
1042 g_scanner_destroy (scanner);
1048 parse_flags_value (GScanner *scanner,
1052 g_scanner_get_next_token (scanner);
1053 if (scanner->token == G_TOKEN_IDENTIFIER)
1055 GFlagsValue *flags_value;
1057 flags_value = g_flags_get_value_by_name (class, scanner->value.v_identifier);
1059 flags_value = g_flags_get_value_by_nick (class, scanner->value.v_identifier);
1062 *number |= flags_value->value;
1063 return G_TOKEN_NONE;
1066 else if (scanner->token == G_TOKEN_INT)
1068 *number |= scanner->value.v_int;
1069 return G_TOKEN_NONE;
1071 return G_TOKEN_IDENTIFIER;
1075 * gtk_rc_property_parse_flags:
1076 * @pspec: a #GParamSpec
1077 * @gstring: the #GString to be parsed
1078 * @property_value: a #GValue which must hold flags values.
1080 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1081 * or gtk_widget_class_install_style_property_parser() which parses flags.
1083 * Flags can be specified by their name, their nickname or
1084 * numerically. Multiple flags can be specified in the form
1085 * <literal>"( flag1 | flag2 | ... )"</literal>.
1087 * Return value: %TRUE if @gstring could be parsed and @property_value
1088 * has been set to the resulting flags value.
1091 gtk_rc_property_parse_flags (const GParamSpec *pspec,
1092 const GString *gstring,
1093 GValue *property_value)
1096 gboolean success = FALSE;
1099 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1100 g_return_val_if_fail (G_VALUE_HOLDS_FLAGS (property_value), FALSE);
1102 class = G_PARAM_SPEC_FLAGS (pspec)->flags_class;
1103 scanner = gtk_rc_scanner_new ();
1104 g_scanner_input_text (scanner, gstring->str, gstring->len);
1106 /* parse either a single flags value or a "\( ... [ \| ... ] \)" compound */
1107 if (g_scanner_peek_next_token (scanner) == G_TOKEN_IDENTIFIER ||
1108 scanner->next_token == G_TOKEN_INT)
1110 guint token, flags_value = 0;
1112 token = parse_flags_value (scanner, class, &flags_value);
1114 if (token == G_TOKEN_NONE && g_scanner_peek_next_token (scanner) == G_TOKEN_EOF)
1117 g_value_set_flags (property_value, flags_value);
1121 else if (g_scanner_get_next_token (scanner) == '(')
1123 guint token, flags_value = 0;
1125 /* parse first value */
1126 token = parse_flags_value (scanner, class, &flags_value);
1128 /* parse nth values, preceeded by '|' */
1129 while (token == G_TOKEN_NONE && g_scanner_get_next_token (scanner) == '|')
1130 token = parse_flags_value (scanner, class, &flags_value);
1132 /* done, last token must have closed expression */
1133 if (token == G_TOKEN_NONE && scanner->token == ')' &&
1134 g_scanner_peek_next_token (scanner) == G_TOKEN_EOF)
1136 g_value_set_flags (property_value, flags_value);
1140 g_scanner_destroy (scanner);
1146 get_braced_int (GScanner *scanner,
1153 g_scanner_get_next_token (scanner);
1154 if (scanner->token != '{')
1158 g_scanner_get_next_token (scanner);
1159 if (scanner->token != G_TOKEN_INT)
1162 *value = scanner->value.v_int;
1166 g_scanner_get_next_token (scanner);
1167 if (scanner->token != '}')
1172 g_scanner_get_next_token (scanner);
1173 if (scanner->token != ',')
1181 * gtk_rc_property_parse_requisition:
1182 * @pspec: a #GParamSpec
1183 * @gstring: the #GString to be parsed
1184 * @property_value: a #GValue which must hold boxed values.
1186 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1187 * or gtk_widget_class_install_style_property_parser() which parses a
1188 * requisition in the form
1189 * <literal>"{ width, height }"</literal> for integers %width and %height.
1191 * Return value: %TRUE if @gstring could be parsed and @property_value
1192 * has been set to the resulting #GtkRequisition.
1195 gtk_rc_property_parse_requisition (const GParamSpec *pspec,
1196 const GString *gstring,
1197 GValue *property_value)
1199 GtkRequisition requisition;
1201 gboolean success = FALSE;
1203 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1204 g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE);
1206 scanner = gtk_rc_scanner_new ();
1207 g_scanner_input_text (scanner, gstring->str, gstring->len);
1209 if (get_braced_int (scanner, TRUE, FALSE, &requisition.width) &&
1210 get_braced_int (scanner, FALSE, TRUE, &requisition.height))
1212 g_value_set_boxed (property_value, &requisition);
1216 g_scanner_destroy (scanner);
1222 * gtk_rc_property_parse_border:
1223 * @pspec: a #GParamSpec
1224 * @gstring: the #GString to be parsed
1225 * @property_value: a #GValue which must hold boxed values.
1227 * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1228 * or gtk_widget_class_install_style_property_parser() which parses
1229 * borders in the form
1230 * <literal>"{ left, right, top, bottom }"</literal> for integers
1231 * %left, %right, %top and %bottom.
1233 * Return value: %TRUE if @gstring could be parsed and @property_value
1234 * has been set to the resulting #GtkBorder.
1237 gtk_rc_property_parse_border (const GParamSpec *pspec,
1238 const GString *gstring,
1239 GValue *property_value)
1243 gboolean success = FALSE;
1245 g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1246 g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE);
1248 scanner = gtk_rc_scanner_new ();
1249 g_scanner_input_text (scanner, gstring->str, gstring->len);
1251 if (get_braced_int (scanner, TRUE, FALSE, &border.left) &&
1252 get_braced_int (scanner, FALSE, FALSE, &border.right) &&
1253 get_braced_int (scanner, FALSE, FALSE, &border.top) &&
1254 get_braced_int (scanner, FALSE, TRUE, &border.bottom))
1256 g_value_set_boxed (property_value, &border);
1260 g_scanner_destroy (scanner);
1266 _gtk_settings_handle_event (GdkEventSetting *event)
1268 GtkSettings *settings = gtk_settings_get_for_screen (gdk_drawable_get_screen (event->window));
1270 if (g_object_class_find_property (G_OBJECT_GET_CLASS (settings), event->name))
1271 g_object_notify (G_OBJECT (settings), event->name);
1275 reset_rc_values_foreach (GQuark key_id,
1279 GtkSettingsValuePrivate *qvalue = data;
1280 GSList **to_reset = user_data;
1282 if (qvalue->source == GTK_SETTINGS_SOURCE_RC_FILE)
1283 *to_reset = g_slist_prepend (*to_reset, GUINT_TO_POINTER (key_id));
1287 _gtk_settings_reset_rc_values (GtkSettings *settings)
1289 GSList *to_reset = NULL;
1291 GParamSpec **pspecs, **p;
1294 /* Remove any queued settings
1296 g_datalist_foreach (&settings->queued_settings,
1297 reset_rc_values_foreach,
1300 for (tmp_list = to_reset; tmp_list; tmp_list = tmp_list->next)
1302 GQuark key_id = GPOINTER_TO_UINT (tmp_list->data);
1303 g_datalist_id_remove_data (&settings->queued_settings, key_id);
1306 /* Now reset the active settings
1308 pspecs = g_object_class_list_properties (G_OBJECT_GET_CLASS (settings), NULL);
1311 g_object_freeze_notify (G_OBJECT (settings));
1312 for (p = pspecs; *p; p++)
1314 if (settings->property_values[i].source == GTK_SETTINGS_SOURCE_RC_FILE)
1316 GParamSpec *pspec = *p;
1318 g_param_value_set_default (pspec, &settings->property_values[i].value);
1319 g_object_notify (G_OBJECT (settings), pspec->name);
1323 g_object_thaw_notify (G_OBJECT (settings));
1328 settings_update_double_click (GtkSettings *settings)
1330 if (gdk_screen_get_number (settings->screen) == 0)
1332 GdkDisplay *display = gdk_screen_get_display (settings->screen);
1333 gint double_click_time;
1334 gint double_click_distance;
1336 g_object_get (settings,
1337 "gtk-double-click-time", &double_click_time,
1338 "gtk-double-click-distance", &double_click_distance,
1341 gdk_display_set_double_click_time (display, double_click_time);
1342 gdk_display_set_double_click_distance (display, double_click_distance);
1347 settings_update_modules (GtkSettings *settings)
1351 g_object_get (settings,
1352 "gtk-modules", &modules,
1355 _gtk_modules_settings_changed (settings, modules);
1360 #ifdef GDK_WINDOWING_X11
1362 settings_update_cursor_theme (GtkSettings *settings)
1364 GdkDisplay *display = gdk_screen_get_display (settings->screen);
1365 gchar *theme = NULL;
1368 g_object_get (settings,
1369 "gtk-cursor-theme-name", &theme,
1370 "gtk-cursor-theme-size", &size,
1373 gdk_x11_display_set_cursor_theme (display, theme, size);
1379 settings_update_font_options (GtkSettings *settings)
1382 gchar *hint_style_str;
1383 cairo_hint_style_t hint_style = CAIRO_HINT_STYLE_DEFAULT;
1385 cairo_antialias_t antialias_mode = CAIRO_ANTIALIAS_DEFAULT;
1387 cairo_subpixel_order_t subpixel_order = CAIRO_SUBPIXEL_ORDER_DEFAULT;
1390 cairo_font_options_t *options;
1392 g_object_get (settings,
1393 "gtk-xft-antialias", &antialias,
1394 "gtk-xft-hinting", &hinting,
1395 "gtk-xft-hintstyle", &hint_style_str,
1396 "gtk-xft-rgba", &rgba_str,
1397 "gtk-xft-dpi", &dpi_int,
1401 dpi = dpi_int / 1024.;
1405 options = cairo_font_options_create ();
1407 if (hinting >= 0 && !hinting)
1409 hint_style = CAIRO_HINT_STYLE_NONE;
1411 else if (hint_style_str)
1413 if (strcmp (hint_style_str, "hintnone") == 0)
1414 hint_style = CAIRO_HINT_STYLE_NONE;
1415 else if (strcmp (hint_style_str, "hintslight") == 0)
1416 hint_style = CAIRO_HINT_STYLE_SLIGHT;
1417 else if (strcmp (hint_style_str, "hintmedium") == 0)
1418 hint_style = CAIRO_HINT_STYLE_MEDIUM;
1419 else if (strcmp (hint_style_str, "hintfull") == 0)
1420 hint_style = CAIRO_HINT_STYLE_FULL;
1424 g_free (hint_style_str);
1426 cairo_font_options_set_hint_style (options, hint_style);
1430 if (strcmp (rgba_str, "rgb") == 0)
1431 subpixel_order = CAIRO_SUBPIXEL_ORDER_RGB;
1432 else if (strcmp (rgba_str, "bgr") == 0)
1433 subpixel_order = CAIRO_SUBPIXEL_ORDER_BGR;
1434 else if (strcmp (rgba_str, "vrgb") == 0)
1435 subpixel_order = CAIRO_SUBPIXEL_ORDER_VRGB;
1436 else if (strcmp (rgba_str, "vbgr") == 0)
1437 subpixel_order = CAIRO_SUBPIXEL_ORDER_VBGR;
1442 cairo_font_options_set_subpixel_order (options, subpixel_order);
1444 if (antialias >= 0 && !antialias)
1445 antialias_mode = CAIRO_ANTIALIAS_NONE;
1446 else if (subpixel_order != CAIRO_SUBPIXEL_ORDER_DEFAULT)
1447 antialias_mode = CAIRO_ANTIALIAS_SUBPIXEL;
1448 else if (antialias >= 0)
1449 antialias_mode = CAIRO_ANTIALIAS_GRAY;
1451 cairo_font_options_set_antialias (options, antialias_mode);
1453 gdk_screen_set_font_options (settings->screen, options);
1455 cairo_font_options_destroy (options);
1459 settings_update_resolution (GtkSettings *settings)
1464 g_object_get (settings,
1465 "gtk-xft-dpi", &dpi_int,
1469 dpi = dpi_int / 1024.;
1473 gdk_screen_set_resolution (settings->screen, dpi);
1477 #define __GTK_SETTINGS_C__
1478 #include "gtkaliasdef.c"