a newly created icon or a new reference to an internal icon, so you must not modify the icon. Use [cairo.surface.Surface.destroy] to release your reference to the icon. null if the icon isn’t found.
IconTheme.loadSurface
cairo.surface.Surface loadSurface(string iconName, int size, int scale, gdk.window.Window forWindow, 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 cairo surface. 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.loadSurface].
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.
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 |
forWindow | #GdkWindow to optimize drawing for, or null |
flags | flags modifying the behavior of the icon lookup |
Returns
the rendered icon; this may be
Throws
[ErrorWrap]