Gtk.CellRendererPixbuf¶

Subclasses:	None

Methods¶

Inherited:	Gtk.CellRenderer (25), GObject.Object (37)
Structs:	Gtk.CellRendererClass (1), GObject.ObjectClass (5)

class new ()

Virtual Methods¶

Inherited:	Gtk.CellRenderer (12), GObject.Object (7)

Properties¶

Inherited:	Gtk.CellRenderer (16)

Name	Type	Flags	Short Description
`follow-state`	`bool`	d/r/w	Whether the rendered pixbuf should be colorized according to the state `deprecated`
`gicon`	`Gio.Icon`	r/w	The `Gio.Icon` being displayed
`icon-name`	`str`	r/w	The name of the icon from the icon theme
`pixbuf`	`GdkPixbuf.Pixbuf`	r/w	The pixbuf to render
`pixbuf-expander-closed`	`GdkPixbuf.Pixbuf`	r/w	Pixbuf for closed expander
`pixbuf-expander-open`	`GdkPixbuf.Pixbuf`	r/w	Pixbuf for open expander
`stock-detail`	`str`	r/w	Render detail to pass to the theme engine
`stock-id`	`str`	d/r/w	The stock ID of the stock icon to render `deprecated`
`stock-size`	`int`	r/w	The `Gtk.IconSize` value that specifies the size of the rendered icon
`surface`	`cairo.Surface`	r/w	The surface to render

Signals¶

Inherited:	Gtk.CellRenderer (2), GObject.Object (1)

Fields¶

Inherited:	Gtk.CellRenderer (2), GObject.Object (1)

Name	Type	Access	Description
parent	`Gtk.CellRenderer`	r

Class Details¶

class Gtk.CellRendererPixbuf(**kwargs)¶

Bases:	`Gtk.CellRenderer`
Abstract:	No
Structure:	`Gtk.CellRendererPixbufClass`

A Gtk.CellRendererPixbuf can be used to render an image in a cell. It allows to render either a given GdkPixbuf.Pixbuf (set via the Gtk.CellRendererPixbuf :pixbuf property) or a named icon (set via the Gtk.CellRendererPixbuf :icon-name property).

To support the tree view, Gtk.CellRendererPixbuf also supports rendering two alternative pixbufs, when the Gtk.CellRenderer :is-expander property is True. If the Gtk.CellRenderer :is-expanded property is True and the Gtk.CellRendererPixbuf :pixbuf-expander-open property is set to a pixbuf, it renders that pixbuf, if the Gtk.CellRenderer :is-expanded property is False and the Gtk.CellRendererPixbuf :pixbuf-expander-closed property is set to a pixbuf, it renders that one.

classmethod new()[source]¶

Returns:	the new cell renderer
Return type:	`Gtk.CellRenderer`

Creates a new Gtk.CellRendererPixbuf. Adjust rendering parameters using object properties. Object properties can be set globally (with g_object_set()). Also, with Gtk.TreeViewColumn, you can bind a property to a value in a Gtk.TreeModel. 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 Gtk.TreeView.

Property Details¶

Gtk.CellRendererPixbuf.props.follow_state¶

Name:	`follow-state`
Type:	`bool`
Default Value:	`True`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

Specifies whether the rendered pixbuf should be colorized according to the Gtk.CellRendererState.

New in version 2.8.

Deprecated since version 3.16: Cell renderers always follow state.

Gtk.CellRendererPixbuf.props.gicon¶

Name:	`gicon`
Type:	`Gio.Icon`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The Gio.Icon representing the icon to display. If the icon theme is changed, the image will be updated automatically.

New in version 2.14.

Gtk.CellRendererPixbuf.props.icon_name¶

Name:	`icon-name`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The name of the themed icon to display. This property only has an effect if not overridden by “stock_id” or “pixbuf” properties.

New in version 2.8.

Gtk.CellRendererPixbuf.props.pixbuf¶

Name:	`pixbuf`
Type:	`GdkPixbuf.Pixbuf`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The pixbuf to render

Gtk.CellRendererPixbuf.props.pixbuf_expander_closed¶

Name:	`pixbuf-expander-closed`
Type:	`GdkPixbuf.Pixbuf`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

Pixbuf for closed expander

Gtk.CellRendererPixbuf.props.pixbuf_expander_open¶

Name:	`pixbuf-expander-open`
Type:	`GdkPixbuf.Pixbuf`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

Pixbuf for open expander

Gtk.CellRendererPixbuf.props.stock_detail¶

Name:	`stock-detail`
Type:	`str`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

Render detail to pass to the theme engine

Gtk.CellRendererPixbuf.props.stock_id¶

Name:	`stock-id`
Type:	`str`
Default Value:	`None`
Flags:	`DEPRECATED`, `READABLE`, `WRITABLE`

The stock ID of the stock icon to render

New in version 2.2.

Deprecated since version 3.10: Use Gtk.CellRendererPixbuf :icon-name instead.

Gtk.CellRendererPixbuf.props.stock_size¶

Name:	`stock-size`
Type:	`int`
Default Value:	`1`
Flags:	`READABLE`, `WRITABLE`

The Gtk.IconSize value that specifies the size of the rendered icon.

New in version 2.2.

Gtk.CellRendererPixbuf.props.surface¶

Name:	`surface`
Type:	`cairo.Surface`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`

The surface to render

New in version 3.10.