Pileus Git - ~andy/gtk/blob - 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   _gtk_rc_context_destroy (settings);
 528
 529   g_datalist_clear (&settings->queued_settings);
 530
 531   G_OBJECT_CLASS (gtk_settings_parent_class)->finalize (object);
 532 }
 533
 534 /**
 535  * gtk_settings_get_for_screen:
 536  * @screen : a #GdkScreen.
 537  *
 538  * Gets the #GtkSettings object for @screen, creating it if necessary.
 539  *
 540  * Return value: a #GtkSettings object.
 541  *
 542  * Since: 2.2
 543  */
 544 GtkSettings*
 545 gtk_settings_get_for_screen (GdkScreen *screen)
 546 {
 547   GtkSettings *settings;
 548
 549   g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
 550
 551   settings = g_object_get_data (G_OBJECT (screen), "gtk-settings");
 552   if (!settings)
 553     {
 554       settings = g_object_new (GTK_TYPE_SETTINGS, NULL);
 555       settings->screen = screen;
 556       g_object_set_data_full (G_OBJECT (screen), I_("gtk-settings"),
 557                               settings, g_object_unref);
 558
 559       gtk_rc_reparse_all_for_settings (settings, TRUE);
 560       settings_update_double_click (settings);
 561 #ifdef GDK_WINDOWING_X11
 562       settings_update_cursor_theme (settings);
 563       settings_update_resolution (settings);
 564       settings_update_font_options (settings);
 565 #endif
 566       settings_update_color_scheme (settings);
 567     }
 568
 569   return settings;
 570 }
 571
 572 /**
 573  * gtk_settings_get_default:
 574  *
 575  * Gets the #GtkSettings object for the default GDK screen, creating
 576  * it if necessary. See gtk_settings_get_for_screen().
 577  *
 578  * Return value: a #GtkSettings object. If there is no default
 579  *  screen, then returns %NULL.
 580  **/
 581 GtkSettings*
 582 gtk_settings_get_default (void)
 583 {
 584   GdkScreen *screen = gdk_screen_get_default ();
 585
 586   if (screen)
 587     return gtk_settings_get_for_screen (screen);
 588   else
 589     return NULL;
 590 }
 591
 592 static void
 593 gtk_settings_set_property (GObject      *object,
 594                            guint         property_id,
 595                            const GValue *value,
 596                            GParamSpec   *pspec)
 597 {
 598   GtkSettings *settings = GTK_SETTINGS (object);
 599
 600   g_value_copy (value, &settings->property_values[property_id - 1].value);
 601   settings->property_values[property_id - 1].source = GTK_SETTINGS_SOURCE_APPLICATION;
 602 }
 603
 604 static void
 605 gtk_settings_get_property (GObject     *object,
 606                            guint        property_id,
 607                            GValue      *value,
 608                            GParamSpec  *pspec)
 609 {
 610   GtkSettings *settings = GTK_SETTINGS (object);
 611   GType value_type = G_VALUE_TYPE (value);
 612   GType fundamental_type = G_TYPE_FUNDAMENTAL (value_type);
 613
 614   if (property_id == PROP_COLOR_HASH)
 615     {
 616       g_value_set_boxed (value, get_color_hash (settings));
 617       return;
 618     }
 619
 620   /* For enums and strings, we need to get the value as a string,
 621    * not as an int, since we support using names/nicks as the setting
 622    * value.
 623    */
 624   if ((g_value_type_transformable (G_TYPE_INT, value_type) &&
 625        !(fundamental_type == G_TYPE_ENUM || fundamental_type == G_TYPE_FLAGS)) ||
 626       g_value_type_transformable (G_TYPE_STRING, G_VALUE_TYPE (value)) ||
 627       g_value_type_transformable (GDK_TYPE_COLOR, G_VALUE_TYPE (value)))
 628     {
 629       if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION ||
 630           !gdk_screen_get_setting (settings->screen, pspec->name, value))
 631         g_value_copy (&settings->property_values[property_id - 1].value, value);
 632       else
 633         {
 634           if (pspec->param_id == PROP_COLOR_SCHEME)
 635             {
 636               merge_color_scheme (settings, value, GTK_SETTINGS_SOURCE_XSETTING);
 637               g_value_take_string (value, get_color_scheme (settings));
 638             }
 639
 640           g_param_value_validate (pspec, value);
 641         }
 642     }
 643   else
 644     {
 645       GValue val = { 0, };
 646
 647       /* Try to get xsetting as a string and parse it. */
 648
 649       g_value_init (&val, G_TYPE_STRING);
 650
 651       if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION ||
 652           !gdk_screen_get_setting (settings->screen, pspec->name, &val))
 653         {
 654           g_value_copy (&settings->property_values[property_id - 1].value, value);
 655         }
 656       else
 657         {
 658           GValue tmp_value = { 0, };
 659           GValue gstring_value = { 0, };
 660           GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser);
 661
 662           g_value_init (&gstring_value, G_TYPE_GSTRING);
 663           g_value_take_boxed (&gstring_value,
 664                               g_string_new (g_value_get_string (&val)));
 665
 666           g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
 667
 668           if (parser && _gtk_settings_parse_convert (parser, &gstring_value,
 669                                                      pspec, &tmp_value))
 670             {
 671               g_value_copy (&tmp_value, value);
 672               g_param_value_validate (pspec, value);
 673             }
 674           else
 675             {
 676               g_value_copy (&settings->property_values[property_id - 1].value, value);
 677             }
 678
 679           g_value_unset (&gstring_value);
 680           g_value_unset (&tmp_value);
 681         }
 682
 683       g_value_unset (&val);
 684     }
 685 }
 686
 687 static void
 688 gtk_settings_notify (GObject    *object,
 689                      GParamSpec *pspec)
 690 {
 691   GtkSettings *settings = GTK_SETTINGS (object);
 692   guint property_id = pspec->param_id;
 693
 694   if (settings->screen == NULL) /* initialization */
 695     return;
 696
 697   switch (property_id)
 698     {
 699     case PROP_MODULES:
 700       settings_update_modules (settings);
 701       break;
 702     case PROP_DOUBLE_CLICK_TIME:
 703     case PROP_DOUBLE_CLICK_DISTANCE:
 704       settings_update_double_click (settings);
 705       break;
 706     case PROP_COLOR_SCHEME:
 707       settings_update_color_scheme (settings);
 708       break;
 709 #ifdef GDK_WINDOWING_X11
 710     case PROP_XFT_DPI:
 711       settings_update_resolution (settings);
 712       /* This is a hack because with gtk_rc_reset_styles() doesn't get
 713        * widgets with gtk_widget_style_set(), and also causes more
 714        * recomputation than necessary.
 715        */
 716       gtk_rc_reset_styles (GTK_SETTINGS (object));
 717       break;
 718     case PROP_XFT_ANTIALIAS:
 719     case PROP_XFT_HINTING:
 720     case PROP_XFT_HINTSTYLE:
 721     case PROP_XFT_RGBA:
 722       settings_update_font_options (settings);
 723       gtk_rc_reset_styles (GTK_SETTINGS (object));
 724       break;
 725     case PROP_CURSOR_THEME_NAME:
 726     case PROP_CURSOR_THEME_SIZE:
 727       settings_update_cursor_theme (settings);
 728       break;
 729 #endif /* GDK_WINDOWING_X11 */
 730     }
 731 }
 732
 733 gboolean
 734 _gtk_settings_parse_convert (GtkRcPropertyParser parser,
 735                              const GValue       *src_value,
 736                              GParamSpec         *pspec,
 737                              GValue             *dest_value)
 738 {
 739   gboolean success = FALSE;
 740
 741   g_return_val_if_fail (G_VALUE_HOLDS (dest_value, G_PARAM_SPEC_VALUE_TYPE (pspec)), FALSE);
 742
 743   if (parser)
 744     {
 745       GString *gstring;
 746       gboolean free_gstring = TRUE;
 747
 748       if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING))
 749         {
 750           gstring = g_value_get_boxed (src_value);
 751           free_gstring = FALSE;
 752         }
 753       else if (G_VALUE_HOLDS_LONG (src_value))
 754         {
 755           gstring = g_string_new (NULL);
 756           g_string_append_printf (gstring, "%ld", g_value_get_long (src_value));
 757         }
 758       else if (G_VALUE_HOLDS_DOUBLE (src_value))
 759         {
 760           gstring = g_string_new (NULL);
 761           g_string_append_printf (gstring, "%f", g_value_get_double (src_value));
 762         }
 763       else if (G_VALUE_HOLDS_STRING (src_value))
 764         {
 765           gchar *tstr = g_strescape (g_value_get_string (src_value), NULL);
 766
 767           gstring = g_string_new ("\"");
 768           g_string_append (gstring, tstr);
 769           g_string_append_c (gstring, '\"');
 770           g_free (tstr);
 771         }
 772       else
 773         {
 774           g_return_val_if_fail (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING), FALSE);
 775           gstring = NULL; /* silence compiler */
 776         }
 777
 778       success = (parser (pspec, gstring, dest_value) &&
 779                  !g_param_value_validate (pspec, dest_value));
 780
 781       if (free_gstring)
 782         g_string_free (gstring, TRUE);
 783     }
 784   else if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING))
 785     {
 786       if (G_VALUE_HOLDS (dest_value, G_TYPE_STRING))
 787         {
 788           GString *gstring = g_value_get_boxed (src_value);
 789
 790           g_value_set_string (dest_value, gstring ? gstring->str : NULL);
 791           success = !g_param_value_validate (pspec, dest_value);
 792         }
 793     }
 794   else if (g_value_type_transformable (G_VALUE_TYPE (src_value), G_VALUE_TYPE (dest_value)))
 795     success = g_param_value_convert (pspec, src_value, dest_value, TRUE);
 796
 797   return success;
 798 }
 799
 800 static void
 801 apply_queued_setting (GtkSettings             *data,
 802                       GParamSpec              *pspec,
 803                       GtkSettingsValuePrivate *qvalue)
 804 {
 805   GValue tmp_value = { 0, };
 806   GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser);
 807
 808   g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
 809   if (_gtk_settings_parse_convert (parser, &qvalue->public.value,
 810                                    pspec, &tmp_value))
 811     {
 812       if (pspec->param_id == PROP_COLOR_SCHEME)
 813         {
 814           merge_color_scheme (data, &tmp_value, qvalue->source);
 815           g_object_set_property (G_OBJECT (data), pspec->name, &tmp_value);
 816           data->property_values[pspec->param_id - 1].source = GTK_SETTINGS_SOURCE_DEFAULT;
 817         }
 818
 819       else if (data->property_values[pspec->param_id - 1].source <= qvalue->source)
 820         {
 821           g_object_set_property (G_OBJECT (data), pspec->name, &tmp_value);
 822           data->property_values[pspec->param_id - 1].source = qvalue->source;
 823         }
 824     }
 825   else
 826     {
 827       gchar *debug = g_strdup_value_contents (&qvalue->public.value);
 828
 829       g_message ("%s: failed to retrieve property `%s' of type `%s' from rc file value \"%s\" of type `%s'",
 830                  qvalue->public.origin ? qvalue->public.origin : "(for origin information, set GTK_DEBUG)",
 831                  pspec->name,
 832                  g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)),
 833                  debug,
 834                  G_VALUE_TYPE_NAME (&tmp_value));
 835       g_free (debug);
 836     }
 837   g_value_unset (&tmp_value);
 838 }
 839
 840 static guint
 841 settings_install_property_parser (GtkSettingsClass   *class,
 842                                   GParamSpec         *pspec,
 843                                   GtkRcPropertyParser parser)
 844 {
 845   GSList *node, *next;
 846
 847   switch (G_TYPE_FUNDAMENTAL (G_PARAM_SPEC_VALUE_TYPE (pspec)))
 848     {
 849     case G_TYPE_BOOLEAN:
 850     case G_TYPE_UCHAR:
 851     case G_TYPE_CHAR:
 852     case G_TYPE_UINT:
 853     case G_TYPE_INT:
 854     case G_TYPE_ULONG:
 855     case G_TYPE_LONG:
 856     case G_TYPE_FLOAT:
 857     case G_TYPE_DOUBLE:
 858     case G_TYPE_STRING:
 859       break;
 860     default:
 861       if (!parser)
 862         {
 863           g_warning (G_STRLOC ": parser needs to be specified for property \"%s\" of type `%s'",
 864                      pspec->name, g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)));
 865           return 0;
 866         }
 867     }
 868   if (g_object_class_find_property (G_OBJECT_CLASS (class), pspec->name))
 869     {
 870       g_warning (G_STRLOC ": an rc-data property \"%s\" already exists",
 871                  pspec->name);
 872       return 0;
 873     }
 874
 875   for (node = object_list; node; node = node->next)
 876     g_object_freeze_notify (node->data);
 877
 878   g_object_class_install_property (G_OBJECT_CLASS (class), ++class_n_properties, pspec);
 879   g_param_spec_set_qdata (pspec, quark_property_parser, (gpointer) parser);
 880
 881   for (node = object_list; node; node = node->next)
 882     {
 883       GtkSettings *settings = node->data;
 884       GtkSettingsValuePrivate *qvalue;
 885
 886       settings->property_values = g_renew (GtkSettingsPropertyValue, settings->property_values, class_n_properties);
 887       settings->property_values[class_n_properties - 1].value.g_type = 0;
 888       g_value_init (&settings->property_values[class_n_properties - 1].value, G_PARAM_SPEC_VALUE_TYPE (pspec));
 889       g_param_value_set_default (pspec, &settings->property_values[class_n_properties - 1].value);
 890       settings->property_values[class_n_properties - 1].source = GTK_SETTINGS_SOURCE_DEFAULT;
 891       g_object_notify (G_OBJECT (settings), pspec->name);
 892
 893       qvalue = g_datalist_get_data (&settings->queued_settings, pspec->name);
 894       if (qvalue)
 895         apply_queued_setting (settings, pspec, qvalue);
 896     }
 897
 898   for (node = object_list; node; node = next)
 899     {
 900       next = node->next;
 901       g_object_thaw_notify (node->data);
 902     }
 903
 904   return class_n_properties;
 905 }
 906
 907 GtkRcPropertyParser
 908 _gtk_rc_property_parser_from_type (GType type)
 909 {
 910   if (type == GDK_TYPE_COLOR)
 911     return gtk_rc_property_parse_color;
 912   else if (type == GTK_TYPE_REQUISITION)
 913     return gtk_rc_property_parse_requisition;
 914   else if (type == GTK_TYPE_BORDER)
 915     return gtk_rc_property_parse_border;
 916   else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_ENUM && G_TYPE_IS_DERIVED (type))
 917     return gtk_rc_property_parse_enum;
 918   else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_FLAGS && G_TYPE_IS_DERIVED (type))
 919     return gtk_rc_property_parse_flags;
 920   else
 921     return NULL;
 922 }
 923
 924 void
 925 gtk_settings_install_property (GParamSpec *pspec)
 926 {
 927   GtkRcPropertyParser parser;
 928
 929   g_return_if_fail (G_IS_PARAM_SPEC (pspec));
 930
 931   parser = _gtk_rc_property_parser_from_type (G_PARAM_SPEC_VALUE_TYPE (pspec));
 932
 933   settings_install_property_parser (gtk_type_class (GTK_TYPE_SETTINGS), pspec, parser);
 934 }
 935
 936 void
 937 gtk_settings_install_property_parser (GParamSpec          *pspec,
 938                                       GtkRcPropertyParser  parser)
 939 {
 940   g_return_if_fail (G_IS_PARAM_SPEC (pspec));
 941   g_return_if_fail (parser != NULL);
 942
 943   settings_install_property_parser (gtk_type_class (GTK_TYPE_SETTINGS), pspec, parser);
 944 }
 945
 946 static void
 947 free_value (gpointer data)
 948 {
 949   GtkSettingsValuePrivate *qvalue = data;
 950
 951   g_value_unset (&qvalue->public.value);
 952   g_free (qvalue->public.origin);
 953   g_free (qvalue);
 954 }
 955
 956 static void
 957 gtk_settings_set_property_value_internal (GtkSettings            *settings,
 958                                           const gchar            *prop_name,
 959                                           const GtkSettingsValue *new_value,
 960                                           GtkSettingsSource       source)
 961 {
 962   GtkSettingsValuePrivate *qvalue;
 963   GParamSpec *pspec;
 964   gchar *name;
 965   GQuark name_quark;
 966
 967   if (!G_VALUE_HOLDS_LONG (&new_value->value) &&
 968       !G_VALUE_HOLDS_DOUBLE (&new_value->value) &&
 969       !G_VALUE_HOLDS_STRING (&new_value->value) &&
 970       !G_VALUE_HOLDS (&new_value->value, G_TYPE_GSTRING))
 971     {
 972       g_warning (G_STRLOC ": value type invalid");
 973       return;
 974     }
 975
 976   name = g_strdup (prop_name);
 977   g_strcanon (name, G_CSET_DIGITS "-" G_CSET_a_2_z G_CSET_A_2_Z, '-');
 978   name_quark = g_quark_from_string (name);
 979   g_free (name);
 980
 981   qvalue = g_datalist_id_get_data (&settings->queued_settings, name_quark);
 982   if (!qvalue)
 983     {
 984       qvalue = g_new0 (GtkSettingsValuePrivate, 1);
 985       g_datalist_id_set_data_full (&settings->queued_settings, name_quark, qvalue, free_value);
 986     }
 987   else
 988     {
 989       g_free (qvalue->public.origin);
 990       g_value_unset (&qvalue->public.value);
 991     }
 992   qvalue->public.origin = g_strdup (new_value->origin);
 993   g_value_init (&qvalue->public.value, G_VALUE_TYPE (&new_value->value));
 994   g_value_copy (&new_value->value, &qvalue->public.value);
 995   qvalue->source = source;
 996   pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (settings), g_quark_to_string (name_quark));
 997   if (pspec)
 998     apply_queued_setting (settings, pspec, qvalue);
 999 }
1000
1001 void
1002 gtk_settings_set_property_value (GtkSettings            *settings,
1003                                  const gchar            *prop_name,
1004                                  const GtkSettingsValue *new_value)
1005 {
1006   g_return_if_fail (GTK_SETTINGS (settings));
1007   g_return_if_fail (prop_name != NULL);
1008   g_return_if_fail (new_value != NULL);
1009
1010   gtk_settings_set_property_value_internal (settings, prop_name, new_value,
1011                                             GTK_SETTINGS_SOURCE_APPLICATION);
1012 }
1013
1014 void
1015 _gtk_settings_set_property_value_from_rc (GtkSettings            *settings,
1016                                           const gchar            *prop_name,
1017                                           const GtkSettingsValue *new_value)
1018 {
1019   g_return_if_fail (GTK_SETTINGS (settings));
1020   g_return_if_fail (prop_name != NULL);
1021   g_return_if_fail (new_value != NULL);
1022
1023   gtk_settings_set_property_value_internal (settings, prop_name, new_value,
1024                                             GTK_SETTINGS_SOURCE_RC_FILE);
1025 }
1026
1027 void
1028 gtk_settings_set_string_property (GtkSettings *settings,
1029                                   const gchar *name,
1030                                   const gchar *v_string,
1031                                   const gchar *origin)
1032 {
1033   GtkSettingsValue svalue = { NULL, { 0, }, };
1034
1035   g_return_if_fail (GTK_SETTINGS (settings));
1036   g_return_if_fail (name != NULL);
1037   g_return_if_fail (v_string != 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
1057   svalue.origin = (gchar*) origin;
1058   g_value_init (&svalue.value, G_TYPE_LONG);
1059   g_value_set_long (&svalue.value, v_long);
1060   gtk_settings_set_property_value (settings, name, &svalue);
1061   g_value_unset (&svalue.value);
1062 }
1063
1064 void
1065 gtk_settings_set_double_property (GtkSettings *settings,
1066                                   const gchar *name,
1067                                   gdouble      v_double,
1068                                   const gchar *origin)
1069 {
1070   GtkSettingsValue svalue = { NULL, { 0, }, };
1071
1072   g_return_if_fail (GTK_SETTINGS (settings));
1073   g_return_if_fail (name != NULL);
1074
1075   svalue.origin = (gchar*) origin;
1076   g_value_init (&svalue.value, G_TYPE_DOUBLE);
1077   g_value_set_double (&svalue.value, v_double);
1078   gtk_settings_set_property_value (settings, name, &svalue);
1079   g_value_unset (&svalue.value);
1080 }
1081
1082 /**
1083  * gtk_rc_property_parse_color:
1084  * @pspec: a #GParamSpec
1085  * @gstring: the #GString to be parsed
1086  * @property_value: a #GValue which must hold #GdkColor values.
1087  *
1088  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1089  * or gtk_widget_class_install_style_property_parser() which parses a
1090  * color given either by its name or in the form
1091  * <literal>{ red, green, blue }</literal> where %red, %green and
1092  * %blue are integers between 0 and 65535 or floating-point numbers
1093  * between 0 and 1.
1094  *
1095  * Return value: %TRUE if @gstring could be parsed and @property_value
1096  * has been set to the resulting #GdkColor.
1097  **/
1098 gboolean
1099 gtk_rc_property_parse_color (const GParamSpec *pspec,
1100                              const GString    *gstring,
1101                              GValue           *property_value)
1102 {
1103   GdkColor color = { 0, 0, 0, 0, };
1104   GScanner *scanner;
1105   gboolean success;
1106
1107   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1108   g_return_val_if_fail (G_VALUE_HOLDS (property_value, GDK_TYPE_COLOR), FALSE);
1109
1110   scanner = gtk_rc_scanner_new ();
1111   g_scanner_input_text (scanner, gstring->str, gstring->len);
1112   if (gtk_rc_parse_color (scanner, &color) == G_TOKEN_NONE &&
1113       g_scanner_get_next_token (scanner) == G_TOKEN_EOF)
1114     {
1115       g_value_set_boxed (property_value, &color);
1116       success = TRUE;
1117     }
1118   else
1119     success = FALSE;
1120   g_scanner_destroy (scanner);
1121
1122   return success;
1123 }
1124
1125 /**
1126  * gtk_rc_property_parse_enum:
1127  * @pspec: a #GParamSpec
1128  * @gstring: the #GString to be parsed
1129  * @property_value: a #GValue which must hold enum values.
1130  *
1131  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1132  * or gtk_widget_class_install_style_property_parser() which parses a single
1133  * enumeration value.
1134  *
1135  * The enumeration value can be specified by its name, its nickname or
1136  * its numeric value. For consistency with flags parsing, the value
1137  * may be surrounded by parentheses.
1138  *
1139  * Return value: %TRUE if @gstring could be parsed and @property_value
1140  * has been set to the resulting #GEnumValue.
1141  **/
1142 gboolean
1143 gtk_rc_property_parse_enum (const GParamSpec *pspec,
1144                             const GString    *gstring,
1145                             GValue           *property_value)
1146 {
1147   gboolean need_closing_brace = FALSE, success = FALSE;
1148   GScanner *scanner;
1149   GEnumValue *enum_value = NULL;
1150
1151   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1152   g_return_val_if_fail (G_VALUE_HOLDS_ENUM (property_value), FALSE);
1153
1154   scanner = gtk_rc_scanner_new ();
1155   g_scanner_input_text (scanner, gstring->str, gstring->len);
1156
1157   /* we just want to parse _one_ value, but for consistency with flags parsing
1158    * we support optional parenthesis
1159    */
1160   g_scanner_get_next_token (scanner);
1161   if (scanner->token == '(')
1162     {
1163       need_closing_brace = TRUE;
1164       g_scanner_get_next_token (scanner);
1165     }
1166   if (scanner->token == G_TOKEN_IDENTIFIER)
1167     {
1168       GEnumClass *class = G_PARAM_SPEC_ENUM (pspec)->enum_class;
1169
1170       enum_value = g_enum_get_value_by_name (class, scanner->value.v_identifier);
1171       if (!enum_value)
1172         enum_value = g_enum_get_value_by_nick (class, scanner->value.v_identifier);
1173       if (enum_value)
1174         {
1175           g_value_set_enum (property_value, enum_value->value);
1176           success = TRUE;
1177         }
1178     }
1179   else if (scanner->token == G_TOKEN_INT)
1180     {
1181       g_value_set_enum (property_value, scanner->value.v_int);
1182       success = TRUE;
1183     }
1184   if (need_closing_brace && g_scanner_get_next_token (scanner) != ')')
1185     success = FALSE;
1186   if (g_scanner_get_next_token (scanner) != G_TOKEN_EOF)
1187     success = FALSE;
1188
1189   g_scanner_destroy (scanner);
1190
1191   return success;
1192 }
1193
1194 static guint
1195 parse_flags_value (GScanner    *scanner,
1196                    GFlagsClass *class,
1197                    guint       *number)
1198 {
1199   g_scanner_get_next_token (scanner);
1200   if (scanner->token == G_TOKEN_IDENTIFIER)
1201     {
1202       GFlagsValue *flags_value;
1203
1204       flags_value = g_flags_get_value_by_name (class, scanner->value.v_identifier);
1205       if (!flags_value)
1206         flags_value = g_flags_get_value_by_nick (class, scanner->value.v_identifier);
1207       if (flags_value)
1208         {
1209           *number |= flags_value->value;
1210           return G_TOKEN_NONE;
1211         }
1212     }
1213   else if (scanner->token == G_TOKEN_INT)
1214     {
1215       *number |= scanner->value.v_int;
1216       return G_TOKEN_NONE;
1217     }
1218   return G_TOKEN_IDENTIFIER;
1219 }
1220
1221 /**
1222  * gtk_rc_property_parse_flags:
1223  * @pspec: a #GParamSpec
1224  * @gstring: the #GString to be parsed
1225  * @property_value: a #GValue which must hold flags values.
1226  *
1227  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1228  * or gtk_widget_class_install_style_property_parser() which parses flags.
1229  *
1230  * Flags can be specified by their name, their nickname or
1231  * numerically. Multiple flags can be specified in the form
1232  * <literal>"( flag1 | flag2 | ... )"</literal>.
1233  *
1234  * Return value: %TRUE if @gstring could be parsed and @property_value
1235  * has been set to the resulting flags value.
1236  **/
1237 gboolean
1238 gtk_rc_property_parse_flags (const GParamSpec *pspec,
1239                              const GString    *gstring,
1240                              GValue           *property_value)
1241 {
1242   GFlagsClass *class;
1243    gboolean success = FALSE;
1244   GScanner *scanner;
1245
1246   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1247   g_return_val_if_fail (G_VALUE_HOLDS_FLAGS (property_value), FALSE);
1248
1249   class = G_PARAM_SPEC_FLAGS (pspec)->flags_class;
1250   scanner = gtk_rc_scanner_new ();
1251   g_scanner_input_text (scanner, gstring->str, gstring->len);
1252
1253   /* parse either a single flags value or a "\( ... [ \| ... ] \)" compound */
1254   if (g_scanner_peek_next_token (scanner) == G_TOKEN_IDENTIFIER ||
1255       scanner->next_token == G_TOKEN_INT)
1256     {
1257       guint token, flags_value = 0;
1258
1259       token = parse_flags_value (scanner, class, &flags_value);
1260
1261       if (token == G_TOKEN_NONE && g_scanner_peek_next_token (scanner) == G_TOKEN_EOF)
1262         {
1263           success = TRUE;
1264           g_value_set_flags (property_value, flags_value);
1265         }
1266
1267     }
1268   else if (g_scanner_get_next_token (scanner) == '(')
1269     {
1270       guint token, flags_value = 0;
1271
1272       /* parse first value */
1273       token = parse_flags_value (scanner, class, &flags_value);
1274
1275       /* parse nth values, preceeded by '|' */
1276       while (token == G_TOKEN_NONE && g_scanner_get_next_token (scanner) == '|')
1277         token = parse_flags_value (scanner, class, &flags_value);
1278
1279       /* done, last token must have closed expression */
1280       if (token == G_TOKEN_NONE && scanner->token == ')' &&
1281           g_scanner_peek_next_token (scanner) == G_TOKEN_EOF)
1282         {
1283           g_value_set_flags (property_value, flags_value);
1284           success = TRUE;
1285         }
1286     }
1287   g_scanner_destroy (scanner);
1288
1289   return success;
1290 }
1291
1292 static gboolean
1293 get_braced_int (GScanner *scanner,
1294                 gboolean  first,
1295                 gboolean  last,
1296                 gint     *value)
1297 {
1298   if (first)
1299     {
1300       g_scanner_get_next_token (scanner);
1301       if (scanner->token != '{')
1302         return FALSE;
1303     }
1304
1305   g_scanner_get_next_token (scanner);
1306   if (scanner->token != G_TOKEN_INT)
1307     return FALSE;
1308
1309   *value = scanner->value.v_int;
1310
1311   if (last)
1312     {
1313       g_scanner_get_next_token (scanner);
1314       if (scanner->token != '}')
1315         return FALSE;
1316     }
1317   else
1318     {
1319       g_scanner_get_next_token (scanner);
1320       if (scanner->token != ',')
1321         return FALSE;
1322     }
1323
1324   return TRUE;
1325 }
1326
1327 /**
1328  * gtk_rc_property_parse_requisition:
1329  * @pspec: a #GParamSpec
1330  * @gstring: the #GString to be parsed
1331  * @property_value: a #GValue which must hold boxed values.
1332  *
1333  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1334  * or gtk_widget_class_install_style_property_parser() which parses a
1335  * requisition in the form
1336  * <literal>"{ width, height }"</literal> for integers %width and %height.
1337  *
1338  * Return value: %TRUE if @gstring could be parsed and @property_value
1339  * has been set to the resulting #GtkRequisition.
1340  **/
1341 gboolean
1342 gtk_rc_property_parse_requisition  (const GParamSpec *pspec,
1343                                     const GString    *gstring,
1344                                     GValue           *property_value)
1345 {
1346   GtkRequisition requisition;
1347   GScanner *scanner;
1348   gboolean success = FALSE;
1349
1350   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1351   g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE);
1352
1353   scanner = gtk_rc_scanner_new ();
1354   g_scanner_input_text (scanner, gstring->str, gstring->len);
1355
1356   if (get_braced_int (scanner, TRUE, FALSE, &requisition.width) &&
1357       get_braced_int (scanner, FALSE, TRUE, &requisition.height))
1358     {
1359       g_value_set_boxed (property_value, &requisition);
1360       success = TRUE;
1361     }
1362
1363   g_scanner_destroy (scanner);
1364
1365   return success;
1366 }
1367
1368 /**
1369  * gtk_rc_property_parse_border:
1370  * @pspec: a #GParamSpec
1371  * @gstring: the #GString to be parsed
1372  * @property_value: a #GValue which must hold boxed values.
1373  *
1374  * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser()
1375  * or gtk_widget_class_install_style_property_parser() which parses
1376  * borders in the form
1377  * <literal>"{ left, right, top, bottom }"</literal> for integers
1378  * %left, %right, %top and %bottom.
1379  *
1380  * Return value: %TRUE if @gstring could be parsed and @property_value
1381  * has been set to the resulting #GtkBorder.
1382  **/
1383 gboolean
1384 gtk_rc_property_parse_border (const GParamSpec *pspec,
1385                               const GString    *gstring,
1386                               GValue           *property_value)
1387 {
1388   GtkBorder border;
1389   GScanner *scanner;
1390   gboolean success = FALSE;
1391
1392   g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE);
1393   g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE);
1394
1395   scanner = gtk_rc_scanner_new ();
1396   g_scanner_input_text (scanner, gstring->str, gstring->len);
1397
1398   if (get_braced_int (scanner, TRUE, FALSE, &border.left) &&
1399       get_braced_int (scanner, FALSE, FALSE, &border.right) &&
1400       get_braced_int (scanner, FALSE, FALSE, &border.top) &&
1401       get_braced_int (scanner, FALSE, TRUE, &border.bottom))
1402     {
1403       g_value_set_boxed (property_value, &border);
1404       success = TRUE;
1405     }
1406
1407   g_scanner_destroy (scanner);
1408
1409   return success;
1410 }
1411
1412 void
1413 _gtk_settings_handle_event (GdkEventSetting *event)
1414 {
1415   GtkSettings *settings = gtk_settings_get_for_screen (gdk_drawable_get_screen (event->window));
1416
1417   if (g_object_class_find_property (G_OBJECT_GET_CLASS (settings), event->name))
1418     g_object_notify (G_OBJECT (settings), event->name);
1419 }
1420
1421 static void
1422 reset_rc_values_foreach (GQuark    key_id,
1423                          gpointer  data,
1424                          gpointer  user_data)
1425 {
1426   GtkSettingsValuePrivate *qvalue = data;
1427   GSList **to_reset = user_data;
1428
1429   if (qvalue->source == GTK_SETTINGS_SOURCE_RC_FILE)
1430     *to_reset = g_slist_prepend (*to_reset, GUINT_TO_POINTER (key_id));
1431 }
1432
1433 void
1434 _gtk_settings_reset_rc_values (GtkSettings *settings)
1435 {
1436   GSList *to_reset = NULL;
1437   GSList *tmp_list;
1438   GParamSpec **pspecs, **p;
1439   gint i;
1440
1441   /* Remove any queued settings
1442    */
1443   g_datalist_foreach (&settings->queued_settings,
1444                       reset_rc_values_foreach,
1445                       &to_reset);
1446
1447   for (tmp_list = to_reset; tmp_list; tmp_list = tmp_list->next)
1448     {
1449       GQuark key_id = GPOINTER_TO_UINT (tmp_list->data);
1450       g_datalist_id_remove_data (&settings->queued_settings, key_id);
1451     }
1452
1453   /* Now reset the active settings
1454    */
1455   pspecs = g_object_class_list_properties (G_OBJECT_GET_CLASS (settings), NULL);
1456   i = 0;
1457
1458   g_object_freeze_notify (G_OBJECT (settings));
1459   for (p = pspecs; *p; p++)
1460     {
1461       if (settings->property_values[i].source == GTK_SETTINGS_SOURCE_RC_FILE)
1462         {
1463           GParamSpec *pspec = *p;
1464
1465           g_param_value_set_default (pspec, &settings->property_values[i].value);
1466           g_object_notify (G_OBJECT (settings), pspec->name);
1467         }
1468       i++;
1469     }
1470   g_object_thaw_notify (G_OBJECT (settings));
1471   g_free (pspecs);
1472 }
1473
1474 static void
1475 settings_update_double_click (GtkSettings *settings)
1476 {
1477   if (gdk_screen_get_number (settings->screen) == 0)
1478     {
1479       GdkDisplay *display = gdk_screen_get_display (settings->screen);
1480       gint double_click_time;
1481       gint double_click_distance;
1482
1483       g_object_get (settings,
1484                     "gtk-double-click-time", &double_click_time,
1485                     "gtk-double-click-distance", &double_click_distance,
1486                     NULL);
1487
1488       gdk_display_set_double_click_time (display, double_click_time);
1489       gdk_display_set_double_click_distance (display, double_click_distance);
1490     }
1491 }
1492
1493 static void
1494 settings_update_modules (GtkSettings *settings)
1495 {
1496   gchar *modules;
1497
1498   g_object_get (settings,
1499                 "gtk-modules", &modules,
1500                 NULL);
1501
1502   _gtk_modules_settings_changed (settings, modules);
1503
1504   g_free (modules);
1505 }
1506
1507 #ifdef GDK_WINDOWING_X11
1508 static void
1509 settings_update_cursor_theme (GtkSettings *settings)
1510 {
1511   GdkDisplay *display = gdk_screen_get_display (settings->screen);
1512   gchar *theme = NULL;
1513   gint size = 0;
1514
1515   g_object_get (settings,
1516                 "gtk-cursor-theme-name", &theme,
1517                 "gtk-cursor-theme-size", &size,
1518                 NULL);
1519
1520   gdk_x11_display_set_cursor_theme (display, theme, size);
1521
1522   g_free (theme);
1523 }
1524
1525 static void
1526 settings_update_font_options (GtkSettings *settings)
1527 {
1528   gint hinting;
1529   gchar *hint_style_str;
1530   cairo_hint_style_t hint_style = CAIRO_HINT_STYLE_DEFAULT;
1531   gint antialias;
1532   cairo_antialias_t antialias_mode = CAIRO_ANTIALIAS_DEFAULT;
1533   gchar *rgba_str;
1534   cairo_subpixel_order_t subpixel_order = CAIRO_SUBPIXEL_ORDER_DEFAULT;
1535   cairo_font_options_t *options;
1536
1537   g_object_get (settings,
1538                 "gtk-xft-antialias", &antialias,
1539                 "gtk-xft-hinting", &hinting,
1540                 "gtk-xft-hintstyle", &hint_style_str,
1541                 "gtk-xft-rgba", &rgba_str,
1542                 NULL);
1543
1544   options = cairo_font_options_create ();
1545
1546   /* hint_metrics = FALSE should never be set for user interface code.
1547    */
1548   cairo_font_options_set_hint_metrics (options, CAIRO_HINT_METRICS_ON);
1549
1550   if (hinting >= 0 && !hinting)
1551     {
1552       hint_style = CAIRO_HINT_STYLE_NONE;
1553     }
1554   else if (hint_style_str)
1555     {
1556       if (strcmp (hint_style_str, "hintnone") == 0)
1557         hint_style = CAIRO_HINT_STYLE_NONE;
1558       else if (strcmp (hint_style_str, "hintslight") == 0)
1559         hint_style = CAIRO_HINT_STYLE_SLIGHT;
1560       else if (strcmp (hint_style_str, "hintmedium") == 0)
1561         hint_style = CAIRO_HINT_STYLE_MEDIUM;
1562       else if (strcmp (hint_style_str, "hintfull") == 0)
1563         hint_style = CAIRO_HINT_STYLE_FULL;
1564     }
1565
1566   if (hint_style_str)
1567     g_free (hint_style_str);
1568
1569   cairo_font_options_set_hint_style (options, hint_style);
1570
1571   if (rgba_str)
1572     {
1573       if (strcmp (rgba_str, "rgb") == 0)
1574         subpixel_order = CAIRO_SUBPIXEL_ORDER_RGB;
1575       else if (strcmp (rgba_str, "bgr") == 0)
1576         subpixel_order = CAIRO_SUBPIXEL_ORDER_BGR;
1577       else if (strcmp (rgba_str, "vrgb") == 0)
1578         subpixel_order = CAIRO_SUBPIXEL_ORDER_VRGB;
1579       else if (strcmp (rgba_str, "vbgr") == 0)
1580         subpixel_order = CAIRO_SUBPIXEL_ORDER_VBGR;
1581
1582       g_free (rgba_str);
1583     }
1584
1585   cairo_font_options_set_subpixel_order (options, subpixel_order);
1586
1587   if (antialias >= 0 && !antialias)
1588     antialias_mode = CAIRO_ANTIALIAS_NONE;
1589   else if (subpixel_order != CAIRO_SUBPIXEL_ORDER_DEFAULT)
1590     antialias_mode = CAIRO_ANTIALIAS_SUBPIXEL;
1591   else if (antialias >= 0)
1592     antialias_mode = CAIRO_ANTIALIAS_GRAY;
1593
1594   cairo_font_options_set_antialias (options, antialias_mode);
1595
1596   gdk_screen_set_font_options (settings->screen, options);
1597
1598   cairo_font_options_destroy (options);
1599 }
1600
1601 static void
1602 settings_update_resolution (GtkSettings *settings)
1603 {
1604   gint dpi_int;
1605   double dpi;
1606
1607   g_object_get (settings,
1608                 "gtk-xft-dpi", &dpi_int,
1609                 NULL);
1610
1611   if (dpi_int > 0)
1612     dpi = dpi_int / 1024.;
1613   else
1614     dpi = -1.;
1615
1616   gdk_screen_set_resolution (settings->screen, dpi);
1617 }
1618 #endif
1619
1620 static void
1621 settings_update_color_scheme (GtkSettings *settings)
1622 {
1623   gchar *dummy;
1624
1625   g_object_get (settings, "gtk-color-scheme", &dummy, NULL);
1626
1627   /* nothing to do here, the color hash is updated as a
1628    * side effect of getting the color scheme
1629    */
1630
1631   g_free (dummy);
1632 }
1633
1634
1635 typedef struct {
1636   GHashTable *color_hash;
1637   gchar *tables[GTK_SETTINGS_SOURCE_APPLICATION + 1];
1638 } ColorSchemeData;
1639
1640
1641 static gboolean
1642 update_color_hash (ColorSchemeData   *data,
1643                    const gchar       *str,
1644                    GtkSettingsSource  source)
1645 {
1646   gchar *copy, *s, *p, *name;
1647   GdkColor color;
1648   gboolean changed = FALSE;
1649
1650   if (data->tables[source] == NULL && str == NULL)
1651     return FALSE;
1652
1653   if (data->tables[source] != NULL && str != NULL &&
1654       strcmp (data->tables[source], str) == 0)
1655     return FALSE;
1656
1657   g_free (data->tables[source]);
1658   data->tables[source] = g_strdup (str);
1659
1660   copy = g_strdup (str);
1661
1662   s = copy;
1663   while (s && *s)
1664     {
1665       name = s;
1666       p = strchr (s, ':');
1667       if (p)
1668         {
1669           *p = '\0';
1670           p++;
1671         }
1672       else
1673         break;
1674
1675       while (*p == ' ')
1676         p++;
1677
1678       s = p;
1679       while (*s)
1680         {
1681           if (*s == '\n')
1682             {
1683               *s = '\0';
1684               s++;
1685               break;
1686             }
1687           s++;
1688         }
1689
1690       if (gdk_color_parse (p, &color))
1691         {
1692           GdkColor *old;
1693
1694           old = g_hash_table_lookup (data->color_hash, name);
1695           if (!old ||
1696               (old->pixel <= source && !gdk_color_equal (old, &color)))
1697             {
1698               GdkColor *new;
1699
1700               new = gdk_color_copy (&color);
1701               new->pixel = source;
1702
1703               g_hash_table_insert (data->color_hash, g_strdup (name), new);
1704
1705               changed = TRUE;
1706             }
1707         }
1708     }
1709
1710   g_free (copy);
1711
1712   return changed;
1713 }
1714
1715 static void
1716 color_scheme_data_free (ColorSchemeData *data)
1717 {
1718   gint i;
1719
1720   g_hash_table_unref (data->color_hash);
1721
1722   for (i = 0; i <= GTK_SETTINGS_SOURCE_APPLICATION; i++)
1723     g_free (data->tables[i]);
1724
1725   g_free (data);
1726 }
1727
1728 static void
1729 merge_color_scheme (GtkSettings       *settings,
1730                     GValue            *value,
1731                     GtkSettingsSource  source)
1732 {
1733   ColorSchemeData *data;
1734   const gchar *colors;
1735
1736   colors = g_value_get_string (value);
1737
1738   data = (ColorSchemeData *) g_object_get_data (G_OBJECT (settings),
1739                                                  "gtk-color-scheme");
1740   if (!data)
1741     {
1742       data = g_new0 (ColorSchemeData, 1);
1743       data->color_hash = g_hash_table_new_full (g_str_hash, g_str_equal, g_free,
1744                                                 (GDestroyNotify) gdk_color_free);
1745       g_object_set_data_full (G_OBJECT (settings), "gtk-color-scheme",
1746                               data, (GDestroyNotify) color_scheme_data_free);
1747     }
1748
1749   if (update_color_hash (data, colors, source))
1750     g_object_notify (G_OBJECT (settings), "color-hash");
1751 }
1752
1753 static GHashTable *
1754 get_color_hash (GtkSettings *settings)
1755 {
1756   ColorSchemeData *data;
1757
1758   if (!g_object_get_data (G_OBJECT (settings), "gtk-color-scheme"))
1759     settings_update_color_scheme (settings);
1760
1761   data = (ColorSchemeData *)g_object_get_data (G_OBJECT (settings),
1762                                                "gtk-color-scheme");
1763
1764   if (!data)
1765     return NULL;
1766
1767   return data->color_hash;
1768 }
1769
1770 static void
1771 append_color_scheme (gpointer key,
1772                      gpointer value,
1773                      gpointer data)
1774 {
1775   gchar *name = (gchar *)key;
1776   GdkColor *color = (GdkColor *)value;
1777   GString *string = (GString *)data;
1778
1779   g_string_append_printf (string, "%s: #%04x%04x%04x\n",
1780                           name, color->red, color->green, color->blue);
1781 }
1782
1783 static gchar *
1784 get_color_scheme (GtkSettings *settings)
1785 {
1786   ColorSchemeData *data;
1787   GString *string;
1788
1789   data = (ColorSchemeData *) g_object_get_data (G_OBJECT (settings),
1790                                                 "gtk-color-scheme");
1791
1792   string = g_string_new ("");
1793
1794   g_hash_table_foreach (data->color_hash, append_color_scheme, string);
1795
1796   return g_string_free (string, FALSE);
1797 }
1798
1799
1800 #define __GTK_SETTINGS_C__
1801 #include "gtkaliasdef.c"