]> Pileus Git - ~andy/gtk/blob - gtk/gtksettings.c
Update the Cairo requirements (#345008)
[~andy/gtk] / gtk / gtksettings.c
1 /* GTK - The GIMP Toolkit
2  * Copyright (C) 2000 Red Hat, Inc.
3  *
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.
8  *
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.
13  *
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.
17  */
18
19 #include <config.h>
20
21 #include <string.h>
22
23 #include "gtkmodules.h"
24 #include "gtksettings.h"
25 #include "gtkrc.h"
26 #include "gtkintl.h"
27 #include "gtkwidget.h"
28 #include "gtkprivate.h"
29 #include "gtkalias.h"
30
31 #ifdef GDK_WINDOWING_X11
32 #include "x11/gdkx.h"
33 #endif
34
35 #define DEFAULT_TIMEOUT_INITIAL 200
36 #define DEFAULT_TIMEOUT_REPEAT   20
37 #define DEFAULT_TIMEOUT_EXPAND  500
38
39 typedef struct _GtkSettingsValuePrivate GtkSettingsValuePrivate;
40
41 typedef enum
42 {
43   GTK_SETTINGS_SOURCE_DEFAULT,
44   GTK_SETTINGS_SOURCE_RC_FILE,
45   GTK_SETTINGS_SOURCE_XSETTING,
46   GTK_SETTINGS_SOURCE_APPLICATION
47 } GtkSettingsSource;
48
49 struct _GtkSettingsValuePrivate
50 {
51   GtkSettingsValue public;
52   GtkSettingsSource source;
53 };
54
55 struct _GtkSettingsPropertyValue
56 {
57   GValue value;
58   GtkSettingsSource source;
59 };
60
61 enum {
62   PROP_0,
63   PROP_DOUBLE_CLICK_TIME,
64   PROP_DOUBLE_CLICK_DISTANCE,
65   PROP_CURSOR_BLINK,
66   PROP_CURSOR_BLINK_TIME,
67   PROP_SPLIT_CURSOR,
68   PROP_THEME_NAME,
69   PROP_ICON_THEME_NAME,
70   PROP_FALLBACK_ICON_THEME,
71   PROP_KEY_THEME_NAME,
72   PROP_MENU_BAR_ACCEL,
73   PROP_DND_DRAG_THRESHOLD,
74   PROP_FONT_NAME,
75   PROP_ICON_SIZES,
76   PROP_MODULES,
77 #ifdef GDK_WINDOWING_X11
78   PROP_XFT_ANTIALIAS,
79   PROP_XFT_HINTING,
80   PROP_XFT_HINTSTYLE,
81   PROP_XFT_RGBA,
82   PROP_XFT_DPI,
83   PROP_CURSOR_THEME_NAME,
84   PROP_CURSOR_THEME_SIZE,
85 #endif
86   PROP_ALTERNATIVE_BUTTON_ORDER,
87   PROP_SHOW_INPUT_METHOD_MENU,
88   PROP_SHOW_UNICODE_MENU,
89   PROP_TIMEOUT_INITIAL,
90   PROP_TIMEOUT_REPEAT,
91   PROP_TIMEOUT_EXPAND,
92   PROP_COLOR_SCHEME,
93   PROP_ENABLE_ANIMATIONS,
94   PROP_TOUCHSCREEN_MODE,
95   PROP_COLOR_HASH
96 };
97
98
99 /* --- prototypes --- */
100 static void     gtk_settings_finalize            (GObject               *object);
101 static void     gtk_settings_get_property        (GObject               *object,
102                                                   guint                  property_id,
103                                                   GValue                *value,
104                                                   GParamSpec            *pspec);
105 static void     gtk_settings_set_property        (GObject               *object,
106                                                   guint                  property_id,
107                                                   const GValue          *value,
108                                                   GParamSpec            *pspec);
109 static void     gtk_settings_notify              (GObject               *object,
110                                                   GParamSpec            *pspec);
111 static guint    settings_install_property_parser (GtkSettingsClass      *class,
112                                                   GParamSpec            *pspec,
113                                                   GtkRcPropertyParser    parser);
114 static void    settings_update_double_click      (GtkSettings           *settings);
115 static void    settings_update_modules           (GtkSettings           *settings);
116
117 #ifdef GDK_WINDOWING_X11
118 static void    settings_update_cursor_theme      (GtkSettings           *settings);
119 static void    settings_update_resolution        (GtkSettings           *settings);
120 static void    settings_update_font_options      (GtkSettings           *settings);
121 #endif
122 static void    settings_update_color_scheme      (GtkSettings *settings);
123
124 static void    merge_color_scheme                (GtkSettings           *settings, 
125                                                   GValue                *value, 
126                                                   GtkSettingsSource      source);
127 static gchar  *get_color_scheme                  (GtkSettings           *settings);
128 static GHashTable *get_color_hash                (GtkSettings           *settings);
129
130
131 /* --- variables --- */
132 static GQuark            quark_property_parser = 0;
133 static GSList           *object_list = NULL;
134 static guint             class_n_properties = 0;
135
136
137 G_DEFINE_TYPE (GtkSettings, gtk_settings, G_TYPE_OBJECT)
138
139 /* --- functions --- */
140 static void
141 gtk_settings_init (GtkSettings *settings)
142 {
143   GParamSpec **pspecs, **p;
144   guint i = 0;
145   
146   g_datalist_init (&settings->queued_settings);
147   object_list = g_slist_prepend (object_list, settings);
148
149   /* build up property array for all yet existing properties and queue
150    * notification for them (at least notification for internal properties
151    * will instantly be caught)
152    */
153   pspecs = g_object_class_list_properties (G_OBJECT_GET_CLASS (settings), NULL);
154   for (p = pspecs; *p; p++)
155     if ((*p)->owner_type == G_OBJECT_TYPE (settings))
156       i++;
157   settings->property_values = g_new0 (GtkSettingsPropertyValue, i);
158   i = 0;
159   g_object_freeze_notify (G_OBJECT (settings));
160   for (p = pspecs; *p; p++)
161     {
162       GParamSpec *pspec = *p;
163
164       if (pspec->owner_type != G_OBJECT_TYPE (settings))
165         continue;
166       g_value_init (&settings->property_values[i].value, G_PARAM_SPEC_VALUE_TYPE (pspec));
167       g_param_value_set_default (pspec, &settings->property_values[i].value);
168       g_object_notify (G_OBJECT (settings), pspec->name);
169       settings->property_values[i].source = GTK_SETTINGS_SOURCE_DEFAULT;
170       i++;
171     }
172   g_object_thaw_notify (G_OBJECT (settings));
173   g_free (pspecs);
174 }
175
176 static void
177 gtk_settings_class_init (GtkSettingsClass *class)
178 {
179   GObjectClass *gobject_class = G_OBJECT_CLASS (class);
180   guint result;
181   
182   gobject_class->finalize = gtk_settings_finalize;
183   gobject_class->get_property = gtk_settings_get_property;
184   gobject_class->set_property = gtk_settings_set_property;
185   gobject_class->notify = gtk_settings_notify;
186
187   quark_property_parser = g_quark_from_static_string ("gtk-rc-property-parser");
188   result = settings_install_property_parser (class,
189                                              g_param_spec_int ("gtk-double-click-time",
190                                                                P_("Double Click Time"),
191                                                                P_("Maximum time allowed between two clicks for them to be considered a double click (in milliseconds)"),
192                                                                0, G_MAXINT, 250,
193                                                                GTK_PARAM_READWRITE),
194                                              NULL);
195   g_assert (result == PROP_DOUBLE_CLICK_TIME);
196   result = settings_install_property_parser (class,
197                                              g_param_spec_int ("gtk-double-click-distance",
198                                                                P_("Double Click Distance"),
199                                                                P_("Maximum distance allowed between two clicks for them to be considered a double click (in pixels)"),
200                                                                0, G_MAXINT, 5,
201                                                                GTK_PARAM_READWRITE),
202                                              NULL);
203   g_assert (result == PROP_DOUBLE_CLICK_DISTANCE);
204   result = settings_install_property_parser (class,
205                                              g_param_spec_boolean ("gtk-cursor-blink",
206                                                                    P_("Cursor Blink"),
207                                                                    P_("Whether the cursor should blink"),
208                                                                    TRUE,
209                                                                    GTK_PARAM_READWRITE),
210                                              NULL);
211   g_assert (result == PROP_CURSOR_BLINK);
212   result = settings_install_property_parser (class,
213                                              g_param_spec_int ("gtk-cursor-blink-time",
214                                                                P_("Cursor Blink Time"),
215                                                                P_("Length of the cursor blink cycle, in milleseconds"),
216                                                                100, G_MAXINT, 1200,
217                                                                GTK_PARAM_READWRITE),
218                                              NULL);
219   g_assert (result == PROP_CURSOR_BLINK_TIME);
220   result = settings_install_property_parser (class,
221                                              g_param_spec_boolean ("gtk-split-cursor",
222                                                                    P_("Split Cursor"),
223                                                                    P_("Whether two cursors should be displayed for mixed left-to-right and right-to-left text"),
224                                                                    TRUE,
225                                                                    GTK_PARAM_READWRITE),
226                                              NULL);
227   g_assert (result == PROP_SPLIT_CURSOR);
228   result = settings_install_property_parser (class,
229                                              g_param_spec_string ("gtk-theme-name",
230                                                                    P_("Theme Name"),
231                                                                    P_("Name of theme RC file to load"),
232                                                                   "Raleigh",
233                                                                   GTK_PARAM_READWRITE),
234                                              NULL);
235   g_assert (result == PROP_THEME_NAME);
236
237   result = settings_install_property_parser (class,
238                                              g_param_spec_string ("gtk-icon-theme-name",
239                                                                   P_("Icon Theme Name"),
240                                                                   P_("Name of icon theme to use"),
241                                                                   "hicolor",
242                                                                   GTK_PARAM_READWRITE),
243                                              NULL);
244   g_assert (result == PROP_ICON_THEME_NAME);
245
246   result = settings_install_property_parser (class,
247                                              g_param_spec_string ("gtk-fallback-icon-theme",
248                                                                   P_("Fallback Icon Theme Name"),
249                                                                   P_("Name of a icon theme to fall back to"),
250                                                                   NULL,
251                                                                   GTK_PARAM_READWRITE),
252                                              NULL);
253   g_assert (result == PROP_FALLBACK_ICON_THEME);
254   
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"),
259                                                                   NULL,
260                                                                   GTK_PARAM_READWRITE),
261                                              NULL);
262   g_assert (result == PROP_KEY_THEME_NAME);    
263
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"),
268                                                                   "F10",
269                                                                   GTK_PARAM_READWRITE),
270                                              NULL);
271   g_assert (result == PROP_MENU_BAR_ACCEL);
272
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"),
277                                                                1, G_MAXINT, 8,
278                                                                GTK_PARAM_READWRITE),
279                                              NULL);
280   g_assert (result == PROP_DND_DRAG_THRESHOLD);
281
282   result = settings_install_property_parser (class,
283                                              g_param_spec_string ("gtk-font-name",
284                                                                    P_("Font Name"),
285                                                                    P_("Name of default font to use"),
286                                                                   "Sans 10",
287                                                                   GTK_PARAM_READWRITE),
288                                              NULL);
289   g_assert (result == PROP_FONT_NAME);
290
291   result = settings_install_property_parser (class,
292                                              g_param_spec_string ("gtk-icon-sizes",
293                                                                    P_("Icon Sizes"),
294                                                                    P_("List of icon sizes (gtk-menu=16,16:gtk-button=20,20..."),
295                                                                   NULL,
296                                                                   GTK_PARAM_READWRITE),
297                                              NULL);
298   g_assert (result == PROP_ICON_SIZES);
299
300   result = settings_install_property_parser (class,
301                                              g_param_spec_string ("gtk-modules",
302                                                                   P_("GTK Modules"),
303                                                                   P_("List of currently active GTK modules"),
304                                                                   NULL,
305                                                                   GTK_PARAM_READWRITE),
306                                              NULL);
307   g_assert (result == PROP_MODULES);
308
309 #ifdef GDK_WINDOWING_X11
310   result = settings_install_property_parser (class,
311                                              g_param_spec_int ("gtk-xft-antialias",
312                                                                P_("Xft Antialias"),
313                                                                P_("Whether to antialias Xft fonts; 0=no, 1=yes, -1=default"),
314                                                                -1, 1, -1,
315                                                                GTK_PARAM_READWRITE),
316                                              NULL);
317  
318   g_assert (result == PROP_XFT_ANTIALIAS);
319   
320   result = settings_install_property_parser (class,
321                                              g_param_spec_int ("gtk-xft-hinting",
322                                                                P_("Xft Hinting"),
323                                                                P_("Whether to hint Xft fonts; 0=no, 1=yes, -1=default"),
324                                                                -1, 1, -1,
325                                                                GTK_PARAM_READWRITE),
326                                              NULL);
327   
328   g_assert (result == PROP_XFT_HINTING);
329   
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"),
334                                                                   NULL,
335                                                                   GTK_PARAM_READWRITE),
336                                               NULL);
337   
338   g_assert (result == PROP_XFT_HINTSTYLE);
339   
340   result = settings_install_property_parser (class,
341                                              g_param_spec_string ("gtk-xft-rgba",
342                                                                   P_("Xft RGBA"),
343                                                                   P_("Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr"),
344                                                                   NULL,
345                                                                   GTK_PARAM_READWRITE),
346                                              NULL);
347   
348   g_assert (result == PROP_XFT_RGBA);
349   
350   result = settings_install_property_parser (class,
351                                              g_param_spec_int ("gtk-xft-dpi",
352                                                                P_("Xft DPI"),
353                                                                P_("Resolution for Xft, in 1024 * dots/inch. -1 to use default value"),
354                                                                -1, 1024*1024, -1,
355                                                                GTK_PARAM_READWRITE),
356                                              NULL);
357   
358   g_assert (result == PROP_XFT_DPI);
359
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, or NULL to use the default theme"),
364                                                                   NULL,
365                                                                   GTK_PARAM_READWRITE),
366                                              NULL);
367   g_assert (result == PROP_CURSOR_THEME_NAME);
368
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, or 0 to use the default size"),
373                                                                0, 128, 0,
374                                                                GTK_PARAM_READWRITE),
375                                              NULL);
376   
377   g_assert (result == PROP_CURSOR_THEME_SIZE);
378
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"),
384                                                                    FALSE,
385                                                                    GTK_PARAM_READWRITE),
386                                              NULL);
387   g_assert (result == PROP_ALTERNATIVE_BUTTON_ORDER);
388
389   result = settings_install_property_parser (class,
390                                              g_param_spec_boolean ("gtk-show-input-method-menu",
391                                                                    P_("Show the 'Input Methods' menu"),
392                                                                    P_("Whether the context menus of entries and text views should offer to change the input method"),
393                                                                    TRUE,
394                                                                    GTK_PARAM_READWRITE),
395                                              NULL);
396   g_assert (result == PROP_SHOW_INPUT_METHOD_MENU);
397
398   result = settings_install_property_parser (class,
399                                              g_param_spec_boolean ("gtk-show-unicode-menu",
400                                                                    P_("Show the 'Insert Unicode Control Character' menu"),
401                                                                    P_("Whether the context menus of entries and text views should offer to insert control characters"),
402                                                                    TRUE,
403                                                                    GTK_PARAM_READWRITE),
404                                              NULL);
405   g_assert (result == PROP_SHOW_UNICODE_MENU);
406
407   result = settings_install_property_parser (class,
408                                              g_param_spec_int ("gtk-timeout-initial",
409                                                                P_("Start timeout"),
410                                                                P_("Starting value for timeouts, when button is pressed"),
411                                                                0, G_MAXINT, DEFAULT_TIMEOUT_INITIAL,
412                                                                GTK_PARAM_READWRITE),
413                                              NULL);
414
415   g_assert (result == PROP_TIMEOUT_INITIAL);
416
417   result = settings_install_property_parser (class,
418                                              g_param_spec_int ("gtk-timeout-repeat",
419                                                                P_("Repeat timeout"),
420                                                                P_("Repeat value for timeouts, when button is pressed"),
421                                                                0, G_MAXINT, DEFAULT_TIMEOUT_REPEAT,
422                                                                GTK_PARAM_READWRITE),
423                                              NULL);
424
425   g_assert (result == PROP_TIMEOUT_REPEAT);
426
427   result = settings_install_property_parser (class,
428                                              g_param_spec_int ("gtk-timeout-expand",
429                                                                P_("Expand timeout"),
430                                                                P_("Expand value for timeouts, when a widget is expanding a new region"),
431                                                                0, G_MAXINT, DEFAULT_TIMEOUT_EXPAND,
432                                                                GTK_PARAM_READWRITE),
433                                              NULL);
434
435   g_assert (result == PROP_TIMEOUT_EXPAND);
436
437   /**
438    * GtkSettings:gtk-color-scheme:
439    *
440    * A palette of named colors for use in themes. The format of the string is
441    * <programlisting>
442    * name1: color1
443    * name2: color2
444    * ...
445    * </programlisting>
446    * Color names must be acceptable as identifiers in the 
447    * <link linkend="gtk-Resource-Files">gtkrc</link> syntax, and
448    * color specifications must be in the format accepted by
449    * gdk_color_parse().
450    * 
451    * Note that due to the way the color tables from different sources are
452    * merged, color specifications will be converted to hexadecimal form
453    * when getting this property.
454    *
455    * Since: 2.10
456    */
457   result = settings_install_property_parser (class,
458                                              g_param_spec_string ("gtk-color-scheme",
459                                                                   P_("Color scheme"),
460                                                                   P_("A palette of named colors for use in themes"),
461                                                                   "",
462                                                                   GTK_PARAM_READWRITE),
463                                              NULL);
464
465   g_assert (result == PROP_COLOR_SCHEME);
466
467   result = settings_install_property_parser (class,
468                                              g_param_spec_boolean ("gtk-enable-animations",
469                                                                    P_("Enable Animations"),
470                                                                    P_("Whether to enable toolkit-wide animations."),
471                                                                    TRUE,
472                                                                    GTK_PARAM_READWRITE),
473                                              NULL);
474
475   g_assert (result == PROP_ENABLE_ANIMATIONS);
476
477   /**
478    * GtkSettings:gtk-touchscreen-mode:
479    *
480    * When TRUE, there are no motion notify events delivered on this screen,
481    * and widgets can't use the pointer hovering them for any essential
482    * functionality.
483    *
484    * Since: 2.10
485    */
486   result = settings_install_property_parser (class,
487                                              g_param_spec_boolean ("gtk-touchscreen-mode",
488                                                                    P_("Enable Touchscreen Mode"),
489                                                                    P_("When TRUE, there are no motion notify events delivered on this screen"),
490                                                                    FALSE,
491                                                                    GTK_PARAM_READWRITE),
492                                              NULL);
493
494   g_assert (result == PROP_TOUCHSCREEN_MODE);
495
496   /**
497    * GtkSettings:color-hash:
498    *
499    * Holds a hash table representation of the gtk-color-scheme setting,
500    * mapping color names to #GdkColor<!-- -->s. 
501    *
502    * Since: 2.10
503    */
504   g_object_class_install_property (gobject_class,
505                                    PROP_COLOR_HASH,
506                                    g_param_spec_boxed ("color-hash",
507                                                        P_("Color Hash"),
508                                                        P_("A hash table representation of the color scheme."),
509                                                        G_TYPE_HASH_TABLE,
510                                                        GTK_PARAM_READABLE));
511
512   class_n_properties++;
513 }
514
515 static void
516 gtk_settings_finalize (GObject *object)
517 {
518   GtkSettings *settings = GTK_SETTINGS (object);
519   guint i;
520
521   object_list = g_slist_remove (object_list, settings);
522
523   for (i = 0; i < class_n_properties; i++)
524     g_value_unset (&settings->property_values[i].value);
525   g_free (settings->property_values);
526
527   g_datalist_clear (&settings->queued_settings);
528
529   G_OBJECT_CLASS (gtk_settings_parent_class)->finalize (object);
530 }
531
532 /**
533  * gtk_settings_get_for_screen:
534  * @screen : a #GdkScreen.
535  * 
536  * Gets the #GtkSettings object for @screen, creating it if necessary.
537  *
538  * Return value: a #GtkSettings object.
539  *
540  * Since: 2.2
541  */
542 GtkSettings*
543 gtk_settings_get_for_screen (GdkScreen *screen)
544 {
545   GtkSettings *settings;
546   
547   g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
548   
549   settings = g_object_get_data (G_OBJECT (screen), "gtk-settings");
550   if (!settings)
551     {
552       settings = g_object_new (GTK_TYPE_SETTINGS, NULL);
553       settings->screen = screen;
554       g_object_set_data (G_OBJECT (screen), I_("gtk-settings"), settings);
555
556       gtk_rc_reparse_all_for_settings (settings, TRUE);
557       settings_update_double_click (settings);
558 #ifdef GDK_WINDOWING_X11
559       settings_update_cursor_theme (settings);
560       settings_update_resolution (settings);
561       settings_update_font_options (settings);
562 #endif
563       settings_update_color_scheme (settings);
564     }
565   
566   return settings;
567 }
568
569 /**
570  * gtk_settings_get_default:
571  * 
572  * Gets the #GtkSettings object for the default GDK screen, creating
573  * it if necessary. See gtk_settings_get_for_screen().
574  * 
575  * Return value: a #GtkSettings object. If there is no default
576  *  screen, then returns %NULL.
577  **/
578 GtkSettings*
579 gtk_settings_get_default (void)
580 {
581   GdkScreen *screen = gdk_screen_get_default ();
582
583   if (screen)
584     return gtk_settings_get_for_screen (screen);
585   else
586     return NULL;
587 }
588
589 static void
590 gtk_settings_set_property (GObject      *object,
591                            guint         property_id,
592                            const GValue *value,
593                            GParamSpec   *pspec)
594 {
595   GtkSettings *settings = GTK_SETTINGS (object);
596
597   g_value_copy (value, &settings->property_values[property_id - 1].value);
598   settings->property_values[property_id - 1].source = GTK_SETTINGS_SOURCE_APPLICATION;
599 }
600
601 static void
602 gtk_settings_get_property (GObject     *object,
603                            guint        property_id,
604                            GValue      *value,
605                            GParamSpec  *pspec)
606 {
607   GtkSettings *settings = GTK_SETTINGS (object);
608   GType value_type = G_VALUE_TYPE (value);
609   GType fundamental_type = G_TYPE_FUNDAMENTAL (value_type);
610
611   if (property_id == PROP_COLOR_HASH)
612     {
613       g_value_set_boxed (value, get_color_hash (settings));
614       return;
615     }
616
617   /* For enums and strings, we need to get the value as a string,
618    * not as an int, since we support using names/nicks as the setting
619    * value.
620    */
621   if ((g_value_type_transformable (G_TYPE_INT, value_type) &&
622        !(fundamental_type == G_TYPE_ENUM || fundamental_type == G_TYPE_FLAGS)) ||
623       g_value_type_transformable (G_TYPE_STRING, G_VALUE_TYPE (value)) ||
624       g_value_type_transformable (GDK_TYPE_COLOR, G_VALUE_TYPE (value)))
625     {
626       if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION ||
627           !gdk_screen_get_setting (settings->screen, pspec->name, value))
628         g_value_copy (&settings->property_values[property_id - 1].value, value);
629       else 
630         {
631           if (pspec->param_id == PROP_COLOR_SCHEME)
632             {
633               merge_color_scheme (settings, value, GTK_SETTINGS_SOURCE_XSETTING);
634               g_value_take_string (value, get_color_scheme (settings));
635             }
636           
637           g_param_value_validate (pspec, value);
638         }
639     }
640   else
641     {
642       GValue val = { 0, };
643
644       /* Try to get xsetting as a string and parse it. */
645       
646       g_value_init (&val, G_TYPE_STRING);
647
648       if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION ||
649           !gdk_screen_get_setting (settings->screen, pspec->name, &val))
650         {
651           g_value_copy (&settings->property_values[property_id - 1].value, value);
652         }
653       else
654         {
655           GValue tmp_value = { 0, };
656           GValue gstring_value = { 0, };
657           GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser);
658           
659           g_value_init (&gstring_value, G_TYPE_GSTRING);
660           g_value_take_boxed (&gstring_value,
661                               g_string_new (g_value_get_string (&val)));
662
663           g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
664
665           if (parser && _gtk_settings_parse_convert (parser, &gstring_value,
666                                                      pspec, &tmp_value))
667             {
668               g_value_copy (&tmp_value, value);
669               g_param_value_validate (pspec, value);
670             }
671           else
672             {
673               g_value_copy (&settings->property_values[property_id - 1].value, value);
674             }
675
676           g_value_unset (&gstring_value);
677           g_value_unset (&tmp_value);
678         }
679
680       g_value_unset (&val);
681     }
682 }
683
684 static void
685 gtk_settings_notify (GObject    *object,
686                      GParamSpec *pspec)
687 {
688   GtkSettings *settings = GTK_SETTINGS (object);
689   guint property_id = pspec->param_id;
690
691   if (settings->screen == NULL) /* initialization */
692     return;
693
694   switch (property_id)
695     {
696     case PROP_MODULES:
697       settings_update_modules (settings);
698       break;
699     case PROP_DOUBLE_CLICK_TIME:
700     case PROP_DOUBLE_CLICK_DISTANCE:
701       settings_update_double_click (settings);
702       break;
703     case PROP_COLOR_SCHEME:
704       settings_update_color_scheme (settings);
705       break;
706 #ifdef GDK_WINDOWING_X11
707     case PROP_XFT_DPI:
708       settings_update_resolution (settings);
709       /* This is a hack because with gtk_rc_reset_styles() doesn't get
710        * widgets with gtk_widget_style_set(), and also causes more
711        * recomputation than necessary.
712        */
713       gtk_rc_reset_styles (GTK_SETTINGS (object));
714       break;
715     case PROP_XFT_ANTIALIAS:
716     case PROP_XFT_HINTING:
717     case PROP_XFT_HINTSTYLE:
718     case PROP_XFT_RGBA:
719       settings_update_font_options (settings);
720       gtk_rc_reset_styles (GTK_SETTINGS (object));
721       break;
722     case PROP_CURSOR_THEME_NAME:
723     case PROP_CURSOR_THEME_SIZE:
724       settings_update_cursor_theme (settings);
725       break;
726 #endif /* GDK_WINDOWING_X11 */
727     }
728 }
729
730 gboolean
731 _gtk_settings_parse_convert (GtkRcPropertyParser parser,
732                              const GValue       *src_value,
733                              GParamSpec         *pspec,
734                              GValue             *dest_value)
735 {
736   gboolean success = FALSE;
737
738   g_return_val_if_fail (G_VALUE_HOLDS (dest_value, G_PARAM_SPEC_VALUE_TYPE (pspec)), FALSE);
739
740   if (parser)
741     {
742       GString *gstring;
743       gboolean free_gstring = TRUE;
744       
745       if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING))
746         {
747           gstring = g_value_get_boxed (src_value);
748           free_gstring = FALSE;
749         }
750       else if (G_VALUE_HOLDS_LONG (src_value))
751         {
752           gstring = g_string_new (NULL);
753           g_string_append_printf (gstring, "%ld", g_value_get_long (src_value));
754         }
755       else if (G_VALUE_HOLDS_DOUBLE (src_value))
756         {
757           gstring = g_string_new (NULL);
758           g_string_append_printf (gstring, "%f", g_value_get_double (src_value));
759         }
760       else if (G_VALUE_HOLDS_STRING (src_value))
761         {
762           gchar *tstr = g_strescape (g_value_get_string (src_value), NULL);
763           
764           gstring = g_string_new ("\"");
765           g_string_append (gstring, tstr);
766           g_string_append_c (gstring, '\"');
767           g_free (tstr);
768         }
769       else
770         {
771           g_return_val_if_fail (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING), FALSE);
772           gstring = NULL; /* silence compiler */
773         }
774
775       success = (parser (pspec, gstring, dest_value) &&
776                  !g_param_value_validate (pspec, dest_value));
777
778       if (free_gstring)
779         g_string_free (gstring, TRUE);
780     }
781   else if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING))
782     {
783       if (G_VALUE_HOLDS (dest_value, G_TYPE_STRING))
784         {
785           GString *gstring = g_value_get_boxed (src_value);
786
787           g_value_set_string (dest_value, gstring ? gstring->str : NULL);
788           success = !g_param_value_validate (pspec, dest_value);
789         }
790     }
791   else if (g_value_type_transformable (G_VALUE_TYPE (src_value), G_VALUE_TYPE (dest_value)))
792     success = g_param_value_convert (pspec, src_value, dest_value, TRUE);
793
794   return success;
795 }
796
797 static void
798 apply_queued_setting (GtkSettings             *data,
799                       GParamSpec              *pspec,
800                       GtkSettingsValuePrivate *qvalue)
801 {
802   GValue tmp_value = { 0, };
803   GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser);
804
805   g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
806   if (_gtk_settings_parse_convert (parser, &qvalue->public.value,
807                                    pspec, &tmp_value))
808     {
809       if (pspec->param_id == PROP_COLOR_SCHEME) 
810         {
811           merge_color_scheme (data, &tmp_value, qvalue->source);
812           g_object_set_property (G_OBJECT (data), pspec->name, &tmp_value);
813           data->property_values[pspec->param_id - 1].source = GTK_SETTINGS_SOURCE_DEFAULT;
814         }      
815       
816       else if (data->property_values[pspec->param_id - 1].source <= qvalue->source)
817         {
818           g_object_set_property (G_OBJECT (data), pspec->name, &tmp_value);
819           data->property_values[pspec->param_id - 1].source = qvalue->source;
820         }
821     }
822   else
823     {
824       gchar *debug = g_strdup_value_contents (&qvalue->public.value);
825       
826       g_message ("%s: failed to retrieve property `%s' of type `%s' from rc file value \"%s\" of type `%s'",
827                  qvalue->public.origin,
828                  pspec->name,
829                  g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)),
830                  debug,
831                  G_VALUE_TYPE_NAME (&tmp_value));
832       g_free (debug);
833     }
834   g_value_unset (&tmp_value);
835 }
836
837 static guint
838 settings_install_property_parser (GtkSettingsClass   *class,
839                                   GParamSpec         *pspec,
840                                   GtkRcPropertyParser parser)
841 {
842   GSList *node, *next;
843
844   switch (G_TYPE_FUNDAMENTAL (G_PARAM_SPEC_VALUE_TYPE (pspec)))
845     {
846     case G_TYPE_BOOLEAN:
847     case G_TYPE_UCHAR:
848     case G_TYPE_CHAR:
849     case G_TYPE_UINT:
850     case G_TYPE_INT:
851     case G_TYPE_ULONG:
852     case G_TYPE_LONG:
853     case G_TYPE_FLOAT:
854     case G_TYPE_DOUBLE:
855     case G_TYPE_STRING:
856       break;
857     default:
858       if (!parser)
859         {
860           g_warning (G_STRLOC ": parser needs to be specified for property \"%s\" of type `%s'",
861                      pspec->name, g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)));
862           return 0;
863         }
864     }
865   if (g_object_class_find_property (G_OBJECT_CLASS (class), pspec->name))
866     {
867       g_warning (G_STRLOC ": an rc-data property \"%s\" already exists",
868                  pspec->name);
869       return 0;
870     }
871   
872   for (node = object_list; node; node = node->next)
873     g_object_freeze_notify (node->data);
874
875   g_object_class_install_property (G_OBJECT_CLASS (class), ++class_n_properties, pspec);
876   g_param_spec_set_qdata (pspec, quark_property_parser, (gpointer) parser);
877
878   for (node = object_list; node; node = node->next)
879     {
880       GtkSettings *settings = node->data;
881       GtkSettingsValuePrivate *qvalue;
882       
883       settings->property_values = g_renew (GtkSettingsPropertyValue, settings->property_values, class_n_properties);
884       settings->property_values[class_n_properties - 1].value.g_type = 0;
885       g_value_init (&settings->property_values[class_n_properties - 1].value, G_PARAM_SPEC_VALUE_TYPE (pspec));
886       g_param_value_set_default (pspec, &settings->property_values[class_n_properties - 1].value);
887       settings->property_values[class_n_properties - 1].source = GTK_SETTINGS_SOURCE_DEFAULT;
888       g_object_notify (G_OBJECT (settings), pspec->name);
889       
890       qvalue = g_datalist_get_data (&settings->queued_settings, pspec->name);
891       if (qvalue)
892         apply_queued_setting (settings, pspec, qvalue);
893     }
894
895   for (node = object_list; node; node = next)
896     {
897       next = node->next;
898       g_object_thaw_notify (node->data);
899     }
900
901   return class_n_properties;
902 }
903
904 GtkRcPropertyParser
905 _gtk_rc_property_parser_from_type (GType type)
906 {
907   if (type == GDK_TYPE_COLOR)
908     return gtk_rc_property_parse_color;
909   else if (type == GTK_TYPE_REQUISITION)
910     return gtk_rc_property_parse_requisition;
911   else if (type == GTK_TYPE_BORDER)
912     return gtk_rc_property_parse_border;
913   else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_ENUM && G_TYPE_IS_DERIVED (type))
914     return gtk_rc_property_parse_enum;
915   else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_FLAGS && G_TYPE_IS_DERIVED (type))
916     return gtk_rc_property_parse_flags;
917   else
918     return NULL;
919 }
920
921 void
922 gtk_settings_install_property (GParamSpec *pspec)
923 {
924   GtkRcPropertyParser parser;
925
926   g_return_if_fail (G_IS_PARAM_SPEC (pspec));
927
928   parser = _gtk_rc_property_parser_from_type (G_PARAM_SPEC_VALUE_TYPE (pspec));
929
930   settings_install_property_parser (gtk_type_class (GTK_TYPE_SETTINGS), pspec, parser);
931 }
932
933 void
934 gtk_settings_install_property_parser (GParamSpec          *pspec,
935                                       GtkRcPropertyParser  parser)
936 {
937   g_return_if_fail (G_IS_PARAM_SPEC (pspec));
938   g_return_if_fail (parser != NULL);
939   
940   settings_install_property_parser (gtk_type_class (GTK_TYPE_SETTINGS), pspec, parser);
941 }
942
943 static void
944 free_value (gpointer data)
945 {
946   GtkSettingsValuePrivate *qvalue = data;
947   
948   g_value_unset (&qvalue->public.value);
949   g_free (qvalue->public.origin);
950   g_free (qvalue);
951 }
952
953 static void
954 gtk_settings_set_property_value_internal (GtkSettings            *settings,
955                                           const gchar            *prop_name,
956                                           const GtkSettingsValue *new_value,
957                                           GtkSettingsSource       source)
958 {
959   GtkSettingsValuePrivate *qvalue;
960   GParamSpec *pspec;
961   gchar *name;
962   GQuark name_quark;
963
964   if (!G_VALUE_HOLDS_LONG (&new_value->value) &&
965       !G_VALUE_HOLDS_DOUBLE (&new_value->value) &&
966       !G_VALUE_HOLDS_STRING (&new_value->value) &&
967       !G_VALUE_HOLDS (&new_value->value, G_TYPE_GSTRING))
968     {
969       g_warning (G_STRLOC ": value type invalid");
970       return;
971     }
972   
973   name = g_strdup (prop_name);
974   g_strcanon (name, G_CSET_A_2_Z G_CSET_a_2_z G_CSET_DIGITS "-", '-');
975   name_quark = g_quark_from_string (name);
976   g_free (name);
977
978   qvalue = g_datalist_id_get_data (&settings->queued_settings, name_quark);
979   if (!qvalue)
980     {
981       qvalue = g_new0 (GtkSettingsValuePrivate, 1);
982       g_datalist_id_set_data_full (&settings->queued_settings, name_quark, qvalue, free_value);
983     }
984   else
985     {
986       g_free (qvalue->public.origin);
987       g_value_unset (&qvalue->public.value);
988     }
989   qvalue->public.origin = g_strdup (new_value->origin);
990   g_value_init (&qvalue->public.value, G_VALUE_TYPE (&new_value->value));
991   g_value_copy (&new_value->value, &qvalue->public.value);
992   qvalue->source = source;
993   pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (settings), g_quark_to_string (name_quark));
994   if (pspec)
995     apply_queued_setting (settings, pspec, qvalue);
996 }
997
998 void
999 gtk_settings_set_property_value (GtkSettings            *settings,
1000                                  const gchar            *prop_name,
1001                                  const GtkSettingsValue *new_value)
1002 {
1003   g_return_if_fail (GTK_SETTINGS (settings));
1004   g_return_if_fail (prop_name != NULL);
1005   g_return_if_fail (new_value != NULL);
1006   g_return_if_fail (new_value->origin != NULL);
1007
1008   gtk_settings_set_property_value_internal (settings, prop_name, new_value,
1009                                             GTK_SETTINGS_SOURCE_APPLICATION);
1010 }
1011
1012 void
1013 _gtk_settings_set_property_value_from_rc (GtkSettings            *settings,
1014                                           const gchar            *prop_name,
1015                                           const GtkSettingsValue *new_value)
1016 {
1017   g_return_if_fail (GTK_SETTINGS (settings));
1018   g_return_if_fail (prop_name != NULL);
1019   g_return_if_fail (new_value != NULL);
1020   g_return_if_fail (new_value->origin != NULL);
1021
1022   gtk_settings_set_property_value_internal (settings, prop_name, new_value,
1023                                             GTK_SETTINGS_SOURCE_RC_FILE);
1024 }
1025
1026 void
1027 gtk_settings_set_string_property (GtkSettings *settings,
1028                                   const gchar *name,
1029                                   const gchar *v_string,
1030                                   const gchar *origin)
1031 {
1032   GtkSettingsValue svalue = { NULL, { 0, }, };
1033
1034   g_return_if_fail (GTK_SETTINGS (settings));
1035   g_return_if_fail (name != NULL);
1036   g_return_if_fail (v_string != NULL);
1037   g_return_if_fail (origin != NULL);
1038
1039   svalue.origin = (gchar*) origin;
1040   g_value_init (&svalue.value, G_TYPE_STRING);
1041   g_value_set_static_string (&svalue.value, v_string);
1042   gtk_settings_set_property_value (settings, name, &svalue);
1043   g_value_unset (&svalue.value);
1044 }
1045
1046 void
1047 gtk_settings_set_long_property (GtkSettings *settings,
1048                                 const gchar *name,
1049                                 glong        v_long,
1050                                 const gchar *origin)
1051 {
1052   GtkSettingsValue svalue = { NULL, { 0, }, };
1053   
1054   g_return_if_fail (GTK_SETTINGS (settings));
1055   g_return_if_fail (name != NULL);
1056   g_return_if_fail (origin != NULL);
1057
1058   svalue.origin = (gchar*) origin;
1059   g_value_init (&svalue.value, G_TYPE_LONG);
1060   g_value_set_long (&svalue.value, v_long);
1061   gtk_settings_set_property_value (settings, name, &svalue);
1062   g_value_unset (&svalue.value);
1063 }
1064
1065 void
1066 gtk_settings_set_double_property (GtkSettings *settings,
1067                                   const gchar *name,
1068                                   gdouble      v_double,
1069                                   const gchar *origin)
1070 {
1071   GtkSettingsValue svalue = { NULL, { 0, }, };
1072
1073   g_return_if_fail (GTK_SETTINGS (settings));
1074   g_return_if_fail (name != NULL);
1075   g_return_if_fail (origin != NULL);
1076
1077   svalue.origin = (gchar*) origin;
1078   g_value_init (&svalue.value, G_TYPE_DOUBLE);
1079   g_value_set_double (&svalue.value, v_double);
1080   gtk_settings_set_property_value (settings, name, &svalue);
1081   g_value_unset (&svalue.value);
1082 }
1083
1084 /**
1085  * gtk_rc_property_parse_color:
1086  * @pspec: a #GParamSpec
1087  * @gstring: the #GString to be parsed
1088  * @property_value: a #GValue which must hold #GdkColor values.
1089  * 
1090  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1091  * or gtk_widget_class_install_style_property_parser() which parses a
1092  * color given either by its name or in the form 
1093  * <literal>{ red, green, blue }</literal> where %red, %green and
1094  * %blue are integers between 0 and 65535 or floating-point numbers
1095  * between 0 and 1.
1096  * 
1097  * Return value: %TRUE if @gstring could be parsed and @property_value
1098  * has been set to the resulting #GdkColor.
1099  **/
1100 gboolean
1101 gtk_rc_property_parse_color (const GParamSpec *pspec,
1102                              const GString    *gstring,
1103                              GValue           *property_value)
1104 {
1105   GdkColor color = { 0, 0, 0, 0, };
1106   GScanner *scanner;
1107   gboolean success;
1108
1109   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1110   g_return_val_if_fail (G_VALUE_HOLDS (property_value, GDK_TYPE_COLOR), FALSE);
1111
1112   scanner = gtk_rc_scanner_new ();
1113   g_scanner_input_text (scanner, gstring->str, gstring->len);
1114   if (gtk_rc_parse_color (scanner, &color) == G_TOKEN_NONE &&
1115       g_scanner_get_next_token (scanner) == G_TOKEN_EOF)
1116     {
1117       g_value_set_boxed (property_value, &color);
1118       success = TRUE;
1119     }
1120   else
1121     success = FALSE;
1122   g_scanner_destroy (scanner);
1123
1124   return success;
1125 }
1126
1127 /**
1128  * gtk_rc_property_parse_enum:
1129  * @pspec: a #GParamSpec
1130  * @gstring: the #GString to be parsed
1131  * @property_value: a #GValue which must hold enum values.
1132  * 
1133  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1134  * or gtk_widget_class_install_style_property_parser() which parses a single
1135  * enumeration value.
1136  *
1137  * The enumeration value can be specified by its name, its nickname or
1138  * its numeric value. For consistency with flags parsing, the value
1139  * may be surrounded by parentheses.
1140  * 
1141  * Return value: %TRUE if @gstring could be parsed and @property_value
1142  * has been set to the resulting #GEnumValue.
1143  **/
1144 gboolean
1145 gtk_rc_property_parse_enum (const GParamSpec *pspec,
1146                             const GString    *gstring,
1147                             GValue           *property_value)
1148 {
1149   gboolean need_closing_brace = FALSE, success = FALSE;
1150   GScanner *scanner;
1151   GEnumValue *enum_value = NULL;
1152
1153   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1154   g_return_val_if_fail (G_VALUE_HOLDS_ENUM (property_value), FALSE);
1155
1156   scanner = gtk_rc_scanner_new ();
1157   g_scanner_input_text (scanner, gstring->str, gstring->len);
1158
1159   /* we just want to parse _one_ value, but for consistency with flags parsing
1160    * we support optional parenthesis
1161    */
1162   g_scanner_get_next_token (scanner);
1163   if (scanner->token == '(')
1164     {
1165       need_closing_brace = TRUE;
1166       g_scanner_get_next_token (scanner);
1167     }
1168   if (scanner->token == G_TOKEN_IDENTIFIER)
1169     {
1170       GEnumClass *class = G_PARAM_SPEC_ENUM (pspec)->enum_class;
1171       
1172       enum_value = g_enum_get_value_by_name (class, scanner->value.v_identifier);
1173       if (!enum_value)
1174         enum_value = g_enum_get_value_by_nick (class, scanner->value.v_identifier);
1175       if (enum_value)
1176         {
1177           g_value_set_enum (property_value, enum_value->value);
1178           success = TRUE;
1179         }
1180     }
1181   else if (scanner->token == G_TOKEN_INT)
1182     {
1183       g_value_set_enum (property_value, scanner->value.v_int);
1184       success = TRUE;
1185     }
1186   if (need_closing_brace && g_scanner_get_next_token (scanner) != ')')
1187     success = FALSE;
1188   if (g_scanner_get_next_token (scanner) != G_TOKEN_EOF)
1189     success = FALSE;
1190
1191   g_scanner_destroy (scanner);
1192
1193   return success;
1194 }
1195
1196 static guint
1197 parse_flags_value (GScanner    *scanner,
1198                    GFlagsClass *class,
1199                    guint       *number)
1200 {
1201   g_scanner_get_next_token (scanner);
1202   if (scanner->token == G_TOKEN_IDENTIFIER)
1203     {
1204       GFlagsValue *flags_value;
1205
1206       flags_value = g_flags_get_value_by_name (class, scanner->value.v_identifier);
1207       if (!flags_value)
1208         flags_value = g_flags_get_value_by_nick (class, scanner->value.v_identifier);
1209       if (flags_value)
1210         {
1211           *number |= flags_value->value;
1212           return G_TOKEN_NONE;
1213         }
1214     }
1215   else if (scanner->token == G_TOKEN_INT)
1216     {
1217       *number |= scanner->value.v_int;
1218       return G_TOKEN_NONE;
1219     }
1220   return G_TOKEN_IDENTIFIER;
1221 }
1222
1223 /**
1224  * gtk_rc_property_parse_flags:
1225  * @pspec: a #GParamSpec
1226  * @gstring: the #GString to be parsed
1227  * @property_value: a #GValue which must hold flags values.
1228  * 
1229  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1230  * or gtk_widget_class_install_style_property_parser() which parses flags. 
1231  * 
1232  * Flags can be specified by their name, their nickname or
1233  * numerically. Multiple flags can be specified in the form 
1234  * <literal>"( flag1 | flag2 | ... )"</literal>.
1235  * 
1236  * Return value: %TRUE if @gstring could be parsed and @property_value
1237  * has been set to the resulting flags value.
1238  **/
1239 gboolean
1240 gtk_rc_property_parse_flags (const GParamSpec *pspec,
1241                              const GString    *gstring,
1242                              GValue           *property_value)
1243 {
1244   GFlagsClass *class;
1245    gboolean success = FALSE;
1246   GScanner *scanner;
1247
1248   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1249   g_return_val_if_fail (G_VALUE_HOLDS_FLAGS (property_value), FALSE);
1250
1251   class = G_PARAM_SPEC_FLAGS (pspec)->flags_class;
1252   scanner = gtk_rc_scanner_new ();
1253   g_scanner_input_text (scanner, gstring->str, gstring->len);
1254
1255   /* parse either a single flags value or a "\( ... [ \| ... ] \)" compound */
1256   if (g_scanner_peek_next_token (scanner) == G_TOKEN_IDENTIFIER ||
1257       scanner->next_token == G_TOKEN_INT)
1258     {
1259       guint token, flags_value = 0;
1260       
1261       token = parse_flags_value (scanner, class, &flags_value);
1262
1263       if (token == G_TOKEN_NONE && g_scanner_peek_next_token (scanner) == G_TOKEN_EOF)
1264         {
1265           success = TRUE;
1266           g_value_set_flags (property_value, flags_value);
1267         }
1268       
1269     }
1270   else if (g_scanner_get_next_token (scanner) == '(')
1271     {
1272       guint token, flags_value = 0;
1273
1274       /* parse first value */
1275       token = parse_flags_value (scanner, class, &flags_value);
1276
1277       /* parse nth values, preceeded by '|' */
1278       while (token == G_TOKEN_NONE && g_scanner_get_next_token (scanner) == '|')
1279         token = parse_flags_value (scanner, class, &flags_value);
1280
1281       /* done, last token must have closed expression */
1282       if (token == G_TOKEN_NONE && scanner->token == ')' &&
1283           g_scanner_peek_next_token (scanner) == G_TOKEN_EOF)
1284         {
1285           g_value_set_flags (property_value, flags_value);
1286           success = TRUE;
1287         }
1288     }
1289   g_scanner_destroy (scanner);
1290
1291   return success;
1292 }
1293
1294 static gboolean
1295 get_braced_int (GScanner *scanner,
1296                 gboolean  first,
1297                 gboolean  last,
1298                 gint     *value)
1299 {
1300   if (first)
1301     {
1302       g_scanner_get_next_token (scanner);
1303       if (scanner->token != '{')
1304         return FALSE;
1305     }
1306
1307   g_scanner_get_next_token (scanner);
1308   if (scanner->token != G_TOKEN_INT)
1309     return FALSE;
1310
1311   *value = scanner->value.v_int;
1312
1313   if (last)
1314     {
1315       g_scanner_get_next_token (scanner);
1316       if (scanner->token != '}')
1317         return FALSE;
1318     }
1319   else
1320     {
1321       g_scanner_get_next_token (scanner);
1322       if (scanner->token != ',')
1323         return FALSE;
1324     }
1325
1326   return TRUE;
1327 }
1328
1329 /**
1330  * gtk_rc_property_parse_requisition:
1331  * @pspec: a #GParamSpec
1332  * @gstring: the #GString to be parsed
1333  * @property_value: a #GValue which must hold boxed values.
1334  * 
1335  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1336  * or gtk_widget_class_install_style_property_parser() which parses a
1337  * requisition in the form 
1338  * <literal>"{ width, height }"</literal> for integers %width and %height.
1339  * 
1340  * Return value: %TRUE if @gstring could be parsed and @property_value
1341  * has been set to the resulting #GtkRequisition.
1342  **/
1343 gboolean
1344 gtk_rc_property_parse_requisition  (const GParamSpec *pspec,
1345                                     const GString    *gstring,
1346                                     GValue           *property_value)
1347 {
1348   GtkRequisition requisition;
1349   GScanner *scanner;
1350   gboolean success = FALSE;
1351
1352   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1353   g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE);
1354
1355   scanner = gtk_rc_scanner_new ();
1356   g_scanner_input_text (scanner, gstring->str, gstring->len);
1357
1358   if (get_braced_int (scanner, TRUE, FALSE, &requisition.width) &&
1359       get_braced_int (scanner, FALSE, TRUE, &requisition.height))
1360     {
1361       g_value_set_boxed (property_value, &requisition);
1362       success = TRUE;
1363     }
1364
1365   g_scanner_destroy (scanner);
1366
1367   return success;
1368 }
1369
1370 /**
1371  * gtk_rc_property_parse_border:
1372  * @pspec: a #GParamSpec
1373  * @gstring: the #GString to be parsed
1374  * @property_value: a #GValue which must hold boxed values.
1375  * 
1376  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1377  * or gtk_widget_class_install_style_property_parser() which parses
1378  * borders in the form 
1379  * <literal>"{ left, right, top, bottom }"</literal> for integers 
1380  * %left, %right, %top and %bottom.
1381  * 
1382  * Return value: %TRUE if @gstring could be parsed and @property_value
1383  * has been set to the resulting #GtkBorder.
1384  **/
1385 gboolean
1386 gtk_rc_property_parse_border (const GParamSpec *pspec,
1387                               const GString    *gstring,
1388                               GValue           *property_value)
1389 {
1390   GtkBorder border;
1391   GScanner *scanner;
1392   gboolean success = FALSE;
1393
1394   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1395   g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE);
1396
1397   scanner = gtk_rc_scanner_new ();
1398   g_scanner_input_text (scanner, gstring->str, gstring->len);
1399
1400   if (get_braced_int (scanner, TRUE, FALSE, &border.left) &&
1401       get_braced_int (scanner, FALSE, FALSE, &border.right) &&
1402       get_braced_int (scanner, FALSE, FALSE, &border.top) &&
1403       get_braced_int (scanner, FALSE, TRUE, &border.bottom))
1404     {
1405       g_value_set_boxed (property_value, &border);
1406       success = TRUE;
1407     }
1408
1409   g_scanner_destroy (scanner);
1410
1411   return success;
1412 }
1413
1414 void
1415 _gtk_settings_handle_event (GdkEventSetting *event)
1416 {
1417   GtkSettings *settings = gtk_settings_get_for_screen (gdk_drawable_get_screen (event->window));
1418   
1419   if (g_object_class_find_property (G_OBJECT_GET_CLASS (settings), event->name))
1420     g_object_notify (G_OBJECT (settings), event->name);
1421 }
1422
1423 static void
1424 reset_rc_values_foreach (GQuark    key_id,
1425                          gpointer  data,
1426                          gpointer  user_data)
1427 {
1428   GtkSettingsValuePrivate *qvalue = data;
1429   GSList **to_reset = user_data;
1430
1431   if (qvalue->source == GTK_SETTINGS_SOURCE_RC_FILE)
1432     *to_reset = g_slist_prepend (*to_reset, GUINT_TO_POINTER (key_id));
1433 }
1434
1435 void
1436 _gtk_settings_reset_rc_values (GtkSettings *settings)
1437 {
1438   GSList *to_reset = NULL;
1439   GSList *tmp_list;
1440   GParamSpec **pspecs, **p;
1441   gint i;
1442
1443   /* Remove any queued settings
1444    */
1445   g_datalist_foreach (&settings->queued_settings,
1446                       reset_rc_values_foreach,
1447                       &to_reset);
1448
1449   for (tmp_list = to_reset; tmp_list; tmp_list = tmp_list->next)
1450     {
1451       GQuark key_id = GPOINTER_TO_UINT (tmp_list->data);
1452       g_datalist_id_remove_data (&settings->queued_settings, key_id);
1453     }
1454
1455   /* Now reset the active settings
1456    */
1457   pspecs = g_object_class_list_properties (G_OBJECT_GET_CLASS (settings), NULL);
1458   i = 0;
1459
1460   g_object_freeze_notify (G_OBJECT (settings));
1461   for (p = pspecs; *p; p++)
1462     {
1463       if (settings->property_values[i].source == GTK_SETTINGS_SOURCE_RC_FILE)
1464         {
1465           GParamSpec *pspec = *p;
1466
1467           g_param_value_set_default (pspec, &settings->property_values[i].value);
1468           g_object_notify (G_OBJECT (settings), pspec->name);
1469         }
1470       i++;
1471     }
1472   g_object_thaw_notify (G_OBJECT (settings));
1473   g_free (pspecs);
1474 }
1475
1476 static void
1477 settings_update_double_click (GtkSettings *settings)
1478 {
1479   if (gdk_screen_get_number (settings->screen) == 0)
1480     {
1481       GdkDisplay *display = gdk_screen_get_display (settings->screen);
1482       gint double_click_time;
1483       gint double_click_distance;
1484   
1485       g_object_get (settings, 
1486                     "gtk-double-click-time", &double_click_time, 
1487                     "gtk-double-click-distance", &double_click_distance,
1488                     NULL);
1489       
1490       gdk_display_set_double_click_time (display, double_click_time);
1491       gdk_display_set_double_click_distance (display, double_click_distance);
1492     }
1493 }
1494
1495 static void
1496 settings_update_modules (GtkSettings *settings)
1497 {
1498   gchar *modules;
1499   
1500   g_object_get (settings, 
1501                 "gtk-modules", &modules,
1502                 NULL);
1503   
1504   _gtk_modules_settings_changed (settings, modules);
1505   
1506   g_free (modules);
1507 }
1508
1509 #ifdef GDK_WINDOWING_X11
1510 static void
1511 settings_update_cursor_theme (GtkSettings *settings)
1512 {
1513   GdkDisplay *display = gdk_screen_get_display (settings->screen);
1514   gchar *theme = NULL;
1515   gint size = 0;
1516   
1517   g_object_get (settings, 
1518                 "gtk-cursor-theme-name", &theme,
1519                 "gtk-cursor-theme-size", &size,
1520                 NULL);
1521   
1522   gdk_x11_display_set_cursor_theme (display, theme, size);
1523
1524   g_free (theme);
1525 }
1526
1527 static void
1528 settings_update_font_options (GtkSettings *settings)
1529 {
1530   gint hinting;
1531   gchar *hint_style_str;
1532   cairo_hint_style_t hint_style = CAIRO_HINT_STYLE_DEFAULT;
1533   gint antialias;
1534   cairo_antialias_t antialias_mode = CAIRO_ANTIALIAS_DEFAULT;
1535   gchar *rgba_str;
1536   cairo_subpixel_order_t subpixel_order = CAIRO_SUBPIXEL_ORDER_DEFAULT;
1537   cairo_font_options_t *options;
1538   
1539   g_object_get (settings,
1540                 "gtk-xft-antialias", &antialias,
1541                 "gtk-xft-hinting", &hinting,
1542                 "gtk-xft-hintstyle", &hint_style_str,
1543                 "gtk-xft-rgba", &rgba_str,
1544                 NULL);
1545
1546   options = cairo_font_options_create ();
1547   
1548   /* hint_metrics = FALSE should never be set for user interface code.
1549    */
1550   cairo_font_options_set_hint_metrics (options, CAIRO_HINT_METRICS_ON);
1551
1552   if (hinting >= 0 && !hinting)
1553     {
1554       hint_style = CAIRO_HINT_STYLE_NONE;
1555     }
1556   else if (hint_style_str)
1557     {
1558       if (strcmp (hint_style_str, "hintnone") == 0)
1559         hint_style = CAIRO_HINT_STYLE_NONE;
1560       else if (strcmp (hint_style_str, "hintslight") == 0)
1561         hint_style = CAIRO_HINT_STYLE_SLIGHT;
1562       else if (strcmp (hint_style_str, "hintmedium") == 0)
1563         hint_style = CAIRO_HINT_STYLE_MEDIUM;
1564       else if (strcmp (hint_style_str, "hintfull") == 0)
1565         hint_style = CAIRO_HINT_STYLE_FULL;
1566     }
1567
1568   if (hint_style_str)
1569     g_free (hint_style_str);
1570
1571   cairo_font_options_set_hint_style (options, hint_style);
1572
1573   if (rgba_str)
1574     {
1575       if (strcmp (rgba_str, "rgb") == 0)
1576         subpixel_order = CAIRO_SUBPIXEL_ORDER_RGB;
1577       else if (strcmp (rgba_str, "bgr") == 0)
1578         subpixel_order = CAIRO_SUBPIXEL_ORDER_BGR;
1579       else if (strcmp (rgba_str, "vrgb") == 0)
1580         subpixel_order = CAIRO_SUBPIXEL_ORDER_VRGB;
1581       else if (strcmp (rgba_str, "vbgr") == 0)
1582         subpixel_order = CAIRO_SUBPIXEL_ORDER_VBGR;
1583
1584       g_free (rgba_str);
1585     }
1586
1587   cairo_font_options_set_subpixel_order (options, subpixel_order);
1588   
1589   if (antialias >= 0 && !antialias)
1590     antialias_mode = CAIRO_ANTIALIAS_NONE;
1591   else if (subpixel_order != CAIRO_SUBPIXEL_ORDER_DEFAULT)
1592     antialias_mode = CAIRO_ANTIALIAS_SUBPIXEL;
1593   else if (antialias >= 0)
1594     antialias_mode = CAIRO_ANTIALIAS_GRAY;
1595   
1596   cairo_font_options_set_antialias (options, antialias_mode);
1597
1598   gdk_screen_set_font_options (settings->screen, options);
1599   
1600   cairo_font_options_destroy (options);
1601 }
1602
1603 static void
1604 settings_update_resolution (GtkSettings *settings)
1605 {
1606   gint dpi_int;
1607   double dpi;
1608   
1609   g_object_get (settings,
1610                 "gtk-xft-dpi", &dpi_int,
1611                 NULL);
1612
1613   if (dpi_int > 0)
1614     dpi = dpi_int / 1024.;
1615   else
1616     dpi = -1.;
1617
1618   gdk_screen_set_resolution (settings->screen, dpi);
1619 }
1620 #endif
1621
1622 static void
1623 settings_update_color_scheme (GtkSettings *settings)
1624 {
1625   gchar *dummy;
1626
1627   g_object_get (settings, "gtk-color-scheme", &dummy, NULL);
1628
1629   /* nothing to do here, the color hash is updated as a
1630    * side effect of getting the color scheme
1631    */
1632
1633   g_free (dummy);  
1634 }
1635
1636
1637 typedef struct {
1638   GHashTable *color_hash;
1639   gchar *tables[GTK_SETTINGS_SOURCE_APPLICATION + 1];
1640 } ColorSchemeData;
1641
1642
1643 static gboolean
1644 update_color_hash (ColorSchemeData   *data,
1645                    const gchar       *str, 
1646                    GtkSettingsSource  source)
1647 {
1648   gchar *copy, *s, *p, *name;
1649   GdkColor color;
1650   gboolean changed = FALSE;
1651
1652   if (data->tables[source] == NULL && str == NULL)
1653     return FALSE;
1654
1655   if (data->tables[source] != NULL && str != NULL &&
1656       strcmp (data->tables[source], str) == 0)
1657     return FALSE;
1658
1659   g_free (data->tables[source]);
1660   data->tables[source] = g_strdup (str);
1661
1662   copy = g_strdup (str);
1663
1664   s = copy;
1665   while (s && *s)
1666     {
1667       name = s;
1668       p = strchr (s, ':');
1669       if (p)
1670         {
1671           *p = '\0';
1672           p++;
1673         }
1674       else
1675         break;
1676
1677       while (*p == ' ')
1678         p++;
1679
1680       s = p;
1681       while (*s) 
1682         {
1683           if (*s == '\n')
1684             {
1685               *s = '\0';
1686               s++;
1687               break;
1688             }
1689           s++;
1690         }
1691
1692       if (gdk_color_parse (p, &color))
1693         {
1694           GdkColor *old;
1695
1696           old = g_hash_table_lookup (data->color_hash, name);
1697           if (!old || 
1698               (old->pixel <= source && !gdk_color_equal (old, &color)))
1699             {
1700               GdkColor *new;
1701               
1702               new = gdk_color_copy (&color);
1703               new->pixel = source;
1704   
1705               g_hash_table_insert (data->color_hash, g_strdup (name), new);
1706  
1707               changed = TRUE;
1708             }
1709         }
1710     }
1711
1712   g_free (copy);
1713
1714   return changed;
1715 }
1716
1717 static void
1718 color_scheme_data_free (ColorSchemeData *data)
1719 {
1720   gint i;
1721
1722   g_hash_table_unref (data->color_hash);
1723
1724   for (i = 0; i <= GTK_SETTINGS_SOURCE_APPLICATION; i++)
1725     g_free (data->tables[i]);
1726
1727   g_free (data);
1728 }
1729
1730 static void
1731 merge_color_scheme (GtkSettings       *settings, 
1732                     GValue            *value, 
1733                     GtkSettingsSource  source)
1734 {
1735   ColorSchemeData *data;
1736   const gchar *colors;
1737
1738   colors = g_value_get_string (value);
1739
1740   data = (ColorSchemeData *) g_object_get_data (G_OBJECT (settings),
1741                                                  "gtk-color-scheme");
1742   if (!data)
1743     {
1744       data = g_new0 (ColorSchemeData, 1);
1745       data->color_hash = g_hash_table_new_full (g_str_hash, g_str_equal, g_free,
1746                                                 (GDestroyNotify) gdk_color_free);
1747       g_object_set_data_full (G_OBJECT (settings), "gtk-color-scheme",
1748                               data, (GDestroyNotify) color_scheme_data_free);
1749     }
1750   
1751   if (update_color_hash (data, colors, source))
1752     g_object_notify (G_OBJECT (settings), "color-hash");
1753 }
1754
1755 static GHashTable *
1756 get_color_hash (GtkSettings *settings)
1757 {
1758   ColorSchemeData *data;
1759
1760   if (!g_object_get_data (G_OBJECT (settings), "gtk-color-scheme"))
1761     settings_update_color_scheme (settings);
1762   
1763   data = (ColorSchemeData *)g_object_get_data (G_OBJECT (settings), 
1764                                                "gtk-color-scheme");
1765
1766   if (!data)
1767     return NULL;
1768
1769   return data->color_hash;
1770 }
1771
1772 static void 
1773 append_color_scheme (gpointer key,
1774                      gpointer value,
1775                      gpointer data)
1776 {
1777   gchar *name = (gchar *)key;
1778   GdkColor *color = (GdkColor *)value;
1779   GString *string = (GString *)data;
1780
1781   g_string_append_printf (string, "%s: #%04x%04x%04x\n",
1782                           name, color->red, color->green, color->blue);
1783 }
1784
1785 static gchar *
1786 get_color_scheme (GtkSettings *settings)
1787 {
1788   ColorSchemeData *data;
1789   GString *string;
1790   
1791   data = (ColorSchemeData *) g_object_get_data (G_OBJECT (settings),
1792                                                 "gtk-color-scheme");
1793
1794   string = g_string_new ("");
1795
1796   g_hash_table_foreach (data->color_hash, append_color_scheme, string);
1797
1798   return g_string_free (string, FALSE);
1799 }
1800
1801
1802 #define __GTK_SETTINGS_C__
1803 #include "gtkaliasdef.c"