Gtk.CellRendererPixbuf

g GObject.InitiallyUnowned GObject.InitiallyUnowned Gtk.CellRenderer Gtk.CellRenderer GObject.InitiallyUnowned->Gtk.CellRenderer GObject.Object GObject.Object GObject.Object->GObject.InitiallyUnowned Gtk.CellRendererPixbuf Gtk.CellRendererPixbuf Gtk.CellRenderer->Gtk.CellRendererPixbuf

Subclasses:

None

Methods

Inherited:

Gtk.CellRenderer (27), GObject.Object (37)

Structs:

GObject.ObjectClass (5)

class

new ()

Virtual Methods

Inherited:

Gtk.CellRenderer (11), GObject.Object (7)

Properties

Inherited:

Gtk.CellRenderer (15)

Name

Type

Flags

Short Description

gicon

Gio.Icon

r/w

icon-name

str

r/w

icon-size

Gtk.IconSize

r/w/en

pixbuf

GdkPixbuf.Pixbuf

w

pixbuf-expander-closed

GdkPixbuf.Pixbuf

r/w

pixbuf-expander-open

GdkPixbuf.Pixbuf

r/w

texture

Gdk.Texture

r/w

Signals

Inherited:

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

Fields

Inherited:

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

Class Details

class Gtk.CellRendererPixbuf(**kwargs)
Bases:

Gtk.CellRenderer

Abstract:

No

Renders a pixbuf in a cell

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

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

Deprecated since version 4.10: List views use widgets to display their contents. You should use [class`Gtk`.Image] for icons, and [class`Gtk`.Picture] for images

classmethod new()[source]
Returns:

the new cell renderer

Return type:

Gtk.CellRenderer

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.

Deprecated since version 4.10.

Property Details

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.

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 the “pixbuf” property.

Gtk.CellRendererPixbuf.props.icon_size
Name:

icon-size

Type:

Gtk.IconSize

Default Value:

Gtk.IconSize.INHERIT

Flags:

READABLE, WRITABLE, EXPLICIT_NOTIFY

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

Gtk.CellRendererPixbuf.props.pixbuf
Name:

pixbuf

Type:

GdkPixbuf.Pixbuf

Default Value:

None

Flags:

WRITABLE

Gtk.CellRendererPixbuf.props.pixbuf_expander_closed
Name:

pixbuf-expander-closed

Type:

GdkPixbuf.Pixbuf

Default Value:

None

Flags:

READABLE, WRITABLE

Gtk.CellRendererPixbuf.props.pixbuf_expander_open
Name:

pixbuf-expander-open

Type:

GdkPixbuf.Pixbuf

Default Value:

None

Flags:

READABLE, WRITABLE

Gtk.CellRendererPixbuf.props.texture
Name:

texture

Type:

Gdk.Texture

Default Value:

None

Flags:

READABLE, WRITABLE