Struct gtk4::Settings

source ·

#[repr(transparent)]
pub struct Settings { /* private fields */ }

Expand description

Settings provides 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.

On Wayland, the settings are obtained either via a settings portal, or by reading desktop settings from DConf.

In the absence of these sharing mechanisms, GTK reads default values for settings from settings.ini files in /etc/gtk-4.0, $XDG_CONFIG_DIRS/gtk-4.0 and $XDG_CONFIG_HOME/gtk-4.0. These files must be valid key files (see GKeyFile), 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 Settings object with g_object_set(). This should be restricted to special cases though; Settings are not meant as an application configuration facility.

There is one Settings instance per display. It can be obtained with for_display(), but in many cases, it is more convenient to use WidgetExt::settings().

Struct gtk4::Settings

Implementations§

impl Settings

pub fn builder() -> SettingsBuilder

pub fn reset_property(&self, name: &str)

pub fn is_gtk_alternative_button_order(&self) -> bool

pub fn set_gtk_alternative_button_order( &self, gtk_alternative_button_order: bool )

pub fn is_gtk_alternative_sort_arrows(&self) -> bool

pub fn set_gtk_alternative_sort_arrows(&self, gtk_alternative_sort_arrows: bool)

pub fn is_gtk_application_prefer_dark_theme(&self) -> bool

pub fn set_gtk_application_prefer_dark_theme( &self, gtk_application_prefer_dark_theme: bool )

pub fn gtk_cursor_aspect_ratio(&self) -> f64

pub fn set_gtk_cursor_aspect_ratio(&self, gtk_cursor_aspect_ratio: f64)

pub fn is_gtk_cursor_blink(&self) -> bool

pub fn set_gtk_cursor_blink(&self, gtk_cursor_blink: bool)

pub fn gtk_cursor_blink_time(&self) -> i32

pub fn set_gtk_cursor_blink_time(&self, gtk_cursor_blink_time: i32)

pub fn gtk_cursor_blink_timeout(&self) -> i32

pub fn set_gtk_cursor_blink_timeout(&self, gtk_cursor_blink_timeout: i32)

pub fn gtk_cursor_theme_name(&self) -> Option<GString>

pub fn set_gtk_cursor_theme_name(&self, gtk_cursor_theme_name: Option<&str>)

pub fn gtk_cursor_theme_size(&self) -> i32

pub fn set_gtk_cursor_theme_size(&self, gtk_cursor_theme_size: i32)

pub fn gtk_decoration_layout(&self) -> Option<GString>

pub fn set_gtk_decoration_layout(&self, gtk_decoration_layout: Option<&str>)

pub fn is_gtk_dialogs_use_header(&self) -> bool

pub fn set_gtk_dialogs_use_header(&self, gtk_dialogs_use_header: bool)

pub fn gtk_dnd_drag_threshold(&self) -> i32

pub fn set_gtk_dnd_drag_threshold(&self, gtk_dnd_drag_threshold: i32)

pub fn gtk_double_click_distance(&self) -> i32

pub fn set_gtk_double_click_distance(&self, gtk_double_click_distance: i32)

pub fn gtk_double_click_time(&self) -> i32

pub fn set_gtk_double_click_time(&self, gtk_double_click_time: i32)

pub fn is_gtk_enable_accels(&self) -> bool

pub fn set_gtk_enable_accels(&self, gtk_enable_accels: bool)

pub fn is_gtk_enable_animations(&self) -> bool

pub fn set_gtk_enable_animations(&self, gtk_enable_animations: bool)

pub fn is_gtk_enable_event_sounds(&self) -> bool

pub fn set_gtk_enable_event_sounds(&self, gtk_enable_event_sounds: bool)

pub fn is_gtk_enable_input_feedback_sounds(&self) -> bool

pub fn set_gtk_enable_input_feedback_sounds( &self, gtk_enable_input_feedback_sounds: bool )

pub fn is_gtk_enable_primary_paste(&self) -> bool

pub fn set_gtk_enable_primary_paste(&self, gtk_enable_primary_paste: bool)

pub fn gtk_entry_password_hint_timeout(&self) -> u32

pub fn set_gtk_entry_password_hint_timeout( &self, gtk_entry_password_hint_timeout: u32 )

pub fn is_gtk_entry_select_on_focus(&self) -> bool

pub fn set_gtk_entry_select_on_focus(&self, gtk_entry_select_on_focus: bool)

pub fn is_gtk_error_bell(&self) -> bool

pub fn set_gtk_error_bell(&self, gtk_error_bell: bool)

pub fn gtk_font_name(&self) -> Option<GString>

pub fn set_gtk_font_name(&self, gtk_font_name: Option<&str>)

pub fn gtk_fontconfig_timestamp(&self) -> u32

pub fn set_gtk_fontconfig_timestamp(&self, gtk_fontconfig_timestamp: u32)

pub fn is_gtk_hint_font_metrics(&self) -> bool

pub fn set_gtk_hint_font_metrics(&self, gtk_hint_font_metrics: bool)

pub fn gtk_icon_theme_name(&self) -> Option<GString>

pub fn set_gtk_icon_theme_name(&self, gtk_icon_theme_name: Option<&str>)

pub fn gtk_im_module(&self) -> Option<GString>

pub fn set_gtk_im_module(&self, gtk_im_module: Option<&str>)

pub fn is_gtk_keynav_use_caret(&self) -> bool

pub fn set_gtk_keynav_use_caret(&self, gtk_keynav_use_caret: bool)

pub fn is_gtk_label_select_on_focus(&self) -> bool

pub fn set_gtk_label_select_on_focus(&self, gtk_label_select_on_focus: bool)

pub fn gtk_long_press_time(&self) -> u32

pub fn set_gtk_long_press_time(&self, gtk_long_press_time: u32)

pub fn is_gtk_overlay_scrolling(&self) -> bool

pub fn set_gtk_overlay_scrolling(&self, gtk_overlay_scrolling: bool)

pub fn is_gtk_primary_button_warps_slider(&self) -> bool

pub fn set_gtk_primary_button_warps_slider( &self, gtk_primary_button_warps_slider: bool )

pub fn gtk_print_backends(&self) -> Option<GString>

pub fn set_gtk_print_backends(&self, gtk_print_backends: Option<&str>)

pub fn gtk_print_preview_command(&self) -> Option<GString>

pub fn set_gtk_print_preview_command( &self, gtk_print_preview_command: Option<&str> )

pub fn is_gtk_recent_files_enabled(&self) -> bool

pub fn set_gtk_recent_files_enabled(&self, gtk_recent_files_enabled: bool)

pub fn gtk_recent_files_max_age(&self) -> i32

pub fn set_gtk_recent_files_max_age(&self, gtk_recent_files_max_age: i32)

pub fn is_gtk_shell_shows_app_menu(&self) -> bool

pub fn set_gtk_shell_shows_app_menu(&self, gtk_shell_shows_app_menu: bool)

pub fn is_gtk_shell_shows_desktop(&self) -> bool