Method

GtkIconInfoload_symbolic_for_context

since: 3.0

Declaration [src]

GdkPixbuf*
gtk_icon_info_load_symbolic_for_context (
  GtkIconInfo* icon_info,
  GtkStyleContext* context,
  gboolean* was_symbolic,
  GError** error
)

Description [src]

Loads an icon, modifying it to match the system colors for the foreground, success, warning and error colors provided. If the icon is not a symbolic one, the function will return the result from gtk_icon_info_load_icon(). This function uses the regular foreground color and the symbolic colors with the names “success_color”, “warning_color” and “error_color” from the context.

This allows loading symbolic icons that will match the system theme.

See gtk_icon_info_load_symbolic() for more details.

Available since: 3.0

Parameters

context

Type: GtkStyleContext

A GtkStyleContext.

The data is owned by the caller of the method.

was_symbolic

Type: gboolean*

A #gboolean, returns whether the loaded icon was a symbolic one and whether the fg color was applied to it.

The argument will be set by the function.

The argument can be NULL.

error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.

If the return location is not NULL, then you must initialize it to a NULL GError*.

The argument will be left initialized to NULL by the method if there are no errors.

In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: GdkPixbuf

A GdkPixbuf representing the loaded icon.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.