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 string 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 string 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.