render_icon


Description:

[ Version ( deprecated = true , deprecated_since = "3.0" ) ]
public Pixbuf? render_icon (string stock_id, IconSize size, string? detail)

Warning: render_icon is deprecated since "3.0".

A convenience function that uses the theme settings for this to look up stock_id and render it to a pixbuf.

Note:

Use render_icon_pixbuf instead.

stock_id should be a stock icon ID such as STOCK_OPEN or STOCK_OK. size should be a size such as MENU. detail should be a string that identifies the widget or code doing the rendering, so that theme engines can special-case rendering for that widget or code.

The pixels in the returned Pixbuf are shared with the rest of the application and should not be modified. The pixbuf should be freed after use with unref.

Parameters:

this

a Widget

stock_id

a stock ID

size

a stock size (IconSize). A size of `(GtkIconSize)-1` means render at the size of the source and don’t scale (if there are multiple source sizes, GTK+ picks one of the available sizes).

detail

render detail to pass to theme engine

Returns:

a new pixbuf, or null if the stock ID wasn’t known