ctk_css_provider_get_default ()

CtkCssProvider *
ctk_css_provider_get_default (void);

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

ctk_css_provider_get_named ()

CtkCssProvider *
ctk_css_provider_get_named (const gchar *name,
                            const gchar *variant);

Loads a theme from the usual theme paths

ctk_css_provider_load_from_data ()

gboolean
ctk_css_provider_load_from_data (CtkCssProvider *css_provider,
                                 const gchar *data,
                                 gssize length,
                                 GError **error);

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

ctk_css_provider_load_from_file ()

gboolean
ctk_css_provider_load_from_file (CtkCssProvider *css_provider,
                                 GFile *file,
                                 GError **error);

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

ctk_css_provider_load_from_path ()

gboolean
ctk_css_provider_load_from_path (CtkCssProvider *css_provider,
                                 const gchar *path,
                                 GError **error);

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

ctk_css_provider_load_from_resource ()

void
ctk_css_provider_load_from_resource (CtkCssProvider *css_provider,
                                     const gchar *resource_path);

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

To track errors while loading CSS, connect to the “parsing-error” signal.

Since: 3.16

ctk_css_provider_new ()

CtkCssProvider *
ctk_css_provider_new (void);

Returns a newly created CtkCssProvider.

ctk_css_provider_to_string ()

char *
ctk_css_provider_to_string (CtkCssProvider *provider);

Converts the provider into a string representation in CSS format.

Using ctk_css_provider_load_from_data() with the return value from this function on a new provider created with ctk_css_provider_new() will basically create a duplicate of this provider .

Since: 3.2

ctk_css_section_get_end_line ()

guint
ctk_css_section_get_end_line (const CtkCssSection *section);

Returns the line in the CSS document where this section end. The line number is 0-indexed, so the first line of the document will return 0. This value may change in future invocations of this function if section is not yet parsed completely. This will for example happen in the CtkCssProvider::parsing-error signal. The end position and line may be identical to the start position and line for sections which failed to parse anything successfully.

Since: 3.2

ctk_css_section_get_end_position ()

guint
ctk_css_section_get_end_position (const CtkCssSection *section);

Returns the offset in bytes from the start of the current line returned via ctk_css_section_get_end_line(). This value may change in future invocations of this function if section is not yet parsed completely. This will for example happen in the CtkCssProvider::parsing-error signal. The end position and line may be identical to the start position and line for sections which failed to parse anything successfully.

Since: 3.2

ctk_css_section_get_file ()

GFile *
ctk_css_section_get_file (const CtkCssSection *section);

Gets the file that section was parsed from. If no such file exists, for example because the CSS was loaded via ctk_css_provider_load_from_data() , then NULL is returned.

Since: 3.2

ctk_css_section_get_parent ()

CtkCssSection *
ctk_css_section_get_parent (const CtkCssSection *section);

Gets the parent section for the given section . The parent section is the section that contains this section . A special case are sections of type CTK_CSS_SECTION_DOCUMENT. Their parent will either be NULL if they are the original CSS document that was loaded by ctk_css_provider_load_from_file() or a section of type CTK_CSS_SECTION_IMPORT if it was loaded with an import rule from a different file.

Since: 3.2

ctk_css_section_get_section_type ()

CtkCssSectionType
ctk_css_section_get_section_type (const CtkCssSection *section);

Gets the type of information that section describes.

Since: 3.2

ctk_css_section_get_start_line ()

guint
ctk_css_section_get_start_line (const CtkCssSection *section);

Returns the line in the CSS document where this section starts. The line number is 0-indexed, so the first line of the document will return 0.

Since: 3.2

ctk_css_section_get_start_position ()

guint
ctk_css_section_get_start_position (const CtkCssSection *section);

Returns the offset in bytes from the start of the current line returned via ctk_css_section_get_start_line().

Since: 3.2

ctk_css_section_ref ()

CtkCssSection *
ctk_css_section_ref (CtkCssSection *section);

Increments the reference count on section .

Since: 3.2

ctk_css_section_unref ()

void
ctk_css_section_unref (CtkCssSection *section);

Decrements the reference count on section , freeing the structure if the reference count reaches 0.

Since: 3.2

struct CtkCssProvider

struct CtkCssProvider;

CTK_CSS_PROVIDER_ERROR

#define CTK_CSS_PROVIDER_ERROR (ctk_css_provider_error_quark ())

Domain for CtkCssProvider errors.

enum CtkCssProviderError

Error codes for CTK_CSS_PROVIDER_ERROR.

CtkCssSection

typedef struct _CtkCssSection CtkCssSection;

Defines a part of a CSS document. Because sections are nested into one another, you can use ctk_css_section_get_parent() to get the containing region.

Since: 3.2

enum CtkCssSectionType

The different types of sections indicate parts of a CSS document as parsed by CTK’s CSS parser. They are oriented towards the CSS Grammar, but may contain extensions.

More types might be added in the future as the parser incorporates more features.

Since: 3.2

The “parsing-error” signal

void
user_function (CtkCssProvider *provider,
               CtkCssSection  *section,
               GError         *error,
               gpointer        user_data)

Signals that a parsing error occurred. the path , line and position describe the actual location of the error as accurately as possible.

Parsing errors are never fatal, so the parsing will resume after the error. Errors may however cause parts of the given data or even all of it to not be parsed at all. So it is a useful idea to check that the parsing succeeds by connecting to this signal.

Note that this signal may be emitted at any time as the css provider may opt to defer parsing parts or all of the input to a later time than when a loading function was called.

Flags: Run Last