load_surface

Description:

[ Version ( since = "3.10" ) ]
public Surface? load_surface (string icon_name, int size, int scale, Window? for_window, IconLookupFlags flags) throws Error

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 lookup_icon followed by load_surface.

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.

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.
scale	desired scale
for_window	Window to optimize drawing for, or null
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 cairo_surface_destroy to release your reference to the icon. null if the icon isn’t found.