since: 2.12

Declaration [src]

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



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.

Type: gint

Desired icon size.


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.