|  |  |  | GTK+ Reference Manual |  | 
|---|
Settings — Sharing settings between applications
#include <gtk/gtk.h> struct GtkSettings; struct 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);
GObject +----GtkSettings
"gtk-can-change-accels" gboolean : Read / Write "gtk-color-palette" gchararray : Read / Write "gtk-cursor-blink" gboolean : Read / Write "gtk-cursor-blink-time" gint : Read / Write "gtk-dnd-drag-threshold" gint : Read / Write "gtk-double-click-time" gint : Read / Write "gtk-entry-select-on-focus" gboolean : Read / Write "gtk-font-name" gchararray : Read / Write "gtk-icon-sizes" gchararray : Read / Write "gtk-key-theme-name" gchararray : Read / Write "gtk-menu-bar-accel" gchararray : Read / Write "gtk-menu-bar-popup-delay" gint : Read / Write "gtk-menu-popdown-delay" gint : Read / Write "gtk-menu-popup-delay" gint : Read / Write "gtk-split-cursor" gboolean : Read / Write "gtk-theme-name" gchararray : Read / Write "gtk-toolbar-icon-size" GtkIconSize : Read / Write "gtk-toolbar-style" GtkToolbarStyle : Read / Write
struct GtkSettingsValue {
  /* 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;
};
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);
| pspec : | |
| gstring : | |
| property_value : | |
| Returns : | 
gboolean    gtk_rc_property_parse_enum      (const GParamSpec *pspec,
                                             const GString *gstring,
                                             GValue *property_value);
| pspec : | |
| gstring : | |
| property_value : | |
| Returns : | 
gboolean    gtk_rc_property_parse_flags     (const GParamSpec *pspec,
                                             const GString *gstring,
                                             GValue *property_value);
| pspec : | |
| gstring : | |
| property_value : | |
| Returns : | 
gboolean    gtk_rc_property_parse_requisition
                                            (const GParamSpec *pspec,
                                             const GString *gstring,
                                             GValue *property_value);
| pspec : | |
| gstring : | |
| property_value : | |
| Returns : | 
gboolean    gtk_rc_property_parse_border    (const GParamSpec *pspec,
                                             const GString *gstring,
                                             GValue *property_value);
| pspec : | |
| gstring : | |
| property_value : | |
| Returns : | 
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 : | 
| "gtk-can-change-accels" (gboolean : Read / Write) | Whether menu accelerators can be changed by pressing a key over the menu item. | 
| "gtk-color-palette" (gchararray : Read / Write) | Palette to use in the color selector. | 
| "gtk-cursor-blink" (gboolean : Read / Write) | Whether the cursor should blink. | 
| "gtk-cursor-blink-time" (gint : Read / Write) | Length of the cursor blink cycle, in milleseconds. | 
| "gtk-dnd-drag-threshold" (gint : Read / Write) | Number of pixels the cursor can move before dragging. | 
| "gtk-double-click-time" (gint : Read / Write) | Maximum time allowed between two clicks for them to be considered a double click (in milliseconds). | 
| "gtk-entry-select-on-focus" (gboolean : Read / Write) | Whether to select the contents of an entry when it is focused. | 
| "gtk-font-name" (gchararray : Read / Write) | Name of default font to use. | 
| "gtk-icon-sizes" (gchararray : Read / Write) | List of icon sizes (gtk-menu=16,16;gtk-button=20,20... | 
| "gtk-key-theme-name" (gchararray : Read / Write) | Name of key theme RC file to load. | 
| "gtk-menu-bar-accel" (gchararray : Read / Write) | Keybinding to activate the menu bar. | 
| "gtk-menu-bar-popup-delay" (gint : Read / Write) | Delay before the submenus of a menu bar appear. | 
| "gtk-menu-popdown-delay" (gint : Read / Write) | The time before hiding a submenu when the pointer is moving towards the submenu. | 
| "gtk-menu-popup-delay" (gint : Read / Write) | Minimum time the pointer must stay over a menu item before the submenu appear. | 
| "gtk-split-cursor" (gboolean : Read / Write) | Whether two cursors should be displayed for mixed left-to-right and right-to-left text. | 
| "gtk-theme-name" (gchararray : Read / Write) | Name of theme RC file to load. | 
| "gtk-toolbar-icon-size" (GtkIconSize : Read / Write) | Size of icons in default toolbars. | 
| "gtk-toolbar-style" (GtkToolbarStyle : Read / Write) | Whether default toolbars have text only, text and icons, icons only, etc. | 
| << Resource Files | Bindings >> |