load_surface
Description:
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 | |
| 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 |