GtkCssProvider

描述 [src]

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

GtkCssProvider 是一个实现 GtkStyleProvider 接口的对象,用于 CSS

它能够解析类似于 CSS 的输入,以设置窗口小部件的样式。

应用程序可以通过调用 gtk_css_provider_load_from_file()gtk_css_provider_load_from_resource() 解析特定的 CSS 样式表,然后使用 gtk_style_context_add_provider()gtk_style_context_add_provider_for_display() 添加提供者。

此外,在初始化 GTK 时,将会读取特定文件。首先,如果存在文件 $XDG_CONFIG_HOME/gtk-4.0/gtk.css,则加载该文件。然后,GTK 加载一组文件中第一个存在的文件,这些文件为 XDG_DATA_HOME/themes/THEME/gtk-VERSION/gtk-VARIANT.css$HOME/.themes/THEME/gtk-VERSION/gtk-VARIANT.css$XDG_DATA_DIRS/themes/THEME/gtk-VERSION/gtk-VARIANT.cssDATADIR/share/themes/THEME/gtk-VERSION/gtk-VARIANT.css,其中 THEME 是当前主题的名称(请参阅 GtkSettings:gtk-theme-name 设置),VARIANT 是要加载的变体(请参阅 GtkSettings:gtk-application-prefer-dark-theme 设置),DATADIR 是编译 GTK 时配置的前缀(除非被 GTK_DATA_PREFIX 环境变量覆盖),VERSIONGTK 版本号。如果没有针对当前版本找到文件,GTK 会一直尝试向后查找旧版本直到 4.0。

要跟踪加载 CSS 期间出现的错误,请连接到 GtkCssProvider::parsing-error 信号。

层次结构

hierarchy this GtkCssProvider implements_0 GtkStyleProvider this--implements_0 ancestor_0 GObject ancestor_0--this

祖先

构造函数

gtk_css_provider_new

返回新创建的 GtkCssProvider

实例方法

gtk_css_provider_load_from_bytes

data 加载到 css_provider

自版本:4.12

gtk_css_provider_load_from_data

data 加载到 css_provider

已弃用:4.12 

gtk_css_provider_load_from_file

将文件 file 中包含的数据加载到 css_provider

gtk_css_provider_load_from_path

path 中包含的数据加载到 css_provider

gtk_css_provider_load_from_resource

resource_path 中数据资源加载到 css_provider 中。

gtk_css_provider_load_from_string

string 加载到 css_provider 中。

自版本:4.12

gtk_css_provider_load_named

从通常的主题路径中加载主题。

gtk_css_provider_to_string

provider 转换为 CSS 格式的字符串表示形式。

GObject (43) 继承的方法

有关方法的完整列表,请参阅 GObject

信号

Gtk.CssProvider::parsing-error

信号指出发生了解析错误。

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

当对象的一个属性通过 g_object_set_property()、g_object_set() 等设置值时,将在该对象上发出 notify 信号。

类结构

struct GtkCssProviderClass {
  /* no available fields */
}

没有可用描述。