## GtkCellRendererPixbuf

GtkCellRendererPixbuf — Renders a pixbuf in a cell

## Synopsis

    #include <gtk/gtk.h>

                GtkCellRendererPixbuf;
    GtkCellRenderer* gtk_cell_renderer_pixbuf_new
                                                (void);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkCellRenderer
                         +----GtkCellRendererPixbuf

## Properties

      "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

## Description

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.

## Details

### GtkCellRendererPixbuf

    typedef struct _GtkCellRendererPixbuf GtkCellRendererPixbuf;

### gtk_cell_renderer_pixbuf_new ()

    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

## Property Details

### The "`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

### The "`icon-name`" property

      "icon-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

### The "`pixbuf`" property

      "pixbuf"               GdkPixbuf             : Read / Write

The pixbuf to render.

### The "`pixbuf-expander-closed`" property

      "pixbuf-expander-closed" GdkPixbuf             : Read / Write

Pixbuf for closed expander.

### The "`pixbuf-expander-open`" property

      "pixbuf-expander-open" GdkPixbuf             : Read / Write

Pixbuf for open expander.

### The "`stock-detail`" property

      "stock-detail"         gchararray            : Read / Write

Render detail to pass to the theme engine.

Default value: NULL

### The "`stock-id`" property

      "stock-id"             gchararray            : Read / Write

The stock ID of the stock icon to render.

Default value: NULL

### The "`stock-size`" property

      "stock-size"           guint                 : Read / Write

The GtkIconSize value that specifies the size of the rendered icon.

Default value: 1