Method

GtkIconThemechoose_icon

since: 2.12

Declaration [src]

GtkIconInfo*
gtk_icon_theme_choose_icon (
  GtkIconTheme* icon_theme,
  const gchar** icon_names,
  gint size,
  GtkIconLookupFlags flags
)

Description [src]

Looks up a named icon and returns a GtkIconInfo containing information such as the filename of the icon. The icon can then be rendered into a pixbuf using gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() combines these two steps if all you need is the pixbuf.)

If icon_names contains more than one name, this function tries them all in the given order before falling back to inherited icon themes.

Available since: 2.12

Parameters

icon_names

Type: An array of gchar*

NULL-terminated array of icon names to lookup.

The array must be NULL-terminated.

The data is owned by the caller of the method.

Each element is a NUL terminated UTF-8 string.

size

Type: gint

Desired icon size.

flags

Type: GtkIconLookupFlags

Flags modifying the behavior of the icon lookup.

Return value

Type: GtkIconInfo

A GtkIconInfo object containing information about the icon, or NULL if the icon wasn’t found.

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

The return value can be NULL.