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

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.

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

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

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