Gtk.Settings

g GObject.GInterface GObject.GInterface Gtk.StyleProvider Gtk.StyleProvider GObject.GInterface->Gtk.StyleProvider GObject.Object GObject.Object Gtk.Settings Gtk.Settings GObject.Object->Gtk.Settings Gtk.StyleProvider->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-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-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:

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:

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:

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.

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.

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

Length of the cursor blink cycle, in milliseconds

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_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