since: 2.14

Declaration [src]

gtk_icon_theme_lookup_by_gicon (
  GtkIconTheme* icon_theme,
  GIcon* icon,
  gint size,
  GtkIconLookupFlags flags

Description [src]

Looks up an 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().

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_by_gicon_for_scale(), as the assets loaded for a given scaling factor may be different.

Available since: 2.14



Type: GIcon

The GIcon to look up.

The data is owned by the caller of the method.

Type: gint

Desired icon size.


Type: GtkIconLookupFlags

Flags modifying the behavior of the icon lookup.

Return value

Type: GtkIconInfo

A GtkIconInfo containing information about the icon, or NULL if the icon wasn’t found. Unref with g_object_unref().

The caller of the method takes ownership of the returned data, and is responsible for freeing it.
The return value can be NULL.