GtkStyleProvider: GTK+ 3 Reference Manual

GtkStyleProvider

GtkStyleProvider — Interface to provide style information to GtkStyleContext

Functions

GtkIconFactory *	gtk_style_provider_get_icon_factory ()
GtkStyleProperties *	gtk_style_provider_get_style ()
gboolean	gtk_style_provider_get_style_property ()

Types and Values

struct	GtkStyleProviderIface
	GtkStyleProvider
#define	GTK_STYLE_PROVIDER_PRIORITY_FALLBACK
#define	GTK_STYLE_PROVIDER_PRIORITY_THEME
#define	GTK_STYLE_PROVIDER_PRIORITY_SETTINGS
#define	GTK_STYLE_PROVIDER_PRIORITY_APPLICATION
#define	GTK_STYLE_PROVIDER_PRIORITY_USER

Object Hierarchy

    GInterface
    ╰── GtkStyleProvider

Known Implementations

GtkStyleProvider is implemented by GtkCssProvider and GtkSettings.

Includes

#include <gtk/gtk.h>

Description

GtkStyleProvider is an interface used to provide style information to a GtkStyleContext. See gtk_style_context_add_provider() and gtk_style_context_add_provider_for_screen().

Functions

gtk_style_provider_get_icon_factory ()

GtkIconFactory *
gtk_style_provider_get_icon_factory (GtkStyleProvider *provider,
                                     GtkWidgetPath *path);

gtk_style_provider_get_icon_factory has been deprecated since version 3.8 and should not be used in newly-written code.

Will always return NULL for all GTK-provided style providers.

Returns the GtkIconFactory defined to be in use for path , or NULL if none is defined.

Parameters

provider	a GtkStyleProvider
path	GtkWidgetPath to query

Returns

The icon factory to use for path , or NULL.

[nullable][transfer none]

Since: 3.0

gtk_style_provider_get_style ()

GtkStyleProperties *
gtk_style_provider_get_style (GtkStyleProvider *provider,
                              GtkWidgetPath *path);

gtk_style_provider_get_style has been deprecated since version 3.8 and should not be used in newly-written code.

Will always return NULL for all GTK-provided style providers as the interface cannot correctly work the way CSS is specified.

Returns the style settings affecting a widget defined by path , or NULL if provider doesn’t contemplate styling path .

Parameters

provider	a GtkStyleProvider
path	GtkWidgetPath to query

Returns

a GtkStyleProperties containing the style settings affecting path .

[nullable][transfer full]

Since: 3.0

gtk_style_provider_get_style_property ()

gboolean
gtk_style_provider_get_style_property (GtkStyleProvider *provider,
                                       GtkWidgetPath *path,
                                       GtkStateFlags state,
                                       GParamSpec *pspec,
                                       GValue *value);

Looks up a widget style property as defined by provider for the widget represented by path .

Parameters

provider	a GtkStyleProvider
path	GtkWidgetPath to query
state	state to query the style property for
pspec	The GParamSpec to query
value	return location for the property value.	[out]

Returns

TRUE if the property was found and has a value, FALSE otherwise

Since: 3.0