gtk:icon-theme-load-icon (theme name size flags)

theme -- a gtk:icon-theme object
name -- a string with the name of the icon to lookup
size -- an integer with the desired icon size, the resulting icon may not be exactly this size
flags -- a gtk:icon-lookup-flags value modifying the behavior of the icon lookup

The rendered icon as a gdk-pixbuf:pixbuf object.

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 the gtk:icon-theme-lookup-icon function followed by the gtk:icon-info-load-icon function.

Note that you probably want to listen for icon theme changes and update the icon. This is usually done by connecting to the "style-updated" signal. If for some reason you do not want to update the icon when the icon theme changes, you should consider using the gdk-pixbuf:pixbuf-copy function 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.