gtk.Settings

gtk.Settings
Prev	The gtk Class Reference	Next

gtk.Settings — an object that contains the global settings for the widgets on a gtk.gdk.Screen

Synopsis

class gtk.Settings(gobject.GObject):
    def set_string_property(name, v_string, origin)
    def set_long_property(name, v_long, origin)
    def set_double_property(name, v_double, origin)

Functions

    def gtk.settings_get_default()
    def gtk.settings_get_for_screen(screen)

Ancestry

+-- gobject.GObject
  +-- gtk.Settings

Properties

"gtk-alternative-button-order"	Read-Write	If `TRUE`, buttons in dialogs should use the alternative button order. Available in GTK+ 2.6 and above. Default value: `FALSE`
"gtk-button-images"	Read-Write	If `TRUE`, stock icons should be shown in buttons. Available in GTK+ 2.4 and above. Default value: `TRUE`
"gtk-can-change-accels"	Read-Write	If `TRUE`, the menu accelerators can be changed by pressing a key over the menu item. Default value: `FALSE`
"gtk-color-palette"	Read-Write	The 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-cursor-blink"	Read-Write	If `TRUE`, the cursor should blink. Default value: `TRUE`
"gtk-cursor-blink-time"	Read-Write	The length of the cursor blink cycle, in milliseconds. Allowed values: >= 100. Default value: 1200
"gtk-dnd-drag-threshold"	Read-Write	The number of pixels the cursor can move before dragging starts. Allowed values: >= 1. Default value: 8
"gtk-double-click-distance"	Read-Write	The maximum distance allowed between two clicks for them to be considered a double click (in pixels). Available in GTK+ 2.4 and above. Allowed values: >= 0. Default value: 5
"gtk-double-click-time"	Read-Write	The maximum time allowed between two clicks for them to be considered a double click (in milliseconds). Allowed values: >= 0. Default value: 250
"gtk-entry-select-on-focus"	Read-Write	If `TRUE`, select the contents of an entry when it is focused. Default value: `TRUE`
"gtk-font-name"	Read-Write	The name of the default font to use. Default value: "Sans 10"
"gtk-icon-sizes"	Read-Write	The list of icon sizes (gtk-menu=16,16;gtk-button=20,20...). Default value: `None`
"gtk-icon-theme-name"	Read-Write	The name of the icon theme to use. Available in GTK+ 2.4 and above. Default value: "hicolor"
"gtk-key-theme-name"	Read-Write	The name of the key theme RC file to load. Default value: `None`
"gtk-menu-bar-accel"	Read-Write	The keybinding to activate the menu bar. Default value: "F10"
"gtk-menu-bar-popup-delay"	Read-Write	The delay before the submenus of a menu bar appear. Allowed values: >= 0. Default value: 0 Available in GTK+ 2.2 and above.
"gtk-menu-images"	Read-Write	If `TRUE` images should be shown in menus. Default value: `TRUE`. Available in GTK+ 2.4 and above.
"gtk-menu-popdown-delay"	Read-Write	The time before hiding a submenu when the pointer is moving toward the submenu. Allowed values: >= 0. Default value: 1000. Available in GTK+ 2.2 and above.
"gtk-menu-popup-delay"	Read-Write	Minimum time the pointer must stay over a menu item before the submenu appears. Allowed values: >= 0. Default value: 225. Available in GTK+ 2.2 and above.
"gtk-modules"	Read-Write	The list of currently active GTK modules. Default value: `None`. Available in GTK+ 2.6 and above.
"gtk-split-cursor"	Read-Write	If `TRUE`, two cursors should be displayed for mixed left-to-right and right-to-left text. Default value: `TRUE`
"gtk-theme-name"	Read-Write	The name of the theme RC file to load. Default value: "Default"
"gtk-toolbar-icon-size"	Read-Write	the toolbar icon size - one of: `gtk.ICON_SIZE_MENU`, `gtk.ICON_SIZE_SMALL_TOOLBAR`, `gtk.ICON_SIZE_LARGE_TOOLBAR`, `gtk.ICON_SIZE_BUTTON`, `gtk.ICON_SIZE_DND` or `gtk.ICON_SIZE_DIALOG`. Default value: `gtk.ICON_SIZE_LARGE_TOOLBAR`
"gtk-toolbar-style"	Read-Write	The toolbar display style - one of: `gtk.TOOLBAR_ICONS`, `gtk.TOOLBAR_TEXT`, `gtk.TOOLBAR_BOTH` or `gtk.TOOLBAR_BOTH_HORIZ`. Default value: `gtk.TOOLBAR_BOTH`
"gtk-xft-antialias"	Read-Write	Whether to antialias Xft fonts; 0=no, 1=yes, -1=default. Default value: -1. Available in GTK+ 2.4 and above.
"gtk-xft-dpi"	Read-Write	Resolution for Xft, in 1024 * dots/inch. -1 to use default value. Allowed values: [-1,1048576]. Default value: -1. Available in GTK+ 2.4 and above.
"gtk-xft-hinting"	Read-Write	Whether to hint Xft fonts; 0=no, 1=yes, -1=default. Default value: -1. Available in GTK+ 2.4 and above.
"gtk-xft-hintstyle"	Read-Write	What degree of hinting to use; none, slight, medium, or full. Default value: `None`. Available in GTK+ 2.4 and above.
"gtk-xft-rgba"	Read-Write	Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr. Default value: `None`. Available in GTK+ 2.4 and above.

Description

The gtk.Settings object stores the values of the global settings associated with a gtk.gdk.Screen. The gtk.Settings object for the default gtk.gdk.Screen can be retrieved using the gtk.settings_get_default() function. The gtk.Widget.get_settings() method returns the gtk.Settings object of the gtk.gdk.Screen that the widget is displayed on.

Methods

gtk.Settings.set_string_property

    def set_string_property(name, v_string, origin)

`name` :	the name of the property to set
`v_string` :	the string value
`origin` :	the string value of the origin

The set_string_property() method sets the property named name to the string value specified by v_string at the string origin specified by origin. origin is an application specified string like "filename:linenumber" or "myapp:widgetname".

gtk.Settings.set_long_property

    def set_long_property(name, v_long, origin)

`name` :	the name of the property to set
`v_long` :	the long value
`origin` :	the string value of the origin

The set_long_property() method sets the property named name to the long value specified by v_long at the string origin specified by origin. origin is an application specified string like "filename:linenumber" or "myapp:widgetname".

gtk.Settings.set_double_property

    def set_double_property(name, v_double, origin)

`name` :	the name of the property to set
`v_double` :	the double value
`origin` :	the string value of the origin

The set_double_property() method sets the property named name to the double value specified by v_long at the string origin specified by origin. origin is an application specified string like "filename:linenumber" or "myapp:widgetname".

Functions

gtk.settings_get_default

    def gtk.settings_get_default()

Returns : the singleton gtk.Settings object

The gtk.settings_get_default function returns the singleton gtk.Settings object.

gtk.settings_get_for_screen

    def gtk.settings_get_for_screen(screen)

`screen` :	a `gtk.gdk.Screen` object
Returns :	a `gtk.Settings` object

Note

This function is available in PyGTK 2.2 and above.

The gtk.settings_get_for_screen() function returns the singleton gtk.Settings object for the gtk.gdk.Screen specified by screen.

Prev	Up	Next
gtk.SeparatorToolItem	Home	gtk.SizeGroup