Method
GtkIconSetrender_icon
deprecated: 3.0
Declaration [src]
GdkPixbuf*
gtk_icon_set_render_icon (
GtkIconSet* icon_set,
GtkStyle* style,
GtkTextDirection direction,
GtkStateType state,
GtkIconSize size,
GtkWidget* widget,
const gchar* detail
)
Description [src]
Renders an icon using gtk_style_render_icon(). In most cases,
gtk_widget_render_icon()
is better, since it automatically provides
most of the arguments from the current widget settings. This
function never returns NULL
; if the icon can’t be rendered
(perhaps because an image file fails to load), a default “missing
image” icon will be returned instead.
Deprecated since: 3.0
Use gtk_icon_set_render_icon_pixbuf()
instead.
Parameters
style
-
Type:
GtkStyle
A
GtkStyle
associated withwidget
, orNULL
.The argument can be NULL
.The data is owned by the caller of the method. direction
-
Type:
GtkTextDirection
Text direction.
state
-
Type:
GtkStateType
Widget state.
size
-
Type:
GtkIconSize
Icon size (
GtkIconSize
). A size of(GtkIconSize)-1
means render at the size of the source and don’t scale. widget
-
Type:
GtkWidget
Widget that will display the icon, or
NULL
. The only use that is typically made of this is to determine the appropriateGdkScreen
.The argument can be NULL
.The data is owned by the caller of the method. detail
-
Type:
const gchar*
Detail to pass to the theme engine, or
NULL
. Note that passing a detail of anything butNULL
will disable caching.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 GdkPixbuf
to be displayed.
The caller of the method takes ownership of the returned data, and is responsible for freeing it. |