2001-04-17 18:12:46 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
2002-11-29 23:08:54 +00:00
|
|
|
Settings
|
2001-04-17 18:12:46 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2002-11-29 23:08:54 +00:00
|
|
|
Sharing settings between applications
|
2001-04-17 18:12:46 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2009-06-11 05:28:39 +00:00
|
|
|
GtkSettings provide a mechanism to share global settings between applications.
|
|
|
|
On the X window system, this sharing is realized by an <ulink href="http://www.freedesktop.org/wiki/Specifications/xsettings-spec">XSettings</ulink>
|
|
|
|
manager that is usually part of the desktop environment, along with utilities
|
|
|
|
that let the user change these settings. In the absence of an Xsettings manager,
|
|
|
|
settings can also be specified in RC files.
|
|
|
|
</para>
|
2001-04-17 18:12:46 +00:00
|
|
|
|
2009-06-11 05:28:39 +00:00
|
|
|
<para>
|
|
|
|
Applications can override system-wide settings with gtk_settings_set_string_property(),
|
|
|
|
gtk_settings_set_long_property(), etc. This should be restricted to special
|
|
|
|
cases though; GtkSettings are not meant as an application configuration
|
|
|
|
facility. When doing so, you need to be aware that settings that are specific
|
|
|
|
to individual widgets may not be available before the widget type has been
|
|
|
|
realized at least once. The following example demonstrates a way to do this:
|
|
|
|
<informalexample><programlisting>
|
|
|
|
gtk_init (&argc, &argv);
|
|
|
|
|
2009-07-06 05:20:35 +00:00
|
|
|
/* make sure the type is realized */
|
2009-06-11 05:28:39 +00:00
|
|
|
g_type_class_unref (g_type_class_ref (GTK_TYPE_IMAGE_MENU_ITEM));
|
|
|
|
|
|
|
|
g_object_set (gtk_settings_get_default (), "gtk-menu-images", FALSE, NULL);
|
|
|
|
</programlisting></informalexample>
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
There is one GtkSettings instance per screen. It can be obtained with
|
|
|
|
gtk_settings_get_for_screen(), but in many cases, it is more convenient
|
|
|
|
to use gtk_widget_get_settings(). gtk_settings_get_default() returns the
|
|
|
|
GtkSettings instance for the default screen.
|
2001-04-17 18:12:46 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-06-20 22:06:27 +00:00
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
2001-04-17 18:12:46 +00:00
|
|
|
<!-- ##### STRUCT GtkSettings ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2005-12-20 05:47:43 +00:00
|
|
|
<!-- ##### ARG GtkSettings:color-hash ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-10-25 19:23:22 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-alternative-button-order ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2007-05-24 05:51:56 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-alternative-sort-arrows ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-button-images ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-can-change-accels ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-color-palette ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-12-20 05:47:43 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-color-scheme ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-cursor-blink ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-cursor-blink-time ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-10-10 13:30:55 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-cursor-blink-timeout ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-06-20 22:06:27 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-cursor-theme-name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-cursor-theme-size ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-dnd-drag-threshold ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-double-click-distance ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-double-click-time ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2007-05-24 05:51:56 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-enable-accels ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-12-20 05:47:43 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-enable-animations ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2008-07-05 20:30:16 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-enable-event-sounds ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-enable-input-feedback-sounds ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2007-05-24 05:51:56 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-enable-mnemonics ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2008-07-05 20:30:16 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-enable-tooltips ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-05-05 16:21:19 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-entry-password-hint-timeout ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-entry-select-on-focus ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-12-14 14:48:41 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-error-bell ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-05-05 16:21:19 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-fallback-icon-theme ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2007-05-24 05:51:56 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-file-chooser-backend ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-font-name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2008-06-14 01:21:31 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-fontconfig-timestamp ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-icon-sizes ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-icon-theme-name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2008-02-15 23:42:42 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-im-module ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-key-theme-name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-12-14 14:48:41 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-keynav-cursor-only ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-keynav-wrap-around ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-05-05 16:21:19 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-label-select-on-focus ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-menu-bar-accel ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-menu-bar-popup-delay ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-menu-images ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-menu-popdown-delay ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-menu-popup-delay ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-09-17 15:20:31 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-modules ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2007-05-24 05:51:56 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-print-backends ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-print-preview-command ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2007-07-20 23:16:43 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-recent-files-limit ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2008-05-30 05:08:50 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-recent-files-max-age ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-05-05 16:21:19 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-scrolled-window-placement ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-12-20 05:47:43 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-show-input-method-menu ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-show-unicode-menu ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2008-07-05 20:30:16 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-sound-theme-name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-theme-name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-05-05 16:21:19 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-timeout-expand ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-12-20 05:47:43 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-timeout-initial ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-timeout-repeat ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-toolbar-icon-size ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-toolbar-style ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2007-05-24 05:51:56 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-tooltip-browse-mode-timeout ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-tooltip-browse-timeout ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-tooltip-timeout ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-05-05 16:21:19 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-touchscreen-mode ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkSettings:gtk-xft-antialias ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-xft-dpi ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-xft-hinting ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-xft-hintstyle ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkSettings:gtk-xft-rgba ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2001-04-17 18:12:46 +00:00
|
|
|
<!-- ##### STRUCT GtkSettingsValue ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@origin:
|
|
|
|
@value:
|
|
|
|
|
2001-09-08 06:24:46 +00:00
|
|
|
<!-- ##### FUNCTION gtk_settings_get_default ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2002-04-30 18:16:14 +00:00
|
|
|
<!-- ##### FUNCTION gtk_settings_get_for_screen ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@screen:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2001-04-17 18:12:46 +00:00
|
|
|
<!-- ##### FUNCTION gtk_settings_install_property ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@pspec:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_settings_install_property_parser ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@pspec:
|
|
|
|
@parser:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_rc_property_parse_color ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@pspec:
|
|
|
|
@gstring:
|
|
|
|
@property_value:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_rc_property_parse_enum ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@pspec:
|
|
|
|
@gstring:
|
|
|
|
@property_value:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_rc_property_parse_flags ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@pspec:
|
|
|
|
@gstring:
|
|
|
|
@property_value:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_rc_property_parse_requisition ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@pspec:
|
|
|
|
@gstring:
|
|
|
|
@property_value:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_rc_property_parse_border ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@pspec:
|
|
|
|
@gstring:
|
|
|
|
@property_value:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_settings_set_property_value ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@settings:
|
|
|
|
@name:
|
|
|
|
@svalue:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_settings_set_string_property ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@settings:
|
|
|
|
@name:
|
|
|
|
@v_string:
|
|
|
|
@origin:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_settings_set_long_property ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@settings:
|
|
|
|
@name:
|
|
|
|
@v_long:
|
|
|
|
@origin:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_settings_set_double_property ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@settings:
|
|
|
|
@name:
|
|
|
|
@v_double:
|
|
|
|
@origin:
|
|
|
|
|
|
|
|
|