gtk.css_provider

Module for CssProvider class

Types 3

gtk.css_provider.CssProvider is an object implementing the gtk.style_provider.StyleProvider 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.CssProvider.loadFromFile or gtk.css_provider.CssProvider.loadFromResource and adding the provider with gtk.style_context.StyleContext.addProvider or gtk.style_context.StyleContext.addProviderForDisplay.

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 gtk.settings.Settings.gtkThemeName setting), VARIANT is the variant to load (see the gtk.settings.Settings.gtkApplicationPreferDarkTheme 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 gtk.css_provider.CssProvider.parsingError signal.

Methods
GType _gType() @property
CssProvider self()Returns `this`, for use in `with` statements.
CssProviderGidBuilder builder()Get builder for [gtk.css_provider.CssProvider] Returns: New builder object
void loadFromBytes(glib.bytes.Bytes data)Loads data into css_provider.
void loadFromData(string data)Loads data into css_provider.
void loadFromFile(gio.file.File file)Loads the data contained in file into css_provider.
void loadFromPath(string path)Loads the data contained in path into css_provider.
void loadFromResource(string resourcePath)Loads the data contained in the resource at resource_path into the css_provider.
void loadFromString(string string_)Loads string into css_provider.
void loadNamed(string name, string variant = null)Loads a theme from the usual theme paths.
string toString_()Converts the provider into a string representation in CSS format.
gulong connectParsingError(T)(T callback, Flag!"After" after = No.After) if (isCallable!T && is(ReturnType!T == void) && (Parameters!T.length < 1 || (ParameterStorageClassTuple!T[0] == ParameterStorageClass.none && is(Parameters!T[0] == gtk.css_section.CssSection))) && (Parameters!T.length < 2 || (ParameterStorageClassTuple!T[1] == ParameterStorageClass.none && is(Parameters!T[1] == glib.error.ErrorWrap))) && (Parameters!T.length < 3 || (ParameterStorageClassTuple!T[2] == ParameterStorageClass.none && is(Parameters!T[2] : gtk.css_provider.CssProvider))) && Parameters!T.length < 4)Connect to `ParsingError` signal.
Constructors
this(void * ptr, Flag!"Take" take)
this()Returns a newly created [gtk.css_provider.CssProvider]. Returns: A new [gtk.css_provider.CssProvider]

Fluent builder for gtk.css_provider.CssProvider

Methods
CssProvider build()Create object from builder. Returns: New object