Gtk.Settings¶

Subclasses:	None

Methods¶

Inherited:	GObject.Object (37), Gtk.StyleProvider (3)
Structs:	GObject.ObjectClass (5)

class	`get_default` ()
class	`get_for_screen` (screen)
class	`install_property` (pspec)
class	`install_property_parser` (pspec, parser)
	`reset_property` (name)
	`set_double_property` (name, v_double, origin)
	`set_long_property` (name, v_long, origin)
	`set_property_value` (name, svalue)
	`set_string_property` (name, v_string, origin)

Virtual Methods¶

Inherited:	GObject.Object (7), Gtk.StyleProvider (3)

Properties¶

Name	Type	Flags	Short Description
`color-hash`	`GLib.HashTable`	d/r	A hash table representation of the color scheme. `deprecated`
`gtk-alternative-button-order`	`bool`	r/w	Whether buttons in dialogs should use the alternative button order
`gtk-alternative-sort-arrows`	`bool`	r/w	Whether the direction of the sort indicators in list and tree views is inverted compared to the default (where down means ascending)
`gtk-application-prefer-dark-theme`	`bool`	r/w	Whether the application prefers to have a dark theme.
`gtk-auto-mnemonics`	`bool`	d/r/w	Whether mnemonics should be automatically shown and hidden when the user presses the mnemonic activator. `deprecated`
`gtk-button-images`	`bool`	d/r/w	Whether images should be shown on buttons `deprecated`
`gtk-can-change-accels`	`bool`	d/r/w	Whether menu accelerators can be changed by pressing a key over the menu item `deprecated`
`gtk-color-palette`	`str`	d/r/w	Palette to use in the color selector `deprecated`
`gtk-color-scheme`	`str`	d/r/w	A palette of named colors for use in themes `deprecated`
`gtk-cursor-aspect-ratio`	`float`	r/w	The aspect ratio of the text caret
`gtk-cursor-blink`	`bool`	r/w	Whether the cursor should blink
`gtk-cursor-blink-time`	`int`	r/w	Length of the cursor blink cycle, in milliseconds
`gtk-cursor-blink-timeout`	`int`	r/w	Time after which the cursor stops blinking, in seconds
`gtk-cursor-theme-name`	`str`	r/w	Name of the cursor theme to use, or `None` to use the default theme
`gtk-cursor-theme-size`	`int`	r/w	Size to use for cursors, or 0 to use the default size
`gtk-decoration-layout`	`str`	r/w	The layout for window decorations
`gtk-dialogs-use-header`	`bool`	r/w	Whether builtin GTK+ dialogs should use a header bar instead of an action area.
`gtk-dnd-drag-threshold`	`int`	r/w	Number of pixels the cursor can move before dragging
`gtk-double-click-distance`	`int`	r/w	Maximum distance allowed between two clicks for them to be considered a double click (in pixels)
`gtk-double-click-time`	`int`	r/w	Maximum time allowed between two clicks for them to be considered a double click (in milliseconds)
`gtk-enable-accels`	`bool`	r/w	Whether menu items should have accelerators
`gtk-enable-animations`	`bool`	r/w	Whether to enable toolkit-wide animations.
`gtk-enable-event-sounds`	`bool`	r/w	Whether to play any event sounds at all
`gtk-enable-input-feedback-sounds`	`bool`	r/w	Whether to play event sounds as feedback to user input
`gtk-enable-mnemonics`	`bool`	r/w	Whether labels should have mnemonics `deprecated`
`gtk-enable-primary-paste`	`bool`	r/w	Whether a middle click on a mouse should paste the ‘PRIMARY’ clipboard content at the cursor location.
`gtk-enable-tooltips`	`bool`	d/r/w	Whether tooltips should be shown on widgets `deprecated`
`gtk-entry-password-hint-timeout`	`int`	r/w	How long to show the last input character in hidden entries
`gtk-entry-select-on-focus`	`bool`	r/w	Whether to select the contents of an entry when it is focused
`gtk-error-bell`	`bool`	r/w	When `True`, keyboard navigation and other errors will cause a beep
`gtk-fallback-icon-theme`	`str`	d/r/w	Name of a icon theme to fall back to `deprecated`
`gtk-file-chooser-backend`	`str`	d/r/w	Name of the `Gtk.FileChooser` backend to use by default `deprecated`
`gtk-font-name`	`str`	r/w	The default font family and size to use
`gtk-fontconfig-timestamp`	`int`	r/w	Timestamp of current fontconfig configuration
`gtk-icon-sizes`	`str`	d/r/w	List of icon sizes (gtk-menu=16,16:py:data::gtk-button<Gtk.Settings.props.gtk_button>=20,20… `deprecated`
`gtk-icon-theme-name`	`str`	r/w	Name of icon theme to use
`gtk-im-module`	`str`	r/w	Which IM module should be used by default
`gtk-im-preedit-style`	`Gtk.IMPreeditStyle`	d/r/w	How to draw the input method preedit string `deprecated`
`gtk-im-status-style`	`Gtk.IMStatusStyle`	d/r/w	How to draw the input method statusbar `deprecated`
`gtk-key-theme-name`	`str`	r/w	Name of key theme to load
`gtk-keynav-cursor-only`	`bool`	d/r/w	When `True`, there are only cursor keys available to navigate widgets `deprecated`
`gtk-keynav-use-caret`	`bool`	r/w	Whether to show cursor in text
`gtk-keynav-wrap-around`	`bool`	d/r/w	Whether to wrap around when keyboard-navigating widgets `deprecated`
`gtk-label-select-on-focus`	`bool`	r/w	Whether to select the contents of a selectable label when it is focused
`gtk-long-press-time`	`int`	r/w	Time for a button/touch press to be considered a long press (in milliseconds)
`gtk-menu-bar-accel`	`str`	r/w	Keybinding to activate the menu bar `deprecated`
`gtk-menu-bar-popup-delay`	`int`	d/r/w	Delay before the submenus of a menu bar appear `deprecated`
`gtk-menu-images`	`bool`	d/r/w	Whether images should be shown in menus `deprecated`
`gtk-menu-popdown-delay`	`int`	d/r/w	The time before hiding a submenu when the pointer is moving towards the submenu `deprecated`
`gtk-menu-popup-delay`	`int`	d/r/w	Minimum time the pointer must stay over a menu item before the submenu appear `deprecated`
`gtk-modules`	`str`	r/w	List of currently active GTK modules
`gtk-overlay-scrolling`	`bool`	r/w	Whether to use overlay scrollbars
`gtk-primary-button-warps-slider`	`bool`	r/w	Whether a primary click on the trough should warp the slider into position
`gtk-print-backends`	`str`	r/w	List of the GtkPrintBackend backends to use by default
`gtk-print-preview-command`	`str`	r/w	Command to run when displaying a print preview
`gtk-recent-files-enabled`	`bool`	r/w	Whether GTK+ remembers recent files
`gtk-recent-files-limit`	`int`	d/r/w	Number of recently used files `deprecated`
`gtk-recent-files-max-age`	`int`	r/w	Maximum age of recently used files, in days
`gtk-scrolled-window-placement`	`Gtk.CornerType`	d/r/w	Where the contents of scrolled windows are located with respect to the scrollbars, if not overridden by the scrolled window’s own placement. `deprecated`
`gtk-shell-shows-app-menu`	`bool`	r/w	Set to `True` if the desktop environment is displaying the app menu, `False` if the app should display it itself.
`gtk-shell-shows-desktop`	`bool`	r/w	Set to `True` if the desktop environment is displaying the desktop folder, `False` if not.
`gtk-shell-shows-menubar`	`bool`	r/w	Set to `True` if the desktop environment is displaying the menubar, `False` if the app should display it itself.
`gtk-show-input-method-menu`	`bool`	d/r/w	Whether the context menus of entries and text views should offer to change the input method `deprecated`
`gtk-show-unicode-menu`	`bool`	d/r/w	Whether the context menus of entries and text views should offer to insert control characters `deprecated`
`gtk-sound-theme-name`	`str`	r/w	XDG sound theme name
`gtk-split-cursor`	`bool`	r/w	Whether two cursors should be displayed for mixed left-to-right and right-to-left text
`gtk-theme-name`	`str`	r/w	Name of theme to load
`gtk-timeout-expand`	`int`	d/r/w	Expand value for timeouts, when a widget is expanding a new region `deprecated`
`gtk-timeout-initial`	`int`	d/r/w	Starting value for timeouts, when button is pressed `deprecated`
`gtk-timeout-repeat`	`int`	d/r/w	Repeat value for timeouts, when button is pressed `deprecated`
`gtk-titlebar-double-click`	`str`	r/w	The action to take on titlebar double-click
`gtk-titlebar-middle-click`	`str`	r/w	The action to take on titlebar middle-click
`gtk-titlebar-right-click`	`str`	r/w	The action to take on titlebar right-click
`gtk-toolbar-icon-size`	`Gtk.IconSize`	d/r/w	The size of icons in default toolbars. `deprecated`
`gtk-toolbar-style`	`Gtk.ToolbarStyle`	d/r/w	Whether default toolbars have text only, text and icons, icons only, etc. `deprecated`
`gtk-tooltip-browse-mode-timeout`	`int`	d/r/w	Timeout after which browse mode is disabled `deprecated`
`gtk-tooltip-browse-timeout`	`int`	d/r/w	Timeout before tooltip is shown when browse mode is enabled `deprecated`
`gtk-tooltip-timeout`	`int`	d/r/w	Timeout before tooltip is shown `deprecated`
`gtk-touchscreen-mode`	`bool`	d/r/w	When `True`, there are no motion notify events delivered on this screen `deprecated`
`gtk-visible-focus`	`Gtk.PolicyType`	d/r/w	Whether ‘focus rectangles’ should be hidden until the user starts to use the keyboard. `deprecated`
`gtk-xft-antialias`	`int`	r/w	Whether to antialias Xft fonts; 0=no, 1=yes, -1=default
`gtk-xft-dpi`	`int`	r/w	Resolution for Xft, in 1024 * dots/inch. -1 to use default value
`gtk-xft-hinting`	`int`	r/w	Whether to hint Xft fonts; 0=no, 1=yes, -1=default
`gtk-xft-hintstyle`	`str`	r/w	What degree of hinting to use; hintnone, hintslight, hintmedium, or hintfull
`gtk-xft-rgba`	`str`	r/w	Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr

Signals¶

Inherited:	GObject.Object (1)

Fields¶

Inherited:	GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Gtk.Settings(**kwargs)¶

Bases:	`GObject.Object`, `Gtk.StyleProvider`
Abstract:	No
Structure:	`Gtk.SettingsClass`

Gtk.Settings provide a mechanism to share global settings between applications.

On the X window system, this sharing is realized by an XSettings 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, GTK+ reads default values for settings from settings.ini files in /etc/gtk-3.0, $XDG_CONFIG_DIRS/gtk-3.0 and $XDG_CONFIG_HOME/gtk-3.0. These files must be valid key files (see GLib.KeyFile), and have a section called Settings. Themes can also provide default values for settings by installing a settings.ini file next to their gtk.css file.

Applications can override system-wide settings by setting the property of the Gtk.Settings object with g_object_set(). This should be restricted to special cases though; Gtk.Settings 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:

gtk_init (&argc, &argv);

// make sure the type is realized
g_type_class_unref (g_type_class_ref (GTK_TYPE_IMAGE_MENU_ITEM));

g_object_set (gtk_settings_get_default (), "gtk-enable-animations", FALSE, NULL);

There is one Gtk.Settings 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 Gtk.Settings instance for the default screen.

classmethod get_default()[source]¶

Returns:	a `Gtk.Settings` object. If there is no default screen, then returns `None`.
Return type:	`Gtk.Settings` or `None`

Gets the Gtk.Settings object for the default GDK screen, creating it if necessary. See Gtk.Settings.get_for_screen().

classmethod get_for_screen(screen)[source]¶

Parameters:	screen (`Gdk.Screen`) – a `Gdk.Screen`.
Returns:	a `Gtk.Settings` object.
Return type:	`Gtk.Settings`

Gets the Gtk.Settings object for screen, creating it if necessary.

New in version 2.2.

classmethod install_property(pspec)[source]¶

Parameters:	pspec (`GObject.ParamSpec`) –

Deprecated since version 3.16: This function is not useful outside GTK+.

classmethod install_property_parser(pspec, parser)[source]¶

Parameters:	pspec (`GObject.ParamSpec`) – parser (`Gtk.RcPropertyParser`) –

Deprecated since version 3.16: This function is not useful outside GTK+.

reset_property(name)[source]¶

Parameters:	name (`str`) – the name of the setting to reset

Undoes the effect of calling g_object_set() to install an application-specific value for a setting. After this call, the setting will again follow the session-wide value for this setting.

New in version 3.20.

set_double_property(name, v_double, origin)[source]¶

Parameters:	name (`str`) – v_double (`float`) – origin (`str`) –

Deprecated since version 3.16: Use g_object_set() instead.

set_long_property(name, v_long, origin)[source]¶

Parameters:	name (`str`) – v_long (`int`) – origin (`str`) –

Deprecated since version 3.16: Use g_object_set() instead.

set_property_value(name, svalue)[source]¶

Parameters:	name (`str`) – svalue (`Gtk.SettingsValue`) –

Deprecated since version 3.16: Use g_object_set() instead.

set_string_property(name, v_string, origin)[source]¶

Parameters:	name (`str`) – v_string (`str`) – origin (`str`) –

Deprecated since version 3.16: Use g_object_set() instead.

Property Details¶

Gtk.Settings.props.color_hash¶

Name:	`color-hash`
Type:	`GLib.HashTable`
Default Value:	`None`
Flags:	`DEPRECATED`, `READABLE`

Holds a hash table representation of the Gtk.Settings :gtk-color-scheme setting, mapping color names to Gdk.Colors.

New in version 2.10.

Deprecated since version 3.8: Will always return an empty hash table.

Gtk.Settings.props.gtk_alternative_button_order¶

Name:	`gtk-alternative-button-order`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

Whether buttons in dialogs should use the alternative button order

Gtk.Settings.props.gtk_alternative_sort_arrows¶

Name:	`gtk-alternative-sort-arrows`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

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.

New in version 2.12.

Gtk.Settings.props.gtk_application_prefer_dark_theme¶

Name:	`gtk-application-prefer-dark-theme`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

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…).

New in version 3.0.

Gtk.Settings.props.gtk_auto_mnemonics¶

Name:	`gtk-auto-mnemonics`
Type:	`bool`
Default Value:	`True`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Whether mnemonics should be automatically shown and hidden when the user presses the mnemonic activator.

New in version 2.20.

Deprecated since version 3.10: This setting is ignored

Gtk.Settings.props.gtk_button_images¶

Name:	`gtk-button-images`
Type:	`bool`
Default Value:	`False`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Whether images should be shown on buttons

New in version 2.4.

Deprecated since version 3.10: This setting is deprecated. Application developers control whether a button should show an icon or not, on a per-button basis. If a Gtk.Button should show an icon, use the Gtk.Button :always-show-image property of Gtk.Button, and pack a Gtk.Image inside the Gtk.Button

Gtk.Settings.props.gtk_can_change_accels¶

Name:	`gtk-can-change-accels`
Type:	`bool`
Default Value:	`False`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Whether menu accelerators can be changed by pressing a key over the menu item.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_color_palette¶

Name:	`gtk-color-palette`
Type:	`str`
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'`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Palette to use in the deprecated color selector.

Deprecated since version 3.10: Only used by the deprecated color selector widget.

Gtk.Settings.props.gtk_color_scheme¶

Name:	`gtk-color-scheme`
Type:	`str`
Default Value:	`''`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

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; ...

New in version 2.10.

Deprecated since version 3.8: Color scheme support was dropped and is no longer supported. You can still set this property, but it will be ignored.

Gtk.Settings.props.gtk_cursor_aspect_ratio¶

Name:	`gtk-cursor-aspect-ratio`
Type:	`float`
Default Value:	`0.03999999910593033`
Flags:	`READABLE`, `WRITABLE`

The aspect ratio of the text caret

Gtk.Settings.props.gtk_cursor_blink¶

Name:	`gtk-cursor-blink`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether the cursor should blink.

Also see the Gtk.Settings :gtk-cursor-blink-timeout setting, which allows more flexible control over cursor blinking.

Gtk.Settings.props.gtk_cursor_blink_time¶

Name:	`gtk-cursor-blink-time`
Type:	`int`
Default Value:	`1200`
Flags:	`READABLE`, `WRITABLE`

Length of the cursor blink cycle, in milliseconds

Gtk.Settings.props.gtk_cursor_blink_timeout¶

Name:	`gtk-cursor-blink-timeout`
Type:	`int`
Default Value:	`10`
Flags:	`READABLE`, `WRITABLE`

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 Gtk.Settings :gtk-cursor-blink to False.

New in version 2.12.

Gtk.Settings.props.gtk_cursor_theme_name¶

Name:	`gtk-cursor-theme-name`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

Name of the cursor theme to use, or None to use the default theme

Gtk.Settings.props.gtk_cursor_theme_size¶

Name:	`gtk-cursor-theme-size`
Type:	`int`
Default Value:	`0`
Flags:	`READABLE`, `WRITABLE`

Size to use for cursors, or 0 to use the default size

Gtk.Settings.props.gtk_decoration_layout¶

Name:	`gtk-decoration-layout`
Type:	`str`
Default Value:	`'menu:minimize,maximize,close'`
Flags:	`READABLE`, `WRITABLE`

This setting determines which buttons should be put in the titlebar of client-side decorated windows, and whether they should be placed at the left of right.

The format of the string is button names, separated by commas. A colon separates the buttons that should appear on the left from those on the right. Recognized button names are minimize, maximize, close, icon (the window icon) and menu (a menu button for the fallback app menu).

For example, “menu:minimize,maximize,close” specifies a menu on the left, and minimize, maximize and close buttons on the right.

Note that buttons will only be shown when they are meaningful. E.g. a menu button only appears when the desktop shell does not show the app menu, and a close button only appears on a window that can be closed.

Also note that the setting can be overridden with the Gtk.HeaderBar :decoration-layout property.

New in version 3.12.

Gtk.Settings.props.gtk_dialogs_use_header¶

Name:	`gtk-dialogs-use-header`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

Whether builtin GTK+ dialogs such as the file chooser, the color chooser or the font chooser will use a header bar at the top to show action widgets, or an action area at the bottom.

This setting does not affect custom dialogs using Gtk.Dialog directly, or message dialogs.

New in version 3.12.

Gtk.Settings.props.gtk_dnd_drag_threshold¶

Name:	`gtk-dnd-drag-threshold`
Type:	`int`
Default Value:	`8`
Flags:	`READABLE`, `WRITABLE`

Number of pixels the cursor can move before dragging

Gtk.Settings.props.gtk_double_click_distance¶

Name:	`gtk-double-click-distance`
Type:	`int`
Default Value:	`5`
Flags:	`READABLE`, `WRITABLE`

Maximum distance allowed between two clicks for them to be considered a double click (in pixels)

Gtk.Settings.props.gtk_double_click_time¶

Name:	`gtk-double-click-time`
Type:	`int`
Default Value:	`400`
Flags:	`READABLE`, `WRITABLE`

Maximum time allowed between two clicks for them to be considered a double click (in milliseconds)

Gtk.Settings.props.gtk_enable_accels¶

Name:	`gtk-enable-accels`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether menu items should have visible accelerators which can be activated.

New in version 2.12.

Gtk.Settings.props.gtk_enable_animations¶

Name:	`gtk-enable-animations`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether to enable toolkit-wide animations.

Gtk.Settings.props.gtk_enable_event_sounds¶

Name:	`gtk-enable-event-sounds`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether to play any event sounds at all.

See the Sound Theme Specifications 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.

New in version 2.14.

Gtk.Settings.props.gtk_enable_input_feedback_sounds¶

Name:	`gtk-enable-input-feedback-sounds`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether to play event sounds as feedback to user input.

See the Sound Theme Specifications 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.

New in version 2.14.

Gtk.Settings.props.gtk_enable_mnemonics¶

Name:	`gtk-enable-mnemonics`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether labels and menu items should have visible mnemonics which can be activated.

New in version 2.12.

Deprecated since version 3.10: This setting can still be used for application overrides, but will be ignored in the future

Gtk.Settings.props.gtk_enable_primary_paste¶

Name:	`gtk-enable-primary-paste`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether a middle click on a mouse should paste the ‘PRIMARY’ clipboard content at the cursor location.

New in version 3.4.

Gtk.Settings.props.gtk_enable_tooltips¶

Name:	`gtk-enable-tooltips`
Type:	`bool`
Default Value:	`True`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Whether tooltips should be shown on widgets.

New in version 2.14.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_entry_password_hint_timeout¶

Name:	`gtk-entry-password-hint-timeout`
Type:	`int`
Default Value:	`0`
Flags:	`READABLE`, `WRITABLE`

How long to show the last input character in hidden entries. This value is in milliseconds. 0 disables showing the last str. 600 is a good value for enabling it.

New in version 2.10.

Gtk.Settings.props.gtk_entry_select_on_focus¶

Name:	`gtk-entry-select-on-focus`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether to select the contents of an entry when it is focused

Gtk.Settings.props.gtk_error_bell¶

Name:	`gtk-error-bell`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

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.

New in version 2.12.

Gtk.Settings.props.gtk_fallback_icon_theme¶

Name:	`gtk-fallback-icon-theme`
Type:	`str`
Default Value:	`None`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Name of a icon theme to fall back to.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_file_chooser_backend¶

Name:	`gtk-file-chooser-backend`
Type:	`str`
Default Value:	`None`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Name of the Gtk.FileChooser backend to use by default.

Deprecated since version 3.10: This setting is ignored. Gtk.FileChooser uses GIO by default.

Gtk.Settings.props.gtk_font_name¶

Name:	`gtk-font-name`
Type:	`str`
Default Value:	`'Sans 10'`
Flags:	`READABLE`, `WRITABLE`

The default font to use. GTK+ uses the family name and size from this string.

Gtk.Settings.props.gtk_fontconfig_timestamp¶

Name:	`gtk-fontconfig-timestamp`
Type:	`int`
Default Value:	`0`
Flags:	`READABLE`, `WRITABLE`

Timestamp of current fontconfig configuration

Gtk.Settings.props.gtk_icon_sizes¶

Name:	`gtk-icon-sizes`
Type:	`str`
Default Value:	`None`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

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:py:data::gtk-button<Gtk.Settings.props.gtk_button>=20,20:py:data::gtk-dialog<Gtk.Settings.props.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.IconSize.register().

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_icon_theme_name¶

Name:	`gtk-icon-theme-name`
Type:	`str`
Default Value:	`'Adwaita'`
Flags:	`READABLE`, `WRITABLE`

Name of icon theme to use

Gtk.Settings.props.gtk_im_module¶

Name:	`gtk-im-module`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

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. This also can be a colon-separated list of input methods, which GTK+ will try in turn until it finds one available on the system.

See Gtk.IMContext.

Gtk.Settings.props.gtk_im_preedit_style¶

Name:	`gtk-im-preedit-style`
Type:	`Gtk.IMPreeditStyle`
Default Value:	`Gtk.IMPreeditStyle.CALLBACK`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

How to draw the input method preedit string.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_im_status_style¶

Name:	`gtk-im-status-style`
Type:	`Gtk.IMStatusStyle`
Default Value:	`Gtk.IMStatusStyle.CALLBACK`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

How to draw the input method statusbar.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_key_theme_name¶

Name:	`gtk-key-theme-name`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

Name of key theme to load

Gtk.Settings.props.gtk_keynav_cursor_only¶

Name:	`gtk-keynav-cursor-only`
Type:	`bool`
Default Value:	`False`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

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.

New in version 2.12.

Deprecated since version 3.10: Generally, the behavior for touchscreen input should be performed dynamically based on Gdk.Event.get_source_device().

Gtk.Settings.props.gtk_keynav_use_caret¶

Name:	`gtk-keynav-use-caret`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

Whether GTK+ should make sure that text can be navigated with a caret, even if it is not editable. This is useful when using a screen reader.

New in version 3.20.

Gtk.Settings.props.gtk_keynav_wrap_around¶

Name:	`gtk-keynav-wrap-around`
Type:	`bool`
Default Value:	`True`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

When True, some widgets will wrap around when doing keyboard navigation, such as menus, menubars and notebooks.

New in version 2.12.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_label_select_on_focus¶

Name:	`gtk-label-select-on-focus`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether to select the contents of a selectable label when it is focused

Gtk.Settings.props.gtk_long_press_time¶

Name:	`gtk-long-press-time`
Type:	`int`
Default Value:	`500`
Flags:	`READABLE`, `WRITABLE`

The time for a button or touch press to be considered a “long press”.

New in version 3.14.

Gtk.Settings.props.gtk_menu_bar_accel¶

Name:	`gtk-menu-bar-accel`
Type:	`str`
Default Value:	`'F10'`
Flags:	`READABLE`, `WRITABLE`

Keybinding to activate the menu bar.

Deprecated since version 3.10: This setting can still be used for application overrides, but will be ignored in the future

Gtk.Settings.props.gtk_menu_bar_popup_delay¶

Name:	`gtk-menu-bar-popup-delay`
Type:	`int`
Default Value:	`0`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Delay before the submenus of a menu bar appear.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_menu_images¶

Name:	`gtk-menu-images`
Type:	`bool`
Default Value:	`False`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Whether images should be shown in menu items

Deprecated since version 3.10: This setting is deprecated. Application developers control whether or not a Gtk.MenuItem should have an icon or not, on a per widget basis. Either use a Gtk.MenuItem with a Gtk.Box containing a Gtk.Image and a Gtk.AccelLabel, or describe your menus using a Gio.Menu XML description

Gtk.Settings.props.gtk_menu_popdown_delay¶

Name:	`gtk-menu-popdown-delay`
Type:	`int`
Default Value:	`1000`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

The time before hiding a submenu when the pointer is moving towards the submenu.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_menu_popup_delay¶

Name:	`gtk-menu-popup-delay`
Type:	`int`
Default Value:	`225`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Minimum time the pointer must stay over a menu item before the submenu appear.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_modules¶

Name:	`gtk-modules`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

List of currently active GTK modules

Gtk.Settings.props.gtk_overlay_scrolling¶

Name:	`gtk-overlay-scrolling`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether scrolled windows may use overlayed scrolling indicators. If this is set to False, scrolled windows will have permanent scrollbars.

New in version 3.24.9.

Gtk.Settings.props.gtk_primary_button_warps_slider¶

Name:	`gtk-primary-button-warps-slider`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

If the value of this setting is True, clicking the primary button in a Gtk.Range trough will move the slider, and hence set the range’s value, to the point that you clicked. If it is False, a primary click will cause the slider/value to move by the range’s page-size towards the point clicked.

Whichever action you choose for the primary button, the other action will be available by holding Shift and primary-clicking, or (since GTK+ 3.22.25) clicking the middle mouse button.

New in version 3.6.

Gtk.Settings.props.gtk_print_backends¶

Name:	`gtk-print-backends`
Type:	`str`
Default Value:	`'file,cups,cloudprint'`
Flags:	`READABLE`, `WRITABLE`

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”.

New in version 2.10.

Gtk.Settings.props.gtk_print_preview_command¶

Name:	`gtk-print-preview-command`
Type:	`str`
Default Value:	`'evince --unlink-tempfile --preview --print-settings %s %f'`
Flags:	`READABLE`, `WRITABLE`

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.PrintSettings.to_file().

The preview application is responsible for removing the pdf file and the print settings file when it is done.

New in version 2.10.

Gtk.Settings.props.gtk_recent_files_enabled¶

Name:	`gtk-recent-files-enabled`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether GTK+ should keep track of items inside the recently used resources list. If set to False, the list will always be empty.

New in version 3.8.

Gtk.Settings.props.gtk_recent_files_limit¶

Name:	`gtk-recent-files-limit`
Type:	`int`
Default Value:	`50`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

The number of recently used files that should be displayed by default by Gtk.RecentChooser implementations and by the Gtk.FileChooser. A value of -1 means every recently used file stored.

New in version 2.12.

Deprecated since version 3.10: This setting is ignored

Gtk.Settings.props.gtk_recent_files_max_age¶

Name:	`gtk-recent-files-max-age`
Type:	`int`
Default Value:	`30`
Flags:	`READABLE`, `WRITABLE`

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.

New in version 2.14.

Gtk.Settings.props.gtk_scrolled_window_placement¶

Name:	`gtk-scrolled-window-placement`
Type:	`Gtk.CornerType`
Default Value:	`Gtk.CornerType.TOP_LEFT`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Where the contents of scrolled windows are located with respect to the scrollbars, if not overridden by the scrolled window’s own placement.

New in version 2.10.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_shell_shows_app_menu¶

Name:	`gtk-shell-shows-app-menu`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

Set to True if the desktop environment is displaying the app menu, False if the app should display it itself.

Gtk.Settings.props.gtk_shell_shows_desktop¶

Name:	`gtk-shell-shows-desktop`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Set to True if the desktop environment is displaying the desktop folder, False if not.

Gtk.Settings.props.gtk_shell_shows_menubar¶

Name:	`gtk-shell-shows-menubar`
Type:	`bool`
Default Value:	`False`
Flags:	`READABLE`, `WRITABLE`

Set to True if the desktop environment is displaying the menubar, False if the app should display it itself.

Gtk.Settings.props.gtk_show_input_method_menu¶

Name:	`gtk-show-input-method-menu`
Type:	`bool`
Default Value:	`False`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Whether the context menus of entries and text views should offer to change the input method

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_show_unicode_menu¶

Name:	`gtk-show-unicode-menu`
Type:	`bool`
Default Value:	`False`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Whether the context menus of entries and text views should offer to insert control characters

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_sound_theme_name¶

Name:	`gtk-sound-theme-name`
Type:	`str`
Default Value:	`'freedesktop'`
Flags:	`READABLE`, `WRITABLE`

The XDG sound theme to use for event sounds.

See the Sound Theme Specifications 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.

New in version 2.14.

Gtk.Settings.props.gtk_split_cursor¶

Name:	`gtk-split-cursor`
Type:	`bool`
Default Value:	`True`
Flags:	`READABLE`, `WRITABLE`

Whether two cursors should be displayed for mixed left-to-right and right-to-left text

Gtk.Settings.props.gtk_theme_name¶

Name:	`gtk-theme-name`
Type:	`str`
Default Value:	`'Adwaita'`
Flags:	`READABLE`, `WRITABLE`

Name of theme to load

Gtk.Settings.props.gtk_timeout_expand¶

Name:	`gtk-timeout-expand`
Type:	`int`
Default Value:	`500`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Expand value for timeouts, when a widget is expanding a new region

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_timeout_initial¶

Name:	`gtk-timeout-initial`
Type:	`int`
Default Value:	`500`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Starting value for timeouts, when button is pressed

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_timeout_repeat¶

Name:	`gtk-timeout-repeat`
Type:	`int`
Default Value:	`50`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Repeat value for timeouts, when button is pressed

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_titlebar_double_click¶

Name:	`gtk-titlebar-double-click`
Type:	`str`
Default Value:	`'toggle-maximize'`
Flags:	`READABLE`, `WRITABLE`

This setting determines the action to take when a double-click occurs on the titlebar of client-side decorated windows.

Recognized actions are minimize, toggle-maximize, menu, lower or none.

New in version 3.14.

Gtk.Settings.props.gtk_titlebar_middle_click¶

Name:	`gtk-titlebar-middle-click`
Type:	`str`
Default Value:	`'none'`
Flags:	`READABLE`, `WRITABLE`

This setting determines the action to take when a middle-click occurs on the titlebar of client-side decorated windows.

Recognized actions are minimize, toggle-maximize, menu, lower or none.

New in version 3.14.

Gtk.Settings.props.gtk_titlebar_right_click¶

Name:	`gtk-titlebar-right-click`
Type:	`str`
Default Value:	`'menu'`
Flags:	`READABLE`, `WRITABLE`

This setting determines the action to take when a right-click occurs on the titlebar of client-side decorated windows.

Recognized actions are minimize, toggle-maximize, menu, lower or none.

New in version 3.14.

Gtk.Settings.props.gtk_toolbar_icon_size¶

Name:	`gtk-toolbar-icon-size`
Type:	`Gtk.IconSize`
Default Value:	`Gtk.IconSize.LARGE_TOOLBAR`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

The size of icons in default toolbars.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_toolbar_style¶

Name:	`gtk-toolbar-style`
Type:	`Gtk.ToolbarStyle`
Default Value:	`Gtk.ToolbarStyle.BOTH_HORIZ`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

The size of icons in default toolbars.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_tooltip_browse_mode_timeout¶

Name:	`gtk-tooltip-browse-mode-timeout`
Type:	`int`
Default Value:	`500`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Amount of time, in milliseconds, after which the browse mode will be disabled.

See Gtk.Settings :gtk-tooltip-browse-timeout for more information about browse mode.

New in version 2.12.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_tooltip_browse_timeout¶

Name:	`gtk-tooltip-browse-timeout`
Type:	`int`
Default Value:	`60`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

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 Gtk.Settings :gtk-tooltip-browse-mode-timeout), it will take the amount of milliseconds specified by this setting to popup the tooltip for the new object.

New in version 2.12.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_tooltip_timeout¶

Name:	`gtk-tooltip-timeout`
Type:	`int`
Default Value:	`500`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Time, in milliseconds, after which a tooltip could appear if the cursor is hovering on top of a widget.

New in version 2.12.

Deprecated since version 3.10: This setting is ignored.

Gtk.Settings.props.gtk_touchscreen_mode¶

Name:	`gtk-touchscreen-mode`
Type:	`bool`
Default Value:	`False`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

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.

New in version 2.10.

Deprecated since version 3.4.: Generally, the behavior for touchscreen input should be performed dynamically based on Gdk.Event.get_source_device().

Gtk.Settings.props.gtk_visible_focus¶

Name:	`gtk-visible-focus`
Type:	`Gtk.PolicyType`
Default Value:	`Gtk.PolicyType.AUTOMATIC`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Whether ‘focus rectangles’ should be always visible, never visible, or hidden until the user starts to use the keyboard.

New in version 3.2.

Deprecated since version 3.10: This setting is ignored

Gtk.Settings.props.gtk_xft_antialias¶

Name:	`gtk-xft-antialias`
Type:	`int`
Default Value:	`-1`
Flags:	`READABLE`, `WRITABLE`

Whether to antialias Xft fonts; 0=no, 1=yes, -1=default

Gtk.Settings.props.gtk_xft_dpi¶

Name:	`gtk-xft-dpi`
Type:	`int`
Default Value:	`-1`
Flags:	`READABLE`, `WRITABLE`

Resolution for Xft, in 1024 * dots/inch. -1 to use default value

Gtk.Settings.props.gtk_xft_hinting¶

Name:	`gtk-xft-hinting`
Type:	`int`
Default Value:	`-1`
Flags:	`READABLE`, `WRITABLE`

Whether to hint Xft fonts; 0=no, 1=yes, -1=default

Gtk.Settings.props.gtk_xft_hintstyle¶

Name:	`gtk-xft-hintstyle`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

What degree of hinting to use; hintnone, hintslight, hintmedium, or hintfull

Gtk.Settings.props.gtk_xft_rgba¶

Name:	`gtk-xft-rgba`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

Type of subpixel antialiasing; none, rgb, bgr, vrgb, vbgr