Function

Gtkrc_get_style_by_paths

Declaration [src]

GtkStyle*
gtk_rc_get_style_by_paths (
  GtkSettings* settings,
  const char* widget_path,
  const char* class_path,
  GType type
)

Description [src]

Creates up a GtkStyle from styles defined in a RC file by providing the raw components used in matching. This function may be useful when creating pseudo-widgets that should be themed like widgets but don’t actually have corresponding GTK+ widgets. An example of this would be items inside a GNOME canvas widget.

The action of gtk_rc_get_style() is similar to:

 gtk_widget_path (widget, NULL, &path, NULL);
 gtk_widget_class_path (widget, NULL, &class_path, NULL);
 gtk_rc_get_style_by_paths (gtk_widget_get_settings (widget),
                            path, class_path,
                            G_OBJECT_TYPE (widget));

Deprecated since:	3.0
Use `GtkStyleContext` instead.

Parameters

`settings`	`GtkSettings`
	A `GtkSettings` object.
	The data is owned by the caller of the function.
`widget_path`	`const char*`
	The widget path to use when looking up the style, or `NULL` if no matching against the widget path should be done.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`class_path`	`const char*`
	The class path to use when looking up the style, or `NULL` if no matching against the class path should be done.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`type`	`GType`
	A type that will be used along with parent types of this type when matching against class styles, or #G_TYPE_NONE.

Return value

Returns:	`GtkStyle`
	A style created by matching with the supplied paths, or `NULL` if nothing matching was specified and the default style should be used. The returned value is owned by GTK+ as part of an internal cache, so you must call `g_object_ref()` on the returned value if you want to keep a reference to it.
	The data is owned by the called function.
	The return value can be `NULL`.