Class
Gtk.CssProvider
Description [src]
final class Gtk.CssProvider : GObject.Object {
parent_instance: GObject
}
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
gtk_css_provider_load_from_file()
or
gtk_css_provider_load_from_resource()
and adding the provider with gtk_style_context_add_provider()
or
gtk_style_context_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
GtkSettings:gtk-theme-name
setting), VARIANT
is the
variant to load (see the
GtkSettings: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
GtkCssProvider::parsing-error
signal.
Constructors
gtk_css_provider_new
Returns a newly created GtkCssProvider
.
Instance methods
gtk_css_provider_load_from_data
Loads data
into css_provider
.
gtk_css_provider_load_from_file
Loads the data contained in file
into css_provider
.
gtk_css_provider_load_from_path
Loads the data contained in path
into css_provider
.
gtk_css_provider_load_from_resource
Loads the data contained in the resource at resource_path
into
the css_provider
.
gtk_css_provider_load_named
Loads a theme from the usual theme paths.
gtk_css_provider_to_string
Converts the provider
into a string representation in CSS format.
Signals
Gtk.CssProvider::parsing-error
Signals that a parsing error occurred.