GtkSettings

描述 [src]

final class Gtk.Settings : GObject.Object
  implements Gtk.StyleProvider {
  /* No available fields */
}

GtkSettings 提供一种机制来对应用程序之间的全局设置进行共享。

在 X 窗口系统上,这种共享通过 XSettings 管理器实现,该管理器通常是桌面环境的一部分,并伴有允许用户更改这些设置的实用程序。

在 Wayland 上,这些设置通过设置门户获取,或者通过从 GSettings 读取桌面设置获取。

在 macOS 上,这些设置从 NSUserDefaults 获取。

在缺少这些共享机制的情况下,GTK/etc/gtk-4.0$XDG_CONFIG_DIRS/gtk-4.0$XDG_CONFIG_HOME/gtk-4.0 中的 settings.ini 文件读取设置的默认值。这些文件必须是有效的密钥文件(请参见 GKeyFile),并且具有名为 Settings 的章节。主题还可以通过在 gtk.css 文件旁边安装 settings.ini 文件来提供设置的默认值。

应用程序可以通过使用 g_object_set() 设置 GtkSettings 对象的属性来覆盖系统范围的设置。但这应该仅限于特殊情况中;GtkSettings 不作为应用程序配置工具。

每个显示器都有一个 GtkSettings 实例。它可以通过 gtk_settings_get_for_display() 获得,但在许多情况下,使用 gtk_widget_get_settings() 更方便。

层次结构

hierarchy this GtkSettings implements_0 GtkStyleProvider this--implements_0 ancestor_0 GObject ancestor_0--this

父级

函数

gtk_settings_get_default

获取默认显示器的 GtkSettings 对象,必要时创建它。

gtk_settings_get_for_display

获取 display 的 GtkSettings 对象,必要时创建它。

实例方法

gtk_settings_reset_property

撤销调用 g_object_set() 来为设置安装特定于应用程序的值的 效果。

GObject (43) 继承的方法

请查看GObject,以获取方法的完整列表。

属性

Gtk.Settings:gtk-alternative-button-order

对话框中的按钮是否应使用备用按钮顺序。

Gtk.Settings:gtk-alternative-sort-arrows

控制已排序列表和树视图中排序指示符的方向。

Gtk.Settings:gtk-application-prefer-dark-theme

该应用程序是否倾向于使用深色主题。

Gtk.Settings:gtk-cursor-aspect-ratio

文本光标的纵横比。

Gtk.Settings:gtk-cursor-blink

光标是否应该闪烁。

Gtk.Settings:gtk-cursor-blink-time

光标闪烁周期的长度,以毫秒为单位。

Gtk.Settings:gtk-cursor-blink-timeout

光标停止闪烁后经过时间,以秒为单位。

Gtk.Settings:gtk-cursor-theme-name

要使用的光标主题的名称。

Gtk.Settings:gtk-cursor-theme-size

要用于光标的大小。

Gtk.Settings:gtk-decoration-layout

确定哪些按钮应该放在客户端装饰的窗口标题栏中,以及它们应该放在左边还是右边。

Gtk.Settings:gtk-dialogs-use-header

内置的 GTK 对话框(例如文件选择器、颜色选择器或字体选择器)是否将在顶部使用标题栏显示操作工具,还是在底部使用操作区域。

Gtk.Settings:gtk-dnd-drag-threshold

光标可以移动的像素数,然后才开始拖动。

Gtk.Settings:gtk-double-click-distance

两次单击之间允许的最大距离(以像素为单位),才能被视为双击。

Gtk.Settings:gtk-double-click-time

两次单击之间允许的最大时间(以毫秒为单位),才能被视为双击。

Gtk.Settings:gtk-enable-accels

菜单项是否应具有可见的可激活加速键。

Gtk.Settings:gtk-enable-animations

是否启用工具包范围的动画。

Gtk.Settings:gtk-enable-event-sounds

是否播放任何事件声音。

Gtk.Settings:gtk-enable-input-feedback-sounds

是否播放事件声音作为用户输入的反馈。

Gtk.Settings:gtk-enable-primary-paste

是否应在鼠标中键单击时将“PRIMARY”剪贴板内容粘贴到光标位置。

Gtk.Settings:gtk-entry-password-hint-timeout

在隐藏的条目中显示最后输入字符的时间长度。

Gtk.Settings:gtk-entry-select-on-focus

是否在光标聚焦到输入框时选择输入框的内容。

Gtk.Settings:gtk-error-bell

当设置为 TRUE 时,键盘导航和其他与输入相关的错误将导致发出一声蜂鸣音。

Gtk.Settings:gtk-font-name

要使用的默认字体。

Gtk.Settings:gtk-font-rendering

如何设置 GTK 的字体渲染。

since: 4.16

Gtk.Settings:gtk-fontconfig-timestamp

当前字体配置的时间戳。

Gtk.Settings:gtk-hint-font-metrics

是否应将模糊应用于字体指标。

since: 4.6

Gtk.Settings:gtk-icon-theme-name

要使用的图标主题的名称。

Gtk.Settings:gtk-im-module

默认情况下应使用哪个 IM(输入法)模块。

Gtk.Settings:gtk-keynav-use-caret

无论文本是否可编辑,是否应确保可以光标浏览文本。

Gtk.Settings:gtk-label-select-on-focus

是否在光标聚焦到可选择标签时选择标签的内容。

Gtk.Settings:gtk-long-press-time

按钮或触摸按压被视为“长按”所需的时间。

Gtk.Settings:gtk-overlay-scrolling

滚动窗口是否可以使用覆盖的滚动指示器。

Gtk.Settings:gtk-primary-button-warps-slider

如果此设置的值为 TRUE,则单击 GtkRange 槽中的主按钮将移动滑块,从而将范围的值设置为您所单击的点。

Gtk.Settings:gtk-print-backends

打印对话框中要使用的打印后端的分隔符列表。

Gtk.Settings:gtk-print-preview-command

用于显示打印预览的命令。

Gtk.Settings:gtk-recent-files-enabled

是否应由 GTK 跟踪最近使用的资源列表中的项目。

Gtk.Settings:gtk-recent-files-max-age

最近使用的资源列表中项目的最大年龄(以天为单位)。

Gtk.Settings:gtk-shell-shows-app-menu

如果桌面环境显示应用程序菜单,则设为 TRUE;如果应用程序应自行显示应用程序菜单,则设为 FALSE

Gtk.Settings:gtk-shell-shows-desktop

如果桌面环境显示桌面文件夹,则设为 TRUE;如果没有,则设为 FALSE

Gtk.Settings:gtk-shell-shows-menubar

如果桌面环境显示菜单栏,则设置为 TRUE,如果应用程序应该自己显示,则设置为 FALSE

Gtk.Settings:gtk-show-status-shapes

当为 TRUE 时,开关等小部件包括形状以指示其开/关状态。

since: 4.14

Gtk.Settings:gtk-sound-theme-name

用于事件声音的 XDG 声音主题。

Gtk.Settings:gtk-split-cursor

是否应为混合的从左至右文本和从右至左文本显示两个光标。

Gtk.Settings:gtk-theme-name

要加载的主题的名称。

Gtk.Settings:gtk-titlebar-double-click

确定当客户端侧装饰窗口的标题栏上发生双击时执行的操作。

Gtk.Settings:gtk-titlebar-middle-click

确定当客户端侧装饰窗口的标题栏上发生中键单击时执行的操作。

Gtk.Settings:gtk-titlebar-right-click

确定当客户端侧装饰窗口的标题栏上发生右键单击时执行的操作。

Gtk.Settings:gtk-xft-antialias

是否对字体进行抗锯齿。

Gtk.Settings:gtk-xft-dpi

字体分辨率,单位为 1024 * 英寸/点。

Gtk.Settings:gtk-xft-hinting

是否启用字体提示。

Gtk.Settings:gtk-xft-hintstyle

要使用的字体提示的程度。

Gtk.Settings:gtk-xft-rgba

要使用的子像素抗锯齿的类型。

信号

GObject (1) 继承的信号
GObject::notify

当对象的某个属性通过 g_object_set_property()、g_object_set() 等等将其值设为某值时,就会发出 notify 信号。