Gtk.IconTheme.prototype.load_icon

function load_icon(icon_name:String, size:Number, flags:Gtk.IconLookupFlags):GdkPixbuf.Pixbuf {
    // Gjs wrapper for gtk_icon_theme_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 Gtk.lookup_icon followed by Gtk.IconInfo.prototype.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::style-set signal. If for some reason you do not want to update the icon when the icon theme changes, you should consider using GdkPixbuf.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.

Since 2.4

icon_name: the name of the icon to lookup
size: the desired icon size. The resulting icon may not be exactly this size; see Gtk.IconInfo.prototype.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 GObject.unref to release your reference to the icon. null if the icon isn't found.