load_icon

Looks up an icon in an icon theme, scales it to the given size and renders it into a pixbuf.

This is a convenience function; if more details about the icon are needed, use lookup_icon followed by load_icon.

Note that you probably want to listen for icon theme changes and update the icon. This is usually done by connecting to the GtkWidget: GtkIconTheme:style-set signal. If for some reason you do not want to update the icon when the icon theme changes, you should consider using copy to make a private copy of the pixbuf returned by this function. Otherwise GTK+ may need to keep the old icon theme loaded, which would be a waste of memory.

Parameters:

this	a IconTheme
icon_name	the name of the icon to lookup
size	the desired icon size. The resulting icon may not be exactly this size; see load_icon.
flags	flags modifying the behavior of the icon lookup

Returns:

the rendered icon; this may be a newly created icon or a new reference to an internal icon, so you must not modify the icon. Use unref to release your reference to the icon. null if the icon isn’t found.