Method
GtkWidgetrender_icon_pixbuf
deprecated: 3.10 since: 3.0
Declaration [src]
GdkPixbuf*
gtk_widget_render_icon_pixbuf (
GtkWidget* widget,
const gchar* stock_id,
GtkIconSize size
)
Description [src]
A convenience function that uses the theme engine and style
settings for widget
to look up stock_id
and render it to
a pixbuf. stock_id
should be a stock icon ID such as
GTK_STOCK_OPEN or #GTK_STOCK_OK. size
should be a size
such as #GTK_ICON_SIZE_MENU.
The pixels in the returned GdkPixbuf
are shared with the rest of
the application and should not be modified. The pixbuf should be freed
after use with g_object_unref().
Available since: 3.0
Deprecated since: 3.10
Use gtk_icon_theme_load_icon()
instead.
Parameters
stock_id
-
Type:
const gchar*
A stock ID.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. size
-
Type:
GtkIconSize
A stock size (
GtkIconSize
). 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).
Return value
Type: GdkPixbuf
A new pixbuf, or NULL
if the
stock ID wasn’t known.
The caller of the method takes ownership of the returned data, and is responsible for freeing it. |
The return value can be NULL . |