since: 2.4

Declaration [src]

gtk_icon_theme_lookup_icon (
  GtkIconTheme* icon_theme,
  const gchar* icon_name,
  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.)

When rendering on displays with high pixel densities you should not use a size multiplied by the scaling factor returned by functions like gdk_window_get_scale_factor(). Instead, you should use gtk_icon_theme_lookup_icon_for_scale(), as the assets loaded for a given scaling factor may be different.

Available since: 2.4



Type: const gchar*

The name of the icon to lookup.

The data is owned by the caller of the method.
The value 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.