|  |  |  | GTK+ 3 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
#include <gtk/gtk.h>
struct              GtkCellRendererPixbuf;
GtkCellRenderer *   gtk_cell_renderer_pixbuf_new        (void);
"follow-state" gboolean : Read / Write "gicon" GIcon* : Read / Write "icon-name" gchar* : Read / Write "pixbuf" GdkPixbuf* : Read / Write "pixbuf-expander-closed" GdkPixbuf* : Read / Write "pixbuf-expander-open" GdkPixbuf* : Read / Write "stock-detail" gchar* : Read / Write "stock-id" gchar* : Read / Write "stock-size" guint : Read / Write
A GtkCellRendererPixbuf can be used to render an image in a cell. It allows to render either a given GdkPixbuf (set via the "pixbuf" property) or a stock icon (set via the "stock-id" property).
To support the tree view, GtkCellRendererPixbuf also supports rendering two
alternative pixbufs, when the "is-expander" property is TRUE.
If the "is-expanded" property is TRUE and the
"pixbuf-expander-open" property is set to a pixbuf, it
renders that pixbuf, if the "is-expanded" property is FALSE
and the "pixbuf-expander-closed" property is set to a
pixbuf, it renders that one.
GtkCellRenderer *   gtk_cell_renderer_pixbuf_new        (void);
Creates a new GtkCellRendererPixbuf. Adjust rendering
parameters using object properties. Object properties can be set
globally (with g_object_set()). Also, with GtkTreeViewColumn, you
can bind a property to a value in a GtkTreeModel. For example, you
can bind the "pixbuf" property on the cell renderer to a pixbuf value
in the model, thus rendering a different image in each row of the
GtkTreeView.
| Returns : | the new cell renderer | 
"follow-state" property  "follow-state"             gboolean              : Read / Write
Specifies whether the rendered pixbuf should be colorized according to the GtkCellRendererState.
Default value: FALSE
Since 2.8
"gicon" property  "gicon"                    GIcon*                : Read / Write
The GIcon representing the icon to display. If the icon theme is changed, the image will be updated automatically.
Since 2.14
"icon-name" property  "icon-name"                gchar*                : Read / Write
The name of the themed icon to display. This property only has an effect if not overridden by "stock_id" or "pixbuf" properties.
Default value: NULL
Since 2.8
"pixbuf-expander-closed" property  "pixbuf-expander-closed"   GdkPixbuf*            : Read / Write
Pixbuf for closed expander.
"pixbuf-expander-open" property  "pixbuf-expander-open"     GdkPixbuf*            : Read / Write
Pixbuf for open expander.
"stock-detail" property  "stock-detail"             gchar*                : Read / Write
Render detail to pass to the theme engine.
Default value: NULL
"stock-id" property  "stock-id"                 gchar*                : Read / Write
The stock ID of the stock icon to render.
Default value: NULL