Method
GtkWidgetrender_icon
deprecated: 3.0
Declaration [src]
GdkPixbuf*
gtk_widget_render_icon (
GtkWidget* widget,
const gchar* stock_id,
GtkIconSize size,
const gchar* detail
)
Description [src]
A convenience function that uses the theme 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. 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 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().
Deprecated since: 3.0
Use gtk_widget_render_icon_pixbuf() 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:
GtkIconSizeA stock size (
GtkIconSize). A size of(GtkIconSize)-1means 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-
Type:
const gchar*Render detail to pass to theme engine.
The argument can be NULL.The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
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. |