/* GTK - The GIMP Toolkit * Copyright (C) 2000 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ #define PANGO_ENABLE_BACKEND /* for pango_fc_font_map_cache_clear() */ #include "config.h" #include #include "gtkmodules.h" #include "gtksettings.h" #include "gtkrc.h" #include "gtkintl.h" #include "gtkwidget.h" #include "gtktypeutils.h" #include "gtkprivate.h" #ifdef GDK_WINDOWING_X11 #include "x11/gdkx.h" #include #endif #ifdef GDK_WINDOWING_QUARTZ #define DEFAULT_KEY_THEME "Mac" #else #define DEFAULT_KEY_THEME NULL #endif #define DEFAULT_TIMEOUT_INITIAL 200 #define DEFAULT_TIMEOUT_REPEAT 20 #define DEFAULT_TIMEOUT_EXPAND 500 typedef struct _GtkSettingsValuePrivate GtkSettingsValuePrivate; typedef enum { GTK_SETTINGS_SOURCE_DEFAULT, GTK_SETTINGS_SOURCE_RC_FILE, GTK_SETTINGS_SOURCE_XSETTING, GTK_SETTINGS_SOURCE_APPLICATION } GtkSettingsSource; struct _GtkSettingsValuePrivate { GtkSettingsValue public; GtkSettingsSource source; }; struct _GtkSettingsPropertyValue { GValue value; GtkSettingsSource source; }; enum { PROP_0, PROP_DOUBLE_CLICK_TIME, PROP_DOUBLE_CLICK_DISTANCE, PROP_CURSOR_BLINK, PROP_CURSOR_BLINK_TIME, PROP_CURSOR_BLINK_TIMEOUT, PROP_SPLIT_CURSOR, PROP_THEME_NAME, PROP_ICON_THEME_NAME, PROP_FALLBACK_ICON_THEME, PROP_KEY_THEME_NAME, PROP_MENU_BAR_ACCEL, PROP_DND_DRAG_THRESHOLD, PROP_FONT_NAME, PROP_ICON_SIZES, PROP_MODULES, #ifdef GDK_WINDOWING_X11 PROP_XFT_ANTIALIAS, PROP_XFT_HINTING, PROP_XFT_HINTSTYLE, PROP_XFT_RGBA, PROP_XFT_DPI, PROP_CURSOR_THEME_NAME, PROP_CURSOR_THEME_SIZE, #endif PROP_ALTERNATIVE_BUTTON_ORDER, PROP_ALTERNATIVE_SORT_ARROWS, PROP_SHOW_INPUT_METHOD_MENU, PROP_SHOW_UNICODE_MENU, PROP_TIMEOUT_INITIAL, PROP_TIMEOUT_REPEAT, PROP_TIMEOUT_EXPAND, PROP_COLOR_SCHEME, PROP_ENABLE_ANIMATIONS, PROP_TOUCHSCREEN_MODE, PROP_TOOLTIP_TIMEOUT, PROP_TOOLTIP_BROWSE_TIMEOUT, PROP_TOOLTIP_BROWSE_MODE_TIMEOUT, PROP_KEYNAV_CURSOR_ONLY, PROP_KEYNAV_WRAP_AROUND, PROP_ERROR_BELL, PROP_COLOR_HASH, PROP_FILE_CHOOSER_BACKEND, PROP_PRINT_BACKENDS, PROP_PRINT_PREVIEW_COMMAND, PROP_ENABLE_MNEMONICS, PROP_ENABLE_ACCELS, PROP_RECENT_FILES_LIMIT, PROP_IM_MODULE, PROP_RECENT_FILES_MAX_AGE, PROP_FONTCONFIG_TIMESTAMP, PROP_SOUND_THEME_NAME, PROP_ENABLE_INPUT_FEEDBACK_SOUNDS, PROP_ENABLE_EVENT_SOUNDS, PROP_ENABLE_TOOLTIPS, PROP_TOOLBAR_STYLE, PROP_TOOLBAR_ICON_SIZE, PROP_AUTO_MNEMONICS, PROP_APPLICATION_PREFER_DARK_THEME }; /* --- prototypes --- */ static void gtk_settings_finalize (GObject *object); static void gtk_settings_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec); static void gtk_settings_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec); static void gtk_settings_notify (GObject *object, GParamSpec *pspec); static guint settings_install_property_parser (GtkSettingsClass *class, GParamSpec *pspec, GtkRcPropertyParser parser); static void settings_update_double_click (GtkSettings *settings); static void settings_update_modules (GtkSettings *settings); #ifdef GDK_WINDOWING_X11 static void settings_update_cursor_theme (GtkSettings *settings); static void settings_update_resolution (GtkSettings *settings); static void settings_update_font_options (GtkSettings *settings); static gboolean settings_update_fontconfig (GtkSettings *settings); #endif static void settings_update_color_scheme (GtkSettings *settings); static void merge_color_scheme (GtkSettings *settings, const GValue *value, GtkSettingsSource source); static gchar *get_color_scheme (GtkSettings *settings); static GHashTable *get_color_hash (GtkSettings *settings); /* --- variables --- */ static GQuark quark_property_parser = 0; static GSList *object_list = NULL; static guint class_n_properties = 0; G_DEFINE_TYPE (GtkSettings, gtk_settings, G_TYPE_OBJECT) /* --- functions --- */ static void gtk_settings_init (GtkSettings *settings) { GParamSpec **pspecs, **p; guint i = 0; g_datalist_init (&settings->queued_settings); object_list = g_slist_prepend (object_list, settings); /* build up property array for all yet existing properties and queue * notification for them (at least notification for internal properties * will instantly be caught) */ pspecs = g_object_class_list_properties (G_OBJECT_GET_CLASS (settings), NULL); for (p = pspecs; *p; p++) if ((*p)->owner_type == G_OBJECT_TYPE (settings)) i++; settings->property_values = g_new0 (GtkSettingsPropertyValue, i); i = 0; g_object_freeze_notify (G_OBJECT (settings)); for (p = pspecs; *p; p++) { GParamSpec *pspec = *p; if (pspec->owner_type != G_OBJECT_TYPE (settings)) continue; g_value_init (&settings->property_values[i].value, G_PARAM_SPEC_VALUE_TYPE (pspec)); g_param_value_set_default (pspec, &settings->property_values[i].value); g_object_notify (G_OBJECT (settings), pspec->name); settings->property_values[i].source = GTK_SETTINGS_SOURCE_DEFAULT; i++; } g_object_thaw_notify (G_OBJECT (settings)); g_free (pspecs); } static void gtk_settings_class_init (GtkSettingsClass *class) { GObjectClass *gobject_class = G_OBJECT_CLASS (class); guint result; gobject_class->finalize = gtk_settings_finalize; gobject_class->get_property = gtk_settings_get_property; gobject_class->set_property = gtk_settings_set_property; gobject_class->notify = gtk_settings_notify; quark_property_parser = g_quark_from_static_string ("gtk-rc-property-parser"); result = settings_install_property_parser (class, g_param_spec_int ("gtk-double-click-time", P_("Double Click Time"), P_("Maximum time allowed between two clicks for them to be considered a double click (in milliseconds)"), 0, G_MAXINT, 250, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_DOUBLE_CLICK_TIME); result = settings_install_property_parser (class, g_param_spec_int ("gtk-double-click-distance", P_("Double Click Distance"), P_("Maximum distance allowed between two clicks for them to be considered a double click (in pixels)"), 0, G_MAXINT, 5, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_DOUBLE_CLICK_DISTANCE); /** * GtkSettings:gtk-cursor-blink: * * Whether the cursor should blink. * * Also see the #GtkSettings:gtk-cursor-blink-timeout setting, * which allows more flexible control over cursor blinking. */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-cursor-blink", P_("Cursor Blink"), P_("Whether the cursor should blink"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_CURSOR_BLINK); result = settings_install_property_parser (class, g_param_spec_int ("gtk-cursor-blink-time", P_("Cursor Blink Time"), P_("Length of the cursor blink cycle, in milliseconds"), 100, G_MAXINT, 1200, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_CURSOR_BLINK_TIME); /** * GtkSettings:gtk-cursor-blink-timeout: * * Time after which the cursor stops blinking, in seconds. * The timer is reset after each user interaction. * * Setting this to zero has the same effect as setting * #GtkSettings:gtk-cursor-blink to %FALSE. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_int ("gtk-cursor-blink-timeout", P_("Cursor Blink Timeout"), P_("Time after which the cursor stops blinking, in seconds"), 1, G_MAXINT, G_MAXINT, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_CURSOR_BLINK_TIMEOUT); result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-split-cursor", P_("Split Cursor"), P_("Whether two cursors should be displayed for mixed left-to-right and right-to-left text"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_SPLIT_CURSOR); result = settings_install_property_parser (class, g_param_spec_string ("gtk-theme-name", P_("Theme Name"), P_("Name of theme RC file to load"), "Raleigh", GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_THEME_NAME); result = settings_install_property_parser (class, g_param_spec_string ("gtk-icon-theme-name", P_("Icon Theme Name"), P_("Name of icon theme to use"), "hicolor", GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ICON_THEME_NAME); result = settings_install_property_parser (class, g_param_spec_string ("gtk-fallback-icon-theme", P_("Fallback Icon Theme Name"), P_("Name of a icon theme to fall back to"), NULL, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_FALLBACK_ICON_THEME); result = settings_install_property_parser (class, g_param_spec_string ("gtk-key-theme-name", P_("Key Theme Name"), P_("Name of key theme RC file to load"), DEFAULT_KEY_THEME, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_KEY_THEME_NAME); result = settings_install_property_parser (class, g_param_spec_string ("gtk-menu-bar-accel", P_("Menu bar accelerator"), P_("Keybinding to activate the menu bar"), "F10", GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_MENU_BAR_ACCEL); result = settings_install_property_parser (class, g_param_spec_int ("gtk-dnd-drag-threshold", P_("Drag threshold"), P_("Number of pixels the cursor can move before dragging"), 1, G_MAXINT, 8, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_DND_DRAG_THRESHOLD); result = settings_install_property_parser (class, g_param_spec_string ("gtk-font-name", P_("Font Name"), P_("Name of default font to use"), "Sans 10", GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_FONT_NAME); /** * GtkSettings:gtk-icon-sizes: * * A list of icon sizes. The list is separated by colons, and * item has the form: * * size-name = width , height * * E.g. "gtk-menu=16,16:gtk-button=20,20:gtk-dialog=48,48". * GTK+ itself use the following named icon sizes: gtk-menu, * gtk-button, gtk-small-toolbar, gtk-large-toolbar, gtk-dnd, * gtk-dialog. Applications can register their own named icon * sizes with gtk_icon_size_register(). */ result = settings_install_property_parser (class, g_param_spec_string ("gtk-icon-sizes", P_("Icon Sizes"), P_("List of icon sizes (gtk-menu=16,16:gtk-button=20,20..."), NULL, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ICON_SIZES); result = settings_install_property_parser (class, g_param_spec_string ("gtk-modules", P_("GTK Modules"), P_("List of currently active GTK modules"), NULL, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_MODULES); #ifdef GDK_WINDOWING_X11 result = settings_install_property_parser (class, g_param_spec_int ("gtk-xft-antialias", P_("Xft Antialias"), P_("Whether to antialias Xft fonts; 0=no, 1=yes, -1=default"), -1, 1, -1, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_XFT_ANTIALIAS); result = settings_install_property_parser (class, g_param_spec_int ("gtk-xft-hinting", P_("Xft Hinting"), P_("Whether to hint Xft fonts; 0=no, 1=yes, -1=default"), -1, 1, -1, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_XFT_HINTING); result = settings_install_property_parser (class, g_param_spec_string ("gtk-xft-hintstyle", P_("Xft Hint Style"), P_("What degree of hinting to use; hintnone, hintslight, hintmedium, or hintfull"), NULL, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_XFT_HINTSTYLE); result = settings_install_property_parser (class, g_param_spec_string ("gtk-xft-rgba", P_("Xft RGBA"), P_("Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr"), NULL, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_XFT_RGBA); result = settings_install_property_parser (class, g_param_spec_int ("gtk-xft-dpi", P_("Xft DPI"), P_("Resolution for Xft, in 1024 * dots/inch. -1 to use default value"), -1, 1024*1024, -1, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_XFT_DPI); result = settings_install_property_parser (class, g_param_spec_string ("gtk-cursor-theme-name", P_("Cursor theme name"), P_("Name of the cursor theme to use, or NULL to use the default theme"), NULL, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_CURSOR_THEME_NAME); result = settings_install_property_parser (class, g_param_spec_int ("gtk-cursor-theme-size", P_("Cursor theme size"), P_("Size to use for cursors, or 0 to use the default size"), 0, 128, 0, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_CURSOR_THEME_SIZE); #endif /* GDK_WINDOWING_X11 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-alternative-button-order", P_("Alternative button order"), P_("Whether buttons in dialogs should use the alternative button order"), FALSE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ALTERNATIVE_BUTTON_ORDER); /** * GtkSettings:gtk-alternative-sort-arrows: * * Controls the direction of the sort indicators in sorted list and tree * views. By default an arrow pointing down means the column is sorted * in ascending order. When set to %TRUE, this order will be inverted. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-alternative-sort-arrows", P_("Alternative sort indicator direction"), P_("Whether the direction of the sort indicators in list and tree views is inverted compared to the default (where down means ascending)"), FALSE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ALTERNATIVE_SORT_ARROWS); result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-show-input-method-menu", P_("Show the 'Input Methods' menu"), P_("Whether the context menus of entries and text views should offer to change the input method"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_SHOW_INPUT_METHOD_MENU); result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-show-unicode-menu", P_("Show the 'Insert Unicode Control Character' menu"), P_("Whether the context menus of entries and text views should offer to insert control characters"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_SHOW_UNICODE_MENU); result = settings_install_property_parser (class, g_param_spec_int ("gtk-timeout-initial", P_("Start timeout"), P_("Starting value for timeouts, when button is pressed"), 0, G_MAXINT, DEFAULT_TIMEOUT_INITIAL, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_TIMEOUT_INITIAL); result = settings_install_property_parser (class, g_param_spec_int ("gtk-timeout-repeat", P_("Repeat timeout"), P_("Repeat value for timeouts, when button is pressed"), 0, G_MAXINT, DEFAULT_TIMEOUT_REPEAT, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_TIMEOUT_REPEAT); result = settings_install_property_parser (class, g_param_spec_int ("gtk-timeout-expand", P_("Expand timeout"), P_("Expand value for timeouts, when a widget is expanding a new region"), 0, G_MAXINT, DEFAULT_TIMEOUT_EXPAND, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_TIMEOUT_EXPAND); /** * GtkSettings:gtk-color-scheme: * * A palette of named colors for use in themes. The format of the string is * * name1: color1 * name2: color2 * ... * * Color names must be acceptable as identifiers in the * gtkrc syntax, and * color specifications must be in the format accepted by * gdk_color_parse(). * * Note that due to the way the color tables from different sources are * merged, color specifications will be converted to hexadecimal form * when getting this property. * * Starting with GTK+ 2.12, the entries can alternatively be separated * by ';' instead of newlines: * * name1: color1; name2: color2; ... * * * Since: 2.10 */ result = settings_install_property_parser (class, g_param_spec_string ("gtk-color-scheme", P_("Color scheme"), P_("A palette of named colors for use in themes"), "", GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_COLOR_SCHEME); result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-enable-animations", P_("Enable Animations"), P_("Whether to enable toolkit-wide animations."), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ENABLE_ANIMATIONS); /** * GtkSettings:gtk-touchscreen-mode: * * When %TRUE, there are no motion notify events delivered on this screen, * and widgets can't use the pointer hovering them for any essential * functionality. * * Since: 2.10 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-touchscreen-mode", P_("Enable Touchscreen Mode"), P_("When TRUE, there are no motion notify events delivered on this screen"), FALSE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_TOUCHSCREEN_MODE); /** * GtkSettings:gtk-tooltip-timeout: * * Time, in milliseconds, after which a tooltip could appear if the * cursor is hovering on top of a widget. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_int ("gtk-tooltip-timeout", P_("Tooltip timeout"), P_("Timeout before tooltip is shown"), 0, G_MAXINT, 500, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_TOOLTIP_TIMEOUT); /** * GtkSettings:gtk-tooltip-browse-timeout: * * Controls the time after which tooltips will appear when * browse mode is enabled, in milliseconds. * * Browse mode is enabled when the mouse pointer moves off an object * where a tooltip was currently being displayed. If the mouse pointer * hits another object before the browse mode timeout expires (see * #GtkSettings:gtk-tooltip-browse-mode-timeout), it will take the * amount of milliseconds specified by this setting to popup the tooltip * for the new object. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_int ("gtk-tooltip-browse-timeout", P_("Tooltip browse timeout"), P_("Timeout before tooltip is shown when browse mode is enabled"), 0, G_MAXINT, 60, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_TOOLTIP_BROWSE_TIMEOUT); /** * GtkSettings:gtk-tooltip-browse-mode-timeout: * * Amount of time, in milliseconds, after which the browse mode * will be disabled. * * See #GtkSettings:gtk-tooltip-browse-timeout for more information * about browse mode. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_int ("gtk-tooltip-browse-mode-timeout", P_("Tooltip browse mode timeout"), P_("Timeout after which browse mode is disabled"), 0, G_MAXINT, 500, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_TOOLTIP_BROWSE_MODE_TIMEOUT); /** * GtkSettings:gtk-keynav-cursor-only: * * When %TRUE, keyboard navigation should be able to reach all widgets * by using the cursor keys only. Tab, Shift etc. keys can't be expected * to be present on the used input device. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-keynav-cursor-only", P_("Keynav Cursor Only"), P_("When TRUE, there are only cursor keys available to navigate widgets"), FALSE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_KEYNAV_CURSOR_ONLY); /** * GtkSettings:gtk-keynav-wrap-around: * * When %TRUE, some widgets will wrap around when doing keyboard * navigation, such as menus, menubars and notebooks. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-keynav-wrap-around", P_("Keynav Wrap Around"), P_("Whether to wrap around when keyboard-navigating widgets"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_KEYNAV_WRAP_AROUND); /** * GtkSettings:gtk-error-bell: * * When %TRUE, keyboard navigation and other input-related errors * will cause a beep. Since the error bell is implemented using * gdk_window_beep(), the windowing system may offer ways to * configure the error bell in many ways, such as flashing the * window or similar visual effects. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-error-bell", P_("Error Bell"), P_("When TRUE, keyboard navigation and other errors will cause a beep"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ERROR_BELL); /** * GtkSettings:color-hash: * * Holds a hash table representation of the #GtkSettings:gtk-color-scheme * setting, mapping color names to #GdkColors. * * Since: 2.10 */ result = settings_install_property_parser (class, g_param_spec_boxed ("color-hash", P_("Color Hash"), P_("A hash table representation of the color scheme."), G_TYPE_HASH_TABLE, GTK_PARAM_READABLE), NULL); g_assert (result == PROP_COLOR_HASH); result = settings_install_property_parser (class, g_param_spec_string ("gtk-file-chooser-backend", P_("Default file chooser backend"), P_("Name of the GtkFileChooser backend to use by default"), NULL, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_FILE_CHOOSER_BACKEND); /** * GtkSettings:gtk-print-backends: * * A comma-separated list of print backends to use in the print * dialog. Available print backends depend on the GTK+ installation, * and may include "file", "cups", "lpr" or "papi". * * Since: 2.10 */ result = settings_install_property_parser (class, g_param_spec_string ("gtk-print-backends", P_("Default print backend"), P_("List of the GtkPrintBackend backends to use by default"), GTK_PRINT_BACKENDS, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_PRINT_BACKENDS); /** * GtkSettings:gtk-print-preview-command: * * A command to run for displaying the print preview. The command * should contain a %f placeholder, which will get replaced by * the path to the pdf file. The command may also contain a %s * placeholder, which will get replaced by the path to a file * containing the print settings in the format produced by * gtk_print_settings_to_file(). * * The preview application is responsible for removing the pdf file * and the print settings file when it is done. * * Since: 2.10 */ result = settings_install_property_parser (class, g_param_spec_string ("gtk-print-preview-command", P_("Default command to run when displaying a print preview"), P_("Command to run when displaying a print preview"), GTK_PRINT_PREVIEW_COMMAND, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_PRINT_PREVIEW_COMMAND); /** * GtkSettings:gtk-enable-mnemonics: * * Whether labels and menu items should have visible mnemonics which * can be activated. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-enable-mnemonics", P_("Enable Mnemonics"), P_("Whether labels should have mnemonics"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ENABLE_MNEMONICS); /** * GtkSettings:gtk-enable-accels: * * Whether menu items should have visible accelerators which can be * activated. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-enable-accels", P_("Enable Accelerators"), P_("Whether menu items should have accelerators"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ENABLE_ACCELS); /** * GtkSettings:gtk-recent-files-limit: * * The number of recently used files that should be displayed by default by * #GtkRecentChooser implementations and by the #GtkFileChooser. A value of * -1 means every recently used file stored. * * Since: 2.12 */ result = settings_install_property_parser (class, g_param_spec_int ("gtk-recent-files-limit", P_("Recent Files Limit"), P_("Number of recently used files"), -1, G_MAXINT, 50, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_RECENT_FILES_LIMIT); /** * GtkSettings:gtk-im-module: * * Which IM (input method) module should be used by default. This is the * input method that will be used if the user has not explicitly chosen * another input method from the IM context menu. * * See #GtkIMContext and see the #GtkSettings:gtk-show-input-method-menu property. */ result = settings_install_property_parser (class, g_param_spec_string ("gtk-im-module", P_("Default IM module"), P_("Which IM module should be used by default"), NULL, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_IM_MODULE); /** * GtkSettings:gtk-recent-files-max-age: * * The maximum age, in days, of the items inside the recently used * resources list. Items older than this setting will be excised * from the list. If set to 0, the list will always be empty; if * set to -1, no item will be removed. * * Since: 2.14 */ result = settings_install_property_parser (class, g_param_spec_int ("gtk-recent-files-max-age", P_("Recent Files Max Age"), P_("Maximum age of recently used files, in days"), -1, G_MAXINT, 30, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_RECENT_FILES_MAX_AGE); result = settings_install_property_parser (class, g_param_spec_uint ("gtk-fontconfig-timestamp", P_("Fontconfig configuration timestamp"), P_("Timestamp of current fontconfig configuration"), 0, G_MAXUINT, 0, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_FONTCONFIG_TIMESTAMP); /** * GtkSettings:gtk-sound-theme-name: * * The XDG sound theme to use for event sounds. * * See the Sound Theme spec * for more information on event sounds and sound themes. * * GTK+ itself does not support event sounds, you have to use a loadable * module like the one that comes with libcanberra. * * Since: 2.14 */ result = settings_install_property_parser (class, g_param_spec_string ("gtk-sound-theme-name", P_("Sound Theme Name"), P_("XDG sound theme name"), "freedesktop", GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_SOUND_THEME_NAME); /** * GtkSettings:gtk-enable-input-feedback-sounds: * * Whether to play event sounds as feedback to user input. * * See the Sound Theme spec * for more information on event sounds and sound themes. * * GTK+ itself does not support event sounds, you have to use a loadable * module like the one that comes with libcanberra. * * Since: 2.14 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-enable-input-feedback-sounds", /* Translators: this means sounds that are played as feedback to user input */ P_("Audible Input Feedback"), P_("Whether to play event sounds as feedback to user input"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ENABLE_INPUT_FEEDBACK_SOUNDS); /** * GtkSettings:gtk-enable-event-sounds: * * Whether to play any event sounds at all. * * See the Sound Theme spec * for more information on event sounds and sound themes. * * GTK+ itself does not support event sounds, you have to use a loadable * module like the one that comes with libcanberra. * * Since: 2.14 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-enable-event-sounds", P_("Enable Event Sounds"), P_("Whether to play any event sounds at all"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ENABLE_EVENT_SOUNDS); /** * GtkSettings:gtk-enable-tooltips: * * Whether tooltips should be shown on widgets. * * Since: 2.14 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-enable-tooltips", P_("Enable Tooltips"), P_("Whether tooltips should be shown on widgets"), TRUE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_ENABLE_TOOLTIPS); /** * GtkSettings:toolbar-style: * * The size of icons in default toolbars. */ result = settings_install_property_parser (class, g_param_spec_enum ("gtk-toolbar-style", P_("Toolbar style"), P_("Whether default toolbars have text only, text and icons, icons only, etc."), GTK_TYPE_TOOLBAR_STYLE, GTK_TOOLBAR_BOTH, GTK_PARAM_READWRITE), gtk_rc_property_parse_enum); g_assert (result == PROP_TOOLBAR_STYLE); /** * GtkSettings:toolbar-icon-size: * * The size of icons in default toolbars. */ result = settings_install_property_parser (class, g_param_spec_enum ("gtk-toolbar-icon-size", P_("Toolbar Icon Size"), P_("The size of icons in default toolbars."), GTK_TYPE_ICON_SIZE, GTK_ICON_SIZE_LARGE_TOOLBAR, GTK_PARAM_READWRITE), gtk_rc_property_parse_enum); g_assert (result == PROP_TOOLBAR_ICON_SIZE); /** * GtkSettings:gtk-auto-mnemonics: * * Whether mnemonics should be automatically shown and hidden when the user * presses the mnemonic activator. * * Since: 2.20 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-auto-mnemonics", P_("Auto Mnemonics"), P_("Whether mnemonics should be automatically shown and hidden when the user presses the mnemonic activator."), FALSE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_AUTO_MNEMONICS); /** * GtkSettings:gtk-application-prefer-dark-theme: * * Whether the application prefers to use a dark theme. If a GTK+ theme * includes a dark variant, it will be used instead of the configured * theme. * * Some applications benefit from minimizing the amount of light pollution that * interferes with the content. Good candidates for dark themes are photo and * video editors that make the actual content get all the attention and minimize * the distraction of the chrome. * * Dark themes should not be used for documents, where large spaces are white/light * and the dark chrome creates too much contrast (web browser, text editor...). * * Since: 2.22 */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-application-prefer-dark-theme", P_("Application prefers a dark theme"), P_("Whether the application prefers to have a dark theme."), FALSE, GTK_PARAM_READWRITE), NULL); g_assert (result == PROP_APPLICATION_PREFER_DARK_THEME); } static void gtk_settings_finalize (GObject *object) { GtkSettings *settings = GTK_SETTINGS (object); guint i; object_list = g_slist_remove (object_list, settings); _gtk_rc_context_destroy (settings); for (i = 0; i < class_n_properties; i++) g_value_unset (&settings->property_values[i].value); g_free (settings->property_values); g_datalist_clear (&settings->queued_settings); G_OBJECT_CLASS (gtk_settings_parent_class)->finalize (object); } /** * gtk_settings_get_for_screen: * @screen: a #GdkScreen. * * Gets the #GtkSettings object for @screen, creating it if necessary. * * Return value: (transfer none): a #GtkSettings object. * * Since: 2.2 */ GtkSettings* gtk_settings_get_for_screen (GdkScreen *screen) { GtkSettings *settings; g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL); settings = g_object_get_data (G_OBJECT (screen), "gtk-settings"); if (!settings) { settings = g_object_new (GTK_TYPE_SETTINGS, NULL); settings->screen = screen; g_object_set_data_full (G_OBJECT (screen), I_("gtk-settings"), settings, g_object_unref); gtk_rc_reparse_all_for_settings (settings, TRUE); settings_update_double_click (settings); #ifdef GDK_WINDOWING_X11 settings_update_cursor_theme (settings); settings_update_resolution (settings); settings_update_font_options (settings); #endif settings_update_color_scheme (settings); } return settings; } /** * gtk_settings_get_default: * * Gets the #GtkSettings object for the default GDK screen, creating * it if necessary. See gtk_settings_get_for_screen(). * * Return value: (transfer none): a #GtkSettings object. If there is no default * screen, then returns %NULL. **/ GtkSettings* gtk_settings_get_default (void) { GdkScreen *screen = gdk_screen_get_default (); if (screen) return gtk_settings_get_for_screen (screen); else return NULL; } static void gtk_settings_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec) { GtkSettings *settings = GTK_SETTINGS (object); g_value_copy (value, &settings->property_values[property_id - 1].value); settings->property_values[property_id - 1].source = GTK_SETTINGS_SOURCE_APPLICATION; if (pspec->param_id == PROP_COLOR_SCHEME) merge_color_scheme (settings, value, GTK_SETTINGS_SOURCE_APPLICATION); } static void gtk_settings_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec) { GtkSettings *settings = GTK_SETTINGS (object); GType value_type = G_VALUE_TYPE (value); GType fundamental_type = G_TYPE_FUNDAMENTAL (value_type); /* handle internal properties */ switch (property_id) { case PROP_COLOR_HASH: g_value_set_boxed (value, get_color_hash (settings)); return; case PROP_COLOR_SCHEME: g_value_take_string (value, get_color_scheme (settings)); return; default: ; } /* For enums and strings, we need to get the value as a string, * not as an int, since we support using names/nicks as the setting * value. */ if ((g_value_type_transformable (G_TYPE_INT, value_type) && !(fundamental_type == G_TYPE_ENUM || fundamental_type == G_TYPE_FLAGS)) || g_value_type_transformable (G_TYPE_STRING, G_VALUE_TYPE (value)) || g_value_type_transformable (GDK_TYPE_COLOR, G_VALUE_TYPE (value))) { if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION || !gdk_screen_get_setting (settings->screen, pspec->name, value)) g_value_copy (&settings->property_values[property_id - 1].value, value); else g_param_value_validate (pspec, value); } else { GValue val = { 0, }; /* Try to get xsetting as a string and parse it. */ g_value_init (&val, G_TYPE_STRING); if (settings->property_values[property_id - 1].source == GTK_SETTINGS_SOURCE_APPLICATION || !gdk_screen_get_setting (settings->screen, pspec->name, &val)) { g_value_copy (&settings->property_values[property_id - 1].value, value); } else { GValue tmp_value = { 0, }; GValue gstring_value = { 0, }; GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser); g_value_init (&gstring_value, G_TYPE_GSTRING); g_value_take_boxed (&gstring_value, g_string_new (g_value_get_string (&val))); g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec)); if (parser && _gtk_settings_parse_convert (parser, &gstring_value, pspec, &tmp_value)) { g_value_copy (&tmp_value, value); g_param_value_validate (pspec, value); } else { g_value_copy (&settings->property_values[property_id - 1].value, value); } g_value_unset (&gstring_value); g_value_unset (&tmp_value); } g_value_unset (&val); } } static void gtk_settings_notify (GObject *object, GParamSpec *pspec) { GtkSettings *settings = GTK_SETTINGS (object); guint property_id = pspec->param_id; if (settings->screen == NULL) /* initialization */ return; switch (property_id) { case PROP_MODULES: settings_update_modules (settings); break; case PROP_DOUBLE_CLICK_TIME: case PROP_DOUBLE_CLICK_DISTANCE: settings_update_double_click (settings); break; case PROP_COLOR_SCHEME: settings_update_color_scheme (settings); break; #ifdef GDK_WINDOWING_X11 case PROP_XFT_DPI: settings_update_resolution (settings); /* This is a hack because with gtk_rc_reset_styles() doesn't get * widgets with gtk_widget_style_set(), and also causes more * recomputation than necessary. */ gtk_rc_reset_styles (GTK_SETTINGS (object)); break; case PROP_XFT_ANTIALIAS: case PROP_XFT_HINTING: case PROP_XFT_HINTSTYLE: case PROP_XFT_RGBA: settings_update_font_options (settings); gtk_rc_reset_styles (GTK_SETTINGS (object)); break; case PROP_FONTCONFIG_TIMESTAMP: if (settings_update_fontconfig (settings)) gtk_rc_reset_styles (GTK_SETTINGS (object)); break; case PROP_CURSOR_THEME_NAME: case PROP_CURSOR_THEME_SIZE: settings_update_cursor_theme (settings); break; #endif /* GDK_WINDOWING_X11 */ } } gboolean _gtk_settings_parse_convert (GtkRcPropertyParser parser, const GValue *src_value, GParamSpec *pspec, GValue *dest_value) { gboolean success = FALSE; g_return_val_if_fail (G_VALUE_HOLDS (dest_value, G_PARAM_SPEC_VALUE_TYPE (pspec)), FALSE); if (parser) { GString *gstring; gboolean free_gstring = TRUE; if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING)) { gstring = g_value_get_boxed (src_value); free_gstring = FALSE; } else if (G_VALUE_HOLDS_LONG (src_value)) { gstring = g_string_new (NULL); g_string_append_printf (gstring, "%ld", g_value_get_long (src_value)); } else if (G_VALUE_HOLDS_DOUBLE (src_value)) { gstring = g_string_new (NULL); g_string_append_printf (gstring, "%f", g_value_get_double (src_value)); } else if (G_VALUE_HOLDS_STRING (src_value)) { gchar *tstr = g_strescape (g_value_get_string (src_value), NULL); gstring = g_string_new ("\""); g_string_append (gstring, tstr); g_string_append_c (gstring, '\"'); g_free (tstr); } else { g_return_val_if_fail (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING), FALSE); gstring = NULL; /* silence compiler */ } success = (parser (pspec, gstring, dest_value) && !g_param_value_validate (pspec, dest_value)); if (free_gstring) g_string_free (gstring, TRUE); } else if (G_VALUE_HOLDS (src_value, G_TYPE_GSTRING)) { if (G_VALUE_HOLDS (dest_value, G_TYPE_STRING)) { GString *gstring = g_value_get_boxed (src_value); g_value_set_string (dest_value, gstring ? gstring->str : NULL); success = !g_param_value_validate (pspec, dest_value); } } else if (g_value_type_transformable (G_VALUE_TYPE (src_value), G_VALUE_TYPE (dest_value))) success = g_param_value_convert (pspec, src_value, dest_value, TRUE); return success; } static void apply_queued_setting (GtkSettings *data, GParamSpec *pspec, GtkSettingsValuePrivate *qvalue) { GValue tmp_value = { 0, }; GtkRcPropertyParser parser = (GtkRcPropertyParser) g_param_spec_get_qdata (pspec, quark_property_parser); g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec)); if (_gtk_settings_parse_convert (parser, &qvalue->public.value, pspec, &tmp_value)) { if (pspec->param_id == PROP_COLOR_SCHEME) merge_color_scheme (data, &tmp_value, qvalue->source); if (data->property_values[pspec->param_id - 1].source <= qvalue->source) { g_value_copy (&tmp_value, &data->property_values[pspec->param_id - 1].value); data->property_values[pspec->param_id - 1].source = qvalue->source; g_object_notify (G_OBJECT (data), g_param_spec_get_name (pspec)); } } else { gchar *debug = g_strdup_value_contents (&qvalue->public.value); g_message ("%s: failed to retrieve property `%s' of type `%s' from rc file value \"%s\" of type `%s'", qvalue->public.origin ? qvalue->public.origin : "(for origin information, set GTK_DEBUG)", pspec->name, g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)), debug, G_VALUE_TYPE_NAME (&tmp_value)); g_free (debug); } g_value_unset (&tmp_value); } static guint settings_install_property_parser (GtkSettingsClass *class, GParamSpec *pspec, GtkRcPropertyParser parser) { GSList *node, *next; switch (G_TYPE_FUNDAMENTAL (G_PARAM_SPEC_VALUE_TYPE (pspec))) { case G_TYPE_BOOLEAN: case G_TYPE_UCHAR: case G_TYPE_CHAR: case G_TYPE_UINT: case G_TYPE_INT: case G_TYPE_ULONG: case G_TYPE_LONG: case G_TYPE_FLOAT: case G_TYPE_DOUBLE: case G_TYPE_STRING: case G_TYPE_ENUM: break; case G_TYPE_BOXED: if (strcmp (g_param_spec_get_name (pspec), "color-hash") == 0) { break; } /* fall through */ default: if (!parser) { g_warning (G_STRLOC ": parser needs to be specified for property \"%s\" of type `%s'", pspec->name, g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec))); return 0; } } if (g_object_class_find_property (G_OBJECT_CLASS (class), pspec->name)) { g_warning (G_STRLOC ": an rc-data property \"%s\" already exists", pspec->name); return 0; } for (node = object_list; node; node = node->next) g_object_freeze_notify (node->data); g_object_class_install_property (G_OBJECT_CLASS (class), ++class_n_properties, pspec); g_param_spec_set_qdata (pspec, quark_property_parser, (gpointer) parser); for (node = object_list; node; node = node->next) { GtkSettings *settings = node->data; GtkSettingsValuePrivate *qvalue; settings->property_values = g_renew (GtkSettingsPropertyValue, settings->property_values, class_n_properties); settings->property_values[class_n_properties - 1].value.g_type = 0; g_value_init (&settings->property_values[class_n_properties - 1].value, G_PARAM_SPEC_VALUE_TYPE (pspec)); g_param_value_set_default (pspec, &settings->property_values[class_n_properties - 1].value); settings->property_values[class_n_properties - 1].source = GTK_SETTINGS_SOURCE_DEFAULT; g_object_notify (G_OBJECT (settings), pspec->name); qvalue = g_datalist_get_data (&settings->queued_settings, pspec->name); if (qvalue) apply_queued_setting (settings, pspec, qvalue); } for (node = object_list; node; node = next) { next = node->next; g_object_thaw_notify (node->data); } return class_n_properties; } GtkRcPropertyParser _gtk_rc_property_parser_from_type (GType type) { if (type == GDK_TYPE_COLOR) return gtk_rc_property_parse_color; else if (type == GTK_TYPE_REQUISITION) return gtk_rc_property_parse_requisition; else if (type == GTK_TYPE_BORDER) return gtk_rc_property_parse_border; else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_ENUM && G_TYPE_IS_DERIVED (type)) return gtk_rc_property_parse_enum; else if (G_TYPE_FUNDAMENTAL (type) == G_TYPE_FLAGS && G_TYPE_IS_DERIVED (type)) return gtk_rc_property_parse_flags; else return NULL; } void gtk_settings_install_property (GParamSpec *pspec) { static GtkSettingsClass *klass = NULL; GtkRcPropertyParser parser; g_return_if_fail (G_IS_PARAM_SPEC (pspec)); if (! klass) klass = g_type_class_ref (GTK_TYPE_SETTINGS); parser = _gtk_rc_property_parser_from_type (G_PARAM_SPEC_VALUE_TYPE (pspec)); settings_install_property_parser (klass, pspec, parser); } void gtk_settings_install_property_parser (GParamSpec *pspec, GtkRcPropertyParser parser) { static GtkSettingsClass *klass = NULL; g_return_if_fail (G_IS_PARAM_SPEC (pspec)); g_return_if_fail (parser != NULL); if (! klass) klass = g_type_class_ref (GTK_TYPE_SETTINGS); settings_install_property_parser (klass, pspec, parser); } static void free_value (gpointer data) { GtkSettingsValuePrivate *qvalue = data; g_value_unset (&qvalue->public.value); g_free (qvalue->public.origin); g_slice_free (GtkSettingsValuePrivate, qvalue); } static void gtk_settings_set_property_value_internal (GtkSettings *settings, const gchar *prop_name, const GtkSettingsValue *new_value, GtkSettingsSource source) { GtkSettingsValuePrivate *qvalue; GParamSpec *pspec; gchar *name; GQuark name_quark; if (!G_VALUE_HOLDS_LONG (&new_value->value) && !G_VALUE_HOLDS_DOUBLE (&new_value->value) && !G_VALUE_HOLDS_STRING (&new_value->value) && !G_VALUE_HOLDS (&new_value->value, G_TYPE_GSTRING)) { g_warning (G_STRLOC ": value type invalid"); return; } name = g_strdup (prop_name); g_strcanon (name, G_CSET_DIGITS "-" G_CSET_a_2_z G_CSET_A_2_Z, '-'); name_quark = g_quark_from_string (name); g_free (name); qvalue = g_datalist_id_get_data (&settings->queued_settings, name_quark); if (!qvalue) { qvalue = g_slice_new0 (GtkSettingsValuePrivate); g_datalist_id_set_data_full (&settings->queued_settings, name_quark, qvalue, free_value); } else { g_free (qvalue->public.origin); g_value_unset (&qvalue->public.value); } qvalue->public.origin = g_strdup (new_value->origin); g_value_init (&qvalue->public.value, G_VALUE_TYPE (&new_value->value)); g_value_copy (&new_value->value, &qvalue->public.value); qvalue->source = source; pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (settings), g_quark_to_string (name_quark)); if (pspec) apply_queued_setting (settings, pspec, qvalue); } void gtk_settings_set_property_value (GtkSettings *settings, const gchar *prop_name, const GtkSettingsValue *new_value) { g_return_if_fail (GTK_SETTINGS (settings)); g_return_if_fail (prop_name != NULL); g_return_if_fail (new_value != NULL); gtk_settings_set_property_value_internal (settings, prop_name, new_value, GTK_SETTINGS_SOURCE_APPLICATION); } void _gtk_settings_set_property_value_from_rc (GtkSettings *settings, const gchar *prop_name, const GtkSettingsValue *new_value) { g_return_if_fail (GTK_SETTINGS (settings)); g_return_if_fail (prop_name != NULL); g_return_if_fail (new_value != NULL); gtk_settings_set_property_value_internal (settings, prop_name, new_value, GTK_SETTINGS_SOURCE_RC_FILE); } void gtk_settings_set_string_property (GtkSettings *settings, const gchar *name, const gchar *v_string, const gchar *origin) { GtkSettingsValue svalue = { NULL, { 0, }, }; g_return_if_fail (GTK_SETTINGS (settings)); g_return_if_fail (name != NULL); g_return_if_fail (v_string != NULL); svalue.origin = (gchar*) origin; g_value_init (&svalue.value, G_TYPE_STRING); g_value_set_static_string (&svalue.value, v_string); gtk_settings_set_property_value (settings, name, &svalue); g_value_unset (&svalue.value); } void gtk_settings_set_long_property (GtkSettings *settings, const gchar *name, glong v_long, const gchar *origin) { GtkSettingsValue svalue = { NULL, { 0, }, }; g_return_if_fail (GTK_SETTINGS (settings)); g_return_if_fail (name != NULL); svalue.origin = (gchar*) origin; g_value_init (&svalue.value, G_TYPE_LONG); g_value_set_long (&svalue.value, v_long); gtk_settings_set_property_value (settings, name, &svalue); g_value_unset (&svalue.value); } void gtk_settings_set_double_property (GtkSettings *settings, const gchar *name, gdouble v_double, const gchar *origin) { GtkSettingsValue svalue = { NULL, { 0, }, }; g_return_if_fail (GTK_SETTINGS (settings)); g_return_if_fail (name != NULL); svalue.origin = (gchar*) origin; g_value_init (&svalue.value, G_TYPE_DOUBLE); g_value_set_double (&svalue.value, v_double); gtk_settings_set_property_value (settings, name, &svalue); g_value_unset (&svalue.value); } /** * gtk_rc_property_parse_color: * @pspec: a #GParamSpec * @gstring: the #GString to be parsed * @property_value: a #GValue which must hold #GdkColor values. * * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() * or gtk_widget_class_install_style_property_parser() which parses a * color given either by its name or in the form * { red, green, blue } where %red, %green and * %blue are integers between 0 and 65535 or floating-point numbers * between 0 and 1. * * Return value: %TRUE if @gstring could be parsed and @property_value * has been set to the resulting #GdkColor. **/ gboolean gtk_rc_property_parse_color (const GParamSpec *pspec, const GString *gstring, GValue *property_value) { GdkColor color = { 0, 0, 0, 0, }; GScanner *scanner; gboolean success; g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE); g_return_val_if_fail (G_VALUE_HOLDS (property_value, GDK_TYPE_COLOR), FALSE); scanner = gtk_rc_scanner_new (); g_scanner_input_text (scanner, gstring->str, gstring->len); if (gtk_rc_parse_color (scanner, &color) == G_TOKEN_NONE && g_scanner_get_next_token (scanner) == G_TOKEN_EOF) { g_value_set_boxed (property_value, &color); success = TRUE; } else success = FALSE; g_scanner_destroy (scanner); return success; } /** * gtk_rc_property_parse_enum: * @pspec: a #GParamSpec * @gstring: the #GString to be parsed * @property_value: a #GValue which must hold enum values. * * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() * or gtk_widget_class_install_style_property_parser() which parses a single * enumeration value. * * The enumeration value can be specified by its name, its nickname or * its numeric value. For consistency with flags parsing, the value * may be surrounded by parentheses. * * Return value: %TRUE if @gstring could be parsed and @property_value * has been set to the resulting #GEnumValue. **/ gboolean gtk_rc_property_parse_enum (const GParamSpec *pspec, const GString *gstring, GValue *property_value) { gboolean need_closing_brace = FALSE, success = FALSE; GScanner *scanner; GEnumValue *enum_value = NULL; g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE); g_return_val_if_fail (G_VALUE_HOLDS_ENUM (property_value), FALSE); scanner = gtk_rc_scanner_new (); g_scanner_input_text (scanner, gstring->str, gstring->len); /* we just want to parse _one_ value, but for consistency with flags parsing * we support optional parenthesis */ g_scanner_get_next_token (scanner); if (scanner->token == '(') { need_closing_brace = TRUE; g_scanner_get_next_token (scanner); } if (scanner->token == G_TOKEN_IDENTIFIER) { GEnumClass *class = G_PARAM_SPEC_ENUM (pspec)->enum_class; enum_value = g_enum_get_value_by_name (class, scanner->value.v_identifier); if (!enum_value) enum_value = g_enum_get_value_by_nick (class, scanner->value.v_identifier); if (enum_value) { g_value_set_enum (property_value, enum_value->value); success = TRUE; } } else if (scanner->token == G_TOKEN_INT) { g_value_set_enum (property_value, scanner->value.v_int); success = TRUE; } if (need_closing_brace && g_scanner_get_next_token (scanner) != ')') success = FALSE; if (g_scanner_get_next_token (scanner) != G_TOKEN_EOF) success = FALSE; g_scanner_destroy (scanner); return success; } static guint parse_flags_value (GScanner *scanner, GFlagsClass *class, guint *number) { g_scanner_get_next_token (scanner); if (scanner->token == G_TOKEN_IDENTIFIER) { GFlagsValue *flags_value; flags_value = g_flags_get_value_by_name (class, scanner->value.v_identifier); if (!flags_value) flags_value = g_flags_get_value_by_nick (class, scanner->value.v_identifier); if (flags_value) { *number |= flags_value->value; return G_TOKEN_NONE; } } else if (scanner->token == G_TOKEN_INT) { *number |= scanner->value.v_int; return G_TOKEN_NONE; } return G_TOKEN_IDENTIFIER; } /** * gtk_rc_property_parse_flags: * @pspec: a #GParamSpec * @gstring: the #GString to be parsed * @property_value: a #GValue which must hold flags values. * * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() * or gtk_widget_class_install_style_property_parser() which parses flags. * * Flags can be specified by their name, their nickname or * numerically. Multiple flags can be specified in the form * "( flag1 | flag2 | ... )". * * Return value: %TRUE if @gstring could be parsed and @property_value * has been set to the resulting flags value. **/ gboolean gtk_rc_property_parse_flags (const GParamSpec *pspec, const GString *gstring, GValue *property_value) { GFlagsClass *class; gboolean success = FALSE; GScanner *scanner; g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE); g_return_val_if_fail (G_VALUE_HOLDS_FLAGS (property_value), FALSE); class = G_PARAM_SPEC_FLAGS (pspec)->flags_class; scanner = gtk_rc_scanner_new (); g_scanner_input_text (scanner, gstring->str, gstring->len); /* parse either a single flags value or a "\( ... [ \| ... ] \)" compound */ if (g_scanner_peek_next_token (scanner) == G_TOKEN_IDENTIFIER || scanner->next_token == G_TOKEN_INT) { guint token, flags_value = 0; token = parse_flags_value (scanner, class, &flags_value); if (token == G_TOKEN_NONE && g_scanner_peek_next_token (scanner) == G_TOKEN_EOF) { success = TRUE; g_value_set_flags (property_value, flags_value); } } else if (g_scanner_get_next_token (scanner) == '(') { guint token, flags_value = 0; /* parse first value */ token = parse_flags_value (scanner, class, &flags_value); /* parse nth values, preceeded by '|' */ while (token == G_TOKEN_NONE && g_scanner_get_next_token (scanner) == '|') token = parse_flags_value (scanner, class, &flags_value); /* done, last token must have closed expression */ if (token == G_TOKEN_NONE && scanner->token == ')' && g_scanner_peek_next_token (scanner) == G_TOKEN_EOF) { g_value_set_flags (property_value, flags_value); success = TRUE; } } g_scanner_destroy (scanner); return success; } static gboolean get_braced_int (GScanner *scanner, gboolean first, gboolean last, gint *value) { if (first) { g_scanner_get_next_token (scanner); if (scanner->token != '{') return FALSE; } g_scanner_get_next_token (scanner); if (scanner->token != G_TOKEN_INT) return FALSE; *value = scanner->value.v_int; if (last) { g_scanner_get_next_token (scanner); if (scanner->token != '}') return FALSE; } else { g_scanner_get_next_token (scanner); if (scanner->token != ',') return FALSE; } return TRUE; } /** * gtk_rc_property_parse_requisition: * @pspec: a #GParamSpec * @gstring: the #GString to be parsed * @property_value: a #GValue which must hold boxed values. * * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() * or gtk_widget_class_install_style_property_parser() which parses a * requisition in the form * "{ width, height }" for integers %width and %height. * * Return value: %TRUE if @gstring could be parsed and @property_value * has been set to the resulting #GtkRequisition. **/ gboolean gtk_rc_property_parse_requisition (const GParamSpec *pspec, const GString *gstring, GValue *property_value) { GtkRequisition requisition; GScanner *scanner; gboolean success = FALSE; g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE); g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE); scanner = gtk_rc_scanner_new (); g_scanner_input_text (scanner, gstring->str, gstring->len); if (get_braced_int (scanner, TRUE, FALSE, &requisition.width) && get_braced_int (scanner, FALSE, TRUE, &requisition.height)) { g_value_set_boxed (property_value, &requisition); success = TRUE; } g_scanner_destroy (scanner); return success; } /** * gtk_rc_property_parse_border: * @pspec: a #GParamSpec * @gstring: the #GString to be parsed * @property_value: a #GValue which must hold boxed values. * * A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() * or gtk_widget_class_install_style_property_parser() which parses * borders in the form * "{ left, right, top, bottom }" for integers * %left, %right, %top and %bottom. * * Return value: %TRUE if @gstring could be parsed and @property_value * has been set to the resulting #GtkBorder. **/ gboolean gtk_rc_property_parse_border (const GParamSpec *pspec, const GString *gstring, GValue *property_value) { GtkBorder border; GScanner *scanner; gboolean success = FALSE; int left, right, top, bottom; g_return_val_if_fail (G_IS_PARAM_SPEC (pspec), FALSE); g_return_val_if_fail (G_VALUE_HOLDS_BOXED (property_value), FALSE); scanner = gtk_rc_scanner_new (); g_scanner_input_text (scanner, gstring->str, gstring->len); if (get_braced_int (scanner, TRUE, FALSE, &left) && get_braced_int (scanner, FALSE, FALSE, &right) && get_braced_int (scanner, FALSE, FALSE, &top) && get_braced_int (scanner, FALSE, TRUE, &bottom)) { border.left = left; border.right = right; border.top = top; border.bottom = bottom; g_value_set_boxed (property_value, &border); success = TRUE; } g_scanner_destroy (scanner); return success; } void _gtk_settings_handle_event (GdkEventSetting *event) { GtkSettings *settings; GParamSpec *pspec; guint property_id; settings = gtk_settings_get_for_screen (gdk_window_get_screen (event->window)); pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (settings), event->name); if (pspec) { property_id = pspec->param_id; if (property_id == PROP_COLOR_SCHEME) { GValue value = { 0, }; g_value_init (&value, G_TYPE_STRING); if (!gdk_screen_get_setting (settings->screen, pspec->name, &value)) g_value_set_static_string (&value, ""); merge_color_scheme (settings, &value, GTK_SETTINGS_SOURCE_XSETTING); g_value_unset (&value); } g_object_notify (G_OBJECT (settings), pspec->name); } } static void reset_rc_values_foreach (GQuark key_id, gpointer data, gpointer user_data) { GtkSettingsValuePrivate *qvalue = data; GSList **to_reset = user_data; if (qvalue->source == GTK_SETTINGS_SOURCE_RC_FILE) *to_reset = g_slist_prepend (*to_reset, GUINT_TO_POINTER (key_id)); } void _gtk_settings_reset_rc_values (GtkSettings *settings) { GSList *to_reset = NULL; GSList *tmp_list; GParamSpec **pspecs, **p; gint i; /* Remove any queued settings */ g_datalist_foreach (&settings->queued_settings, reset_rc_values_foreach, &to_reset); for (tmp_list = to_reset; tmp_list; tmp_list = tmp_list->next) { GQuark key_id = GPOINTER_TO_UINT (tmp_list->data); g_datalist_id_remove_data (&settings->queued_settings, key_id); } g_slist_free (to_reset); /* Now reset the active settings */ pspecs = g_object_class_list_properties (G_OBJECT_GET_CLASS (settings), NULL); i = 0; g_object_freeze_notify (G_OBJECT (settings)); for (p = pspecs; *p; p++) { if (settings->property_values[i].source == GTK_SETTINGS_SOURCE_RC_FILE) { GParamSpec *pspec = *p; g_param_value_set_default (pspec, &settings->property_values[i].value); g_object_notify (G_OBJECT (settings), pspec->name); } i++; } g_object_thaw_notify (G_OBJECT (settings)); g_free (pspecs); } static void settings_update_double_click (GtkSettings *settings) { if (gdk_screen_get_number (settings->screen) == 0) { GdkDisplay *display = gdk_screen_get_display (settings->screen); gint double_click_time; gint double_click_distance; g_object_get (settings, "gtk-double-click-time", &double_click_time, "gtk-double-click-distance", &double_click_distance, NULL); gdk_display_set_double_click_time (display, double_click_time); gdk_display_set_double_click_distance (display, double_click_distance); } } static void settings_update_modules (GtkSettings *settings) { gchar *modules; g_object_get (settings, "gtk-modules", &modules, NULL); _gtk_modules_settings_changed (settings, modules); g_free (modules); } #ifdef GDK_WINDOWING_X11 static void settings_update_cursor_theme (GtkSettings *settings) { GdkDisplay *display = gdk_screen_get_display (settings->screen); gchar *theme = NULL; gint size = 0; g_object_get (settings, "gtk-cursor-theme-name", &theme, "gtk-cursor-theme-size", &size, NULL); gdk_x11_display_set_cursor_theme (display, theme, size); g_free (theme); } static void settings_update_font_options (GtkSettings *settings) { gint hinting; gchar *hint_style_str; cairo_hint_style_t hint_style = CAIRO_HINT_STYLE_NONE; gint antialias; cairo_antialias_t antialias_mode = CAIRO_ANTIALIAS_GRAY; gchar *rgba_str; cairo_subpixel_order_t subpixel_order = CAIRO_SUBPIXEL_ORDER_DEFAULT; cairo_font_options_t *options; g_object_get (settings, "gtk-xft-antialias", &antialias, "gtk-xft-hinting", &hinting, "gtk-xft-hintstyle", &hint_style_str, "gtk-xft-rgba", &rgba_str, NULL); options = cairo_font_options_create (); cairo_font_options_set_hint_metrics (options, CAIRO_HINT_METRICS_ON); if (hinting >= 0 && !hinting) { hint_style = CAIRO_HINT_STYLE_NONE; } else if (hint_style_str) { if (strcmp (hint_style_str, "hintnone") == 0) hint_style = CAIRO_HINT_STYLE_NONE; else if (strcmp (hint_style_str, "hintslight") == 0) hint_style = CAIRO_HINT_STYLE_SLIGHT; else if (strcmp (hint_style_str, "hintmedium") == 0) hint_style = CAIRO_HINT_STYLE_MEDIUM; else if (strcmp (hint_style_str, "hintfull") == 0) hint_style = CAIRO_HINT_STYLE_FULL; } g_free (hint_style_str); cairo_font_options_set_hint_style (options, hint_style); if (rgba_str) { if (strcmp (rgba_str, "rgb") == 0) subpixel_order = CAIRO_SUBPIXEL_ORDER_RGB; else if (strcmp (rgba_str, "bgr") == 0) subpixel_order = CAIRO_SUBPIXEL_ORDER_BGR; else if (strcmp (rgba_str, "vrgb") == 0) subpixel_order = CAIRO_SUBPIXEL_ORDER_VRGB; else if (strcmp (rgba_str, "vbgr") == 0) subpixel_order = CAIRO_SUBPIXEL_ORDER_VBGR; g_free (rgba_str); } cairo_font_options_set_subpixel_order (options, subpixel_order); if (antialias >= 0 && !antialias) antialias_mode = CAIRO_ANTIALIAS_NONE; else if (subpixel_order != CAIRO_SUBPIXEL_ORDER_DEFAULT) antialias_mode = CAIRO_ANTIALIAS_SUBPIXEL; else if (antialias >= 0) antialias_mode = CAIRO_ANTIALIAS_GRAY; cairo_font_options_set_antialias (options, antialias_mode); gdk_screen_set_font_options (settings->screen, options); cairo_font_options_destroy (options); } #ifdef GDK_WINDOWING_X11 static gboolean settings_update_fontconfig (GtkSettings *settings) { static guint last_update_timestamp; static gboolean last_update_needed; guint timestamp; g_object_get (settings, "gtk-fontconfig-timestamp", ×tamp, NULL); /* if timestamp is the same as last_update_timestamp, we already have * updated fontconig on this timestamp (another screen requested it perhaps?), * just return the cached result.*/ if (timestamp != last_update_timestamp) { PangoFontMap *fontmap = pango_cairo_font_map_get_default (); gboolean update_needed = FALSE; /* bug 547680 */ if (PANGO_IS_FC_FONT_MAP (fontmap) && !FcConfigUptoDate (NULL)) { pango_fc_font_map_cache_clear (PANGO_FC_FONT_MAP (fontmap)); if (FcInitReinitialize ()) update_needed = TRUE; } last_update_timestamp = timestamp; last_update_needed = update_needed; } return last_update_needed; } #endif /* GDK_WINDOWING_X11 */ static void settings_update_resolution (GtkSettings *settings) { gint dpi_int; double dpi; g_object_get (settings, "gtk-xft-dpi", &dpi_int, NULL); if (dpi_int > 0) dpi = dpi_int / 1024.; else dpi = -1.; gdk_screen_set_resolution (settings->screen, dpi); } #endif typedef struct { GHashTable *color_hash; GHashTable *tables[GTK_SETTINGS_SOURCE_APPLICATION + 1]; gchar *lastentry[GTK_SETTINGS_SOURCE_APPLICATION + 1]; } ColorSchemeData; static void color_scheme_data_free (ColorSchemeData *data) { gint i; g_hash_table_unref (data->color_hash); for (i = 0; i <= GTK_SETTINGS_SOURCE_APPLICATION; i++) { if (data->tables[i]) g_hash_table_unref (data->tables[i]); g_free (data->lastentry[i]); } g_slice_free (ColorSchemeData, data); } static void settings_update_color_scheme (GtkSettings *settings) { if (!g_object_get_data (G_OBJECT (settings), "gtk-color-scheme")) { ColorSchemeData *data; GValue value = { 0, }; data = g_slice_new0 (ColorSchemeData); data->color_hash = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, (GDestroyNotify) gdk_color_free); g_object_set_data_full (G_OBJECT (settings), "gtk-color-scheme", data, (GDestroyNotify) color_scheme_data_free); g_value_init (&value, G_TYPE_STRING); if (gdk_screen_get_setting (settings->screen, "gtk-color-scheme", &value)) { merge_color_scheme (settings, &value, GTK_SETTINGS_SOURCE_XSETTING); g_value_unset (&value); } } } static gboolean add_color_to_hash (gchar *name, GdkColor *color, GHashTable *target) { GdkColor *old; old = g_hash_table_lookup (target, name); if (!old || !gdk_color_equal (old, color)) { g_hash_table_insert (target, g_strdup (name), gdk_color_copy (color)); return TRUE; } return FALSE; } static gboolean add_colors_to_hash_from_string (GHashTable *hash, const gchar *colors) { gchar *s, *p, *name; GdkColor color; gboolean changed = FALSE; gchar *copy; copy = g_strdup (colors); s = copy; while (s && *s) { name = s; p = strchr (s, ':'); if (p) { *p = '\0'; p++; } else break; while (*p == ' ') p++; s = p; while (*s) { if (*s == '\n' || *s == ';') { *s = '\0'; s++; break; } s++; } if (gdk_color_parse (p, &color)) changed |= add_color_to_hash (name, &color, hash); } g_free (copy); return changed; } static gboolean update_color_hash (ColorSchemeData *data, const gchar *str, GtkSettingsSource source) { gboolean changed = FALSE; gint i; GHashTable *old_hash; GHashTableIter iter; gpointer name; gpointer color; if ((str == NULL || *str == '\0') && (data->lastentry[source] == NULL || data->lastentry[source][0] == '\0')) return FALSE; if (str && data->lastentry[source] && strcmp (str, data->lastentry[source]) == 0) return FALSE; /* For the RC_FILE source we merge the values rather than over-writing * them, since multiple rc files might define independent sets of colors */ if ((source != GTK_SETTINGS_SOURCE_RC_FILE) && data->tables[source] && g_hash_table_size (data->tables[source]) > 0) { g_hash_table_unref (data->tables[source]); data->tables[source] = NULL; changed = TRUE; /* We can't rely on the code below since str might be "" */ } if (data->tables[source] == NULL) data->tables[source] = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, (GDestroyNotify) gdk_color_free); g_free (data->lastentry[source]); data->lastentry[source] = g_strdup (str); changed |= add_colors_to_hash_from_string (data->tables[source], str); if (!changed) return FALSE; /* Rebuild the merged hash table. */ if (data->color_hash) { old_hash = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, (GDestroyNotify) gdk_color_free); g_hash_table_iter_init (&iter, data->color_hash); while (g_hash_table_iter_next (&iter, &name, &color)) { g_hash_table_insert (old_hash, name, color); g_hash_table_iter_steal (&iter); } } else { old_hash = NULL; } for (i = 0; i <= GTK_SETTINGS_SOURCE_APPLICATION; i++) { if (data->tables[i]) g_hash_table_foreach (data->tables[i], (GHFunc) add_color_to_hash, data->color_hash); } if (old_hash) { /* now check if the merged hash has changed */ changed = FALSE; if (g_hash_table_size (old_hash) != g_hash_table_size (data->color_hash)) changed = TRUE; else { GHashTableIter iter; gpointer key, value, new_value; g_hash_table_iter_init (&iter, old_hash); while (g_hash_table_iter_next (&iter, &key, &value)) { new_value = g_hash_table_lookup (data->color_hash, key); if (!new_value || !gdk_color_equal (value, new_value)) { changed = TRUE; break; } } } g_hash_table_unref (old_hash); } else changed = TRUE; return changed; } static void merge_color_scheme (GtkSettings *settings, const GValue *value, GtkSettingsSource source) { ColorSchemeData *data; const gchar *colors; g_object_freeze_notify (G_OBJECT (settings)); colors = g_value_get_string (value); settings_update_color_scheme (settings); data = (ColorSchemeData *) g_object_get_data (G_OBJECT (settings), "gtk-color-scheme"); if (update_color_hash (data, colors, source)) g_object_notify (G_OBJECT (settings), "color-hash"); g_object_thaw_notify (G_OBJECT (settings)); } static GHashTable * get_color_hash (GtkSettings *settings) { ColorSchemeData *data; settings_update_color_scheme (settings); data = (ColorSchemeData *)g_object_get_data (G_OBJECT (settings), "gtk-color-scheme"); return data->color_hash; } static void append_color_scheme (gpointer key, gpointer value, gpointer data) { gchar *name = (gchar *)key; GdkColor *color = (GdkColor *)value; GString *string = (GString *)data; g_string_append_printf (string, "%s: #%04x%04x%04x\n", name, color->red, color->green, color->blue); } static gchar * get_color_scheme (GtkSettings *settings) { ColorSchemeData *data; GString *string; settings_update_color_scheme (settings); data = (ColorSchemeData *) g_object_get_data (G_OBJECT (settings), "gtk-color-scheme"); string = g_string_new (""); g_hash_table_foreach (data->color_hash, append_color_scheme, string); return g_string_free (string, FALSE); }