load_icon
Description:
public Pixbuf? load_icon (string icon_name, int size, IconLookupFlags flags) throws Error
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 lookup_icon followed by 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:
GtkIconTheme:style-set
signal. If for some reason you do not want to update the icon when the icon theme changes, you should consider
using 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:
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. |
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 unref to release your reference to the icon. null if the icon isn’t found. |