Gtk.CssProvider – gtk4 – Vala Binding Reference

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 [[email protected]_from_file] or [ [email protected]_from_resource] and adding the provider with [[email protected]_provider] or [ [email protected]_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 [ [email protected]:gtk-theme-name] setting), `VARIANT` is the variant to load (see the [ [email protected]: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 [[email protected]:GtkCssProvider:parsing-error] signal.

Namespace: Gtk

Package: gtk4

Content:

Creation methods:

public CssProvider ()

Returns a newly created `GtkCssProvider`.

Methods:

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_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

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref

All known members inherited from interface Gtk.StyleProvider

gtk_private_changed