a newly created icon or a new reference to an internal icon, so you must not modify the icon. Use [gobject.object.ObjectWrap.unref] to release your reference to the icon. null if the icon isn’t found.
IconTheme.loadIconForScale
gdkpixbuf.pixbuf.Pixbuf loadIconForScale(string iconName, int size, int scale, gtk.types.IconLookupFlags flags)Looks up an icon in an icon theme for a particular window scale, 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.icon_theme.IconTheme.lookupIcon] followed by [gtk.icon_info.IconInfo.loadIcon].
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.pixbuf.Pixbuf.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
iconName | the name of the icon to lookup |
size | the desired icon size. The resulting icon may not be exactly this size; see [gtk.icon_info.IconInfo.loadIcon]. |
scale | desired scale |
flags | flags modifying the behavior of the icon lookup |
Returns
the rendered icon; this may be
Throws
[ErrorWrap]