|  |  |  | GTK+ Reference Manual |  | 
|---|---|---|---|---|
#include <gtk/gtk.h>
                    GtkSettings;
                    GtkSettingsValue;
GtkSettings*        gtk_settings_get_default            (void);
GtkSettings*        gtk_settings_get_for_screen         (GdkScreen *screen);
void                gtk_settings_install_property       (GParamSpec *pspec);
void                gtk_settings_install_property_parser
                                                        (GParamSpec *pspec,
                                                         GtkRcPropertyParser parser);
gboolean            gtk_rc_property_parse_color         (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
gboolean            gtk_rc_property_parse_enum          (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
gboolean            gtk_rc_property_parse_flags         (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
gboolean            gtk_rc_property_parse_requisition   (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
gboolean            gtk_rc_property_parse_border        (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
void                gtk_settings_set_property_value     (GtkSettings *settings,
                                                         const gchar *name,
                                                         const GtkSettingsValue *svalue);
void                gtk_settings_set_string_property    (GtkSettings *settings,
                                                         const gchar *name,
                                                         const gchar *v_string,
                                                         const gchar *origin);
void                gtk_settings_set_long_property      (GtkSettings *settings,
                                                         const gchar *name,
                                                         glong v_long,
                                                         const gchar *origin);
void                gtk_settings_set_double_property    (GtkSettings *settings,
                                                         const gchar *name,
                                                         gdouble v_double,
                                                         const gchar *origin);
color-hash GHashTable : Read gtk-alternative-button-order gboolean : Read / Write gtk-button-images gboolean : Read / Write gtk-can-change-accels gboolean : Read / Write gtk-color-palette gchararray : Read / Write gtk-color-scheme gchararray : Read / Write gtk-cursor-blink gboolean : Read / Write gtk-cursor-blink-time gint : Read / Write gtk-cursor-theme-name gchararray : Read / Write gtk-cursor-theme-size gint : Read / Write gtk-dnd-drag-threshold gint : Read / Write gtk-double-click-distance gint : Read / Write gtk-double-click-time gint : Read / Write gtk-enable-animations gboolean : Read / Write gtk-entry-password-hint-timeout guint : Read / Write gtk-entry-select-on-focus gboolean : Read / Write gtk-fallback-icon-theme gchararray : Read / Write gtk-font-name gchararray : Read / Write gtk-icon-sizes gchararray : Read / Write gtk-icon-theme-name gchararray : Read / Write gtk-key-theme-name gchararray : Read / Write gtk-label-select-on-focus gboolean : Read / Write gtk-menu-bar-accel gchararray : Read / Write gtk-menu-bar-popup-delay gint : Read / Write gtk-menu-images gboolean : Read / Write gtk-menu-popdown-delay gint : Read / Write gtk-menu-popup-delay gint : Read / Write gtk-modules gchararray : Read / Write gtk-scrolled-window-placement GtkCornerType : Read / Write gtk-show-input-method-menu gboolean : Read / Write gtk-show-unicode-menu gboolean : Read / Write gtk-split-cursor gboolean : Read / Write gtk-theme-name gchararray : Read / Write gtk-timeout-expand gint : Read / Write gtk-timeout-initial gint : Read / Write gtk-timeout-repeat gint : Read / Write gtk-toolbar-icon-size GtkIconSize : Read / Write gtk-toolbar-style GtkToolbarStyle : Read / Write gtk-touchscreen-mode gboolean : Read / Write gtk-xft-antialias gint : Read / Write gtk-xft-dpi gint : Read / Write gtk-xft-hinting gint : Read / Write gtk-xft-hintstyle gchararray : Read / Write gtk-xft-rgba gchararray : Read / Write
typedef struct {
  /* origin should be something like "filename:linenumber" for rc files,
   * or e.g. "XProperty" for other sources
   */
  gchar *origin;
  /* valid types are LONG, DOUBLE and STRING corresponding to the token parsed,
   * or a GSTRING holding an unparsed statement
   */
  GValue value;
} GtkSettingsValue;
GtkSettings* gtk_settings_get_default (void);
Gets the GtkSettings object for the default GDK screen, creating
it if necessary. See gtk_settings_get_for_screen().
| Returns : | a GtkSettings object. If there is no default
 screen, then returns NULL. | 
GtkSettings* gtk_settings_get_for_screen (GdkScreen *screen);
Gets the GtkSettings object for screen, creating it if necessary.
| screen: | a GdkScreen. | 
| Returns : | a GtkSettings object. | 
Since 2.2
void                gtk_settings_install_property_parser
                                                        (GParamSpec *pspec,
                                                         GtkRcPropertyParser parser);
| pspec: | |
| parser: | 
gboolean            gtk_rc_property_parse_color         (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
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.
gboolean            gtk_rc_property_parse_enum          (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
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.
| pspec: | a GParamSpec | 
| gstring: | the GString to be parsed | 
| property_value: | a GValue which must hold enum values. | 
| Returns : | TRUEifgstringcould be parsed andproperty_valuehas been set to the resulting GEnumValue. | 
gboolean            gtk_rc_property_parse_flags         (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
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 | ... )".
| pspec: | a GParamSpec | 
| gstring: | the GString to be parsed | 
| property_value: | a GValue which must hold flags values. | 
| Returns : | TRUEifgstringcould be parsed andproperty_valuehas been set to the resulting flags value. | 
gboolean            gtk_rc_property_parse_requisition   (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
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.
| pspec: | a GParamSpec | 
| gstring: | the GString to be parsed | 
| property_value: | a GValue which must hold boxed values. | 
| Returns : | TRUEifgstringcould be parsed andproperty_valuehas been set to the resulting GtkRequisition. | 
gboolean            gtk_rc_property_parse_border        (const GParamSpec *pspec,
                                                         const GString *gstring,
                                                         GValue *property_value);
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.
| pspec: | a GParamSpec | 
| gstring: | the GString to be parsed | 
| property_value: | a GValue which must hold boxed values. | 
| Returns : | TRUEifgstringcould be parsed andproperty_valuehas been set to the resulting GtkBorder. | 
void gtk_settings_set_property_value (GtkSettings *settings, const gchar *name, const GtkSettingsValue *svalue);
| settings: | |
| name: | |
| svalue: | 
void gtk_settings_set_string_property (GtkSettings *settings, const gchar *name, const gchar *v_string, const gchar *origin);
| settings: | |
| name: | |
| v_string: | |
| origin: | 
void gtk_settings_set_long_property (GtkSettings *settings, const gchar *name, glong v_long, const gchar *origin);
| settings: | |
| name: | |
| v_long: | |
| origin: | 
void gtk_settings_set_double_property (GtkSettings *settings, const gchar *name, gdouble v_double, const gchar *origin);
| settings: | |
| name: | |
| v_double: | |
| origin: | 
color-hash propertycolor-hash GHashTable : Read
Holds a hash table representation of the gtk-color-scheme setting, mapping color names to GdkColors.
Since 2.10
gtk-alternative-button-order propertygtk-alternative-button-order gboolean : Read / Write
Whether buttons in dialogs should use the alternative button order.
Default value: FALSE
gtk-button-images propertygtk-button-images gboolean : Read / Write
Whether stock icons should be shown in buttons.
Default value: TRUE
gtk-can-change-accels propertygtk-can-change-accels gboolean : Read / Write
Whether menu accelerators can be changed by pressing a key over the menu item.
Default value: FALSE
gtk-color-palette propertygtk-color-palette gchararray : Read / Write
Palette to use in the color selector.
Default value: "black:white:gray50:red:purple:blue:light blue:green:yellow:orange:lavender:brown:goldenrod4:dodger blue:pink:light green:gray10:gray30:gray75:gray90"
gtk-color-scheme propertygtk-color-scheme gchararray : Read / Write
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.
Default value: ""
Since 2.10
gtk-cursor-blink propertygtk-cursor-blink gboolean : Read / Write
Whether the cursor should blink.
Default value: TRUE
gtk-cursor-blink-time propertygtk-cursor-blink-time gint : Read / Write
Length of the cursor blink cycle, in milleseconds.
Allowed values: >= 100
Default value: 1200
gtk-cursor-theme-name propertygtk-cursor-theme-name gchararray : Read / Write
Name of the cursor theme to use, or NULL to use the default theme.
Default value: NULL
gtk-cursor-theme-size propertygtk-cursor-theme-size gint : Read / Write
Size to use for cursors, or 0 to use the default size.
Allowed values: [0,128]
Default value: 0
gtk-dnd-drag-threshold propertygtk-dnd-drag-threshold gint : Read / Write
Number of pixels the cursor can move before dragging.
Allowed values: >= 1
Default value: 8
gtk-double-click-distance propertygtk-double-click-distance gint : Read / Write
Maximum distance allowed between two clicks for them to be considered a double click (in pixels).
Allowed values: >= 0
Default value: 5
gtk-double-click-time propertygtk-double-click-time gint : Read / Write
Maximum time allowed between two clicks for them to be considered a double click (in milliseconds).
Allowed values: >= 0
Default value: 250
gtk-enable-animations propertygtk-enable-animations gboolean : Read / Write
Whether to enable toolkit-wide animations.
Default value: TRUE
gtk-entry-password-hint-timeout propertygtk-entry-password-hint-timeout guint : Read / Write
How long to show the last inputted character in hidden entries. This value is in milliseconds. 0 disables showing the last char. 600 is a good value for enabling it.
Default value: 0
Since 2.10
gtk-entry-select-on-focus propertygtk-entry-select-on-focus gboolean : Read / Write
Whether to select the contents of an entry when it is focused.
Default value: TRUE
gtk-fallback-icon-theme propertygtk-fallback-icon-theme gchararray : Read / Write
Name of a icon theme to fall back to.
Default value: NULL
gtk-font-name propertygtk-font-name gchararray : Read / Write
Name of default font to use.
Default value: "Sans 10"
gtk-icon-sizes propertygtk-icon-sizes gchararray : Read / Write
List of icon sizes (gtk-menu=16,16:gtk-button=20,20...
Default value: NULL
gtk-icon-theme-name propertygtk-icon-theme-name gchararray : Read / Write
Name of icon theme to use.
Default value: "hicolor"
gtk-key-theme-name propertygtk-key-theme-name gchararray : Read / Write
Name of key theme RC file to load.
Default value: NULL
gtk-label-select-on-focus propertygtk-label-select-on-focus gboolean : Read / Write
Whether to select the contents of a selectable label when it is focused.
Default value: TRUE
gtk-menu-bar-accel propertygtk-menu-bar-accel gchararray : Read / Write
Keybinding to activate the menu bar.
Default value: "F10"
gtk-menu-bar-popup-delay propertygtk-menu-bar-popup-delay gint : Read / Write
Delay before the submenus of a menu bar appear.
Allowed values: >= 0
Default value: 0
gtk-menu-images propertygtk-menu-images gboolean : Read / Write
Whether images should be shown in menus.
Default value: TRUE
gtk-menu-popdown-delay propertygtk-menu-popdown-delay gint : Read / Write
The time before hiding a submenu when the pointer is moving towards the submenu.
Allowed values: >= 0
Default value: 1000
gtk-menu-popup-delay propertygtk-menu-popup-delay gint : Read / Write
Minimum time the pointer must stay over a menu item before the submenu appear.
Allowed values: >= 0
Default value: 225
gtk-modules propertygtk-modules gchararray : Read / Write
List of currently active GTK modules.
Default value: NULL
gtk-scrolled-window-placement propertygtk-scrolled-window-placement GtkCornerType : Read / Write
Where the contents of scrolled windows are located with respect to the scrollbars, if not overridden by the scrolled window's own placement.
Default value: GTK_CORNER_TOP_LEFT
Since 2.10
gtk-show-input-method-menu propertygtk-show-input-method-menu gboolean : Read / Write
Whether the context menus of entries and text views should offer to change the input method.
Default value: TRUE
gtk-show-unicode-menu propertygtk-show-unicode-menu gboolean : Read / Write
Whether the context menus of entries and text views should offer to insert control characters.
Default value: TRUE
gtk-split-cursor propertygtk-split-cursor gboolean : Read / Write
Whether two cursors should be displayed for mixed left-to-right and right-to-left text.
Default value: TRUE
gtk-theme-name propertygtk-theme-name gchararray : Read / Write
Name of theme RC file to load.
Default value: "Raleigh"
gtk-timeout-expand propertygtk-timeout-expand gint : Read / Write
Expand value for timeouts, when a widget is expanding a new region.
Allowed values: >= 0
Default value: 500
gtk-timeout-initial propertygtk-timeout-initial gint : Read / Write
Starting value for timeouts, when button is pressed.
Allowed values: >= 0
Default value: 200
gtk-timeout-repeat propertygtk-timeout-repeat gint : Read / Write
Repeat value for timeouts, when button is pressed.
Allowed values: >= 0
Default value: 20
gtk-toolbar-icon-size propertygtk-toolbar-icon-size GtkIconSize : Read / Write
Size of icons in default toolbars.
Default value: GTK_ICON_SIZE_LARGE_TOOLBAR
gtk-toolbar-style propertygtk-toolbar-style GtkToolbarStyle : Read / Write
Whether default toolbars have text only, text and icons, icons only, etc.
Default value: GTK_TOOLBAR_BOTH
gtk-touchscreen-mode propertygtk-touchscreen-mode gboolean : Read / Write
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.
Default value: FALSE
Since 2.10
gtk-xft-antialias propertygtk-xft-antialias gint : Read / Write
Whether to antialias Xft fonts; 0=no, 1=yes, -1=default.
Allowed values: [-1,1]
Default value: -1
gtk-xft-dpi propertygtk-xft-dpi gint : Read / Write
Resolution for Xft, in 1024 * dots/inch. -1 to use default value.
Allowed values: [-1,1048576]
Default value: -1
gtk-xft-hinting propertygtk-xft-hinting gint : Read / Write
Whether to hint Xft fonts; 0=no, 1=yes, -1=default.
Allowed values: [-1,1]
Default value: -1
gtk-xft-hintstyle propertygtk-xft-hintstyle gchararray : Read / Write
What degree of hinting to use; hintnone, hintslight, hintmedium, or hintfull.
Default value: NULL