Gtk.CssProvider – gtk+-3.0 – Vala Binding Reference

Description:

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

GtkCssProvider is an object implementing the StyleProvider interface.

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 load_from_file or load_from_resource and adding the provider with add_provider or add_provider_for_screen.

In addition, certain files will be read when GTK+ is initialized. First, the file `$XDG_CONFIG_HOME/gtk-3.0/gtk.css` is loaded if it exists. Then, GTK+ loads the first existing file among `XDG_DATA_HOME/themes/THEME/gtk-VERSION/gtk.css`, `$HOME/.themes/THEME/gtk-VERSION/gtk.css`, `$XDG_DATA_DIRS/themes/THEME/gtk-VERSION/gtk.css` and `DATADIR/share/themes/THEME/gtk-VERSION/gtk.css`, where `THEME` is the name of the current theme (see the gtk_theme_name 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 3.0.

In the same way, GTK+ tries to load a gtk-keys.css file for the current key theme, as defined by gtk_key_theme_name.

Namespace: Gtk

Package: gtk+-3.0

Content:

Static methods:

public static unowned CssProvider get_default ()

Returns the provider containing the style settings used as a fallback for all widgets.

public static unowned CssProvider get_named (string name, string? variant)

Loads a theme from the usual theme paths

Creation methods:

public CssProvider ()

Returns a newly created CssProvider.

Methods:

public bool load_from_buffer (uint8[] data) throws Error

public bool load_from_data (string data, ssize_t length = -1) throws Error

Loads data into this, and by doing so clears any previously loaded information.

public bool load_from_file (File file) throws Error

Loads the data contained in file into this, making it clear any previously loaded information.

public bool load_from_path (string path) throws Error

Loads the data contained in path into this, making it clear any previously loaded information.

public void load_from_resource (string resource_path)

Loads the data contained in the resource at resource_path into the CssProvider, clearing any previously loaded information.

public string to_string ()

Converts the this into a string representation in CSS format.

Signals:

public virtual 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

get_icon_factory

get_style

get_style_property

CssProvider