CssProvider

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_css_provider_get_type ()" ) ]
public class CssProvider : Object, StyleProvider

`GtkCssProvider` is an object implementing the `GtkStyleProvider` interface for CSS.

It is able to parse CSS-like input in order to style widgets.

An application can make GTK parse a specific CSS style sheet by calling [method@Gtk.CssProvider.load_from_file] or [ method@Gtk.CssProvider.load_from_resource] and adding the provider with [method@Gtk.StyleContext.add_provider] or [ func@Gtk.StyleContext.add_provider_for_display].

In addition, certain files will be read when GTK is initialized. First, the file `$XDG_CONFIG_HOME/gtk-4.0/gtk.css` is loaded if it exists. Then, GTK loads the first existing file among `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.css` and `DATADIR/share/themes/THEME/gtk-VERSION/gtk-VARIANT.css`, where `THEME` is the name of the current theme (see the [ property@Gtk.Settings:gtk-theme-name] setting), `VARIANT` is the variant to load (see the [ property@Gtk.Settings:gtk-application-prefer-dark-theme] setting), `DATADIR` is the prefix configured when GTK was compiled (unless overridden by the `GTK_DATA_PREFIX` environment variable), and `VERSION` is the GTK version number. If no file is found for the current version, GTK tries older versions all the way back to 4.0.

To track errors while loading CSS, connect to the [signal@Gtk.CssProvider:GtkCssProvider:parsing-error] signal.

Namespace: Gtk

Package: gtk4

Content:

Creation methods:

public CssProvider ()
Returns a newly created `GtkCssProvider`.

Methods:

public void load_from_bytes (Bytes data)
Loads data into this.
public void load_from_data (uint8[] data)
Loads data into this.
public void load_from_file (File file)
Loads the data contained in file into this.
public void load_from_path (string path)
Loads the data contained in path into this.
public void load_from_resource (string resource_path)
Loads the data contained in the resource at resource_path into the this.
public void load_from_string (string str)
Loads string into this.
public void load_named (string name, string? variant)
Loads a theme from the usual theme paths.
public string to_string ()
Converts the this into a string representation in CSS format.

Signals:

public signal void parsing_error (CssSection section, Error error)
Signals that a parsing error occurred.

Inherited Members:

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.StyleProvider

gtk_private_changed