![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkCellRendererPixbuf; GtkCellRenderer* gtk_cell_renderer_pixbuf_new (void);
GObject +----GInitiallyUnowned +----GtkObject +----GtkCellRenderer +----GtkCellRendererPixbuf
follow-state gboolean : Read / Write icon-name gchararray : Read / Write pixbuf GdkPixbuf : Read / Write pixbuf-expander-closed GdkPixbuf : Read / Write pixbuf-expander-open GdkPixbuf : Read / Write stock-detail gchararray : Read / Write stock-id gchararray : 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
propertyfollow-state gboolean : Read / Write
Specifies whether the rendered pixbuf should be colorized according to the GtkCellRendererState.
Default value: FALSE
Since 2.8
icon-name
propertyicon-name gchararray : 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
propertypixbuf-expander-closed GdkPixbuf : Read / Write
Pixbuf for closed expander.
pixbuf-expander-open
propertypixbuf-expander-open GdkPixbuf : Read / Write
Pixbuf for open expander.
stock-detail
propertystock-detail gchararray : Read / Write
Render detail to pass to the theme engine.
Default value: NULL
stock-id
propertystock-id gchararray : Read / Write
The stock ID of the stock icon to render.
Default value: NULL