:right-sidebar: True

CellRendererPixbuf
===================================================================

.. currentmodule:: gi.repository.Gtk





.. deprecated:: 4.10

   List views use widgets to display their contents. You
   should use :obj:`~gi.repository.Gtk.Image` for icons, and :obj:`~gi.repository.Gtk.Picture` for images



.. class:: CellRendererPixbuf(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gtk.CellRenderer`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`





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 :const:`True`.
If the `GtkCellRenderer:is-expanded property` is :const:`True` and the
``GtkCellRendererPixbuf:pixbuf-expander-open`` property is set to a pixbuf, it
renders that pixbuf, if the ``GtkCellRenderer:is-expanded`` property is :const:`False`
and the ``GtkCellRendererPixbuf:pixbuf-expander-closed`` property is set to a
pixbuf, it renders that one.



Constructors
------------

.. rst-class:: interim-class

.. class:: CellRendererPixbuf
   :no-index:


   .. classmethod:: new() -> ~gi.repository.Gtk.CellRenderer

      Creates a new ``GtkCellRendererPixbuf``. Adjust rendering
      parameters using object properties. Object properties can be set
      globally (with :func:`~gi.repository.GObject.GObject.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:: 4.10

         Please do not use it in newly written code













Properties
----------

.. rst-class:: interim-class

.. class:: CellRendererPixbuf
   :no-index:
   

   .. attribute:: props.gicon
      :type: ~gi.repository.Gio.Icon

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







   .. attribute:: props.icon_name
      :type: str

      The name of the themed icon to display.
      This property only has an effect if not overridden by the "pixbuf" property.







   .. attribute:: props.icon_size
      :type: ~gi.repository.Gtk.IconSize

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







   .. attribute:: props.pixbuf
      :type: ~gi.repository.GdkPixbuf.Pixbuf

      






   .. attribute:: props.pixbuf_expander_closed
      :type: ~gi.repository.GdkPixbuf.Pixbuf

      






   .. attribute:: props.pixbuf_expander_open
      :type: ~gi.repository.GdkPixbuf.Pixbuf

      






   .. attribute:: props.texture
      :type: ~gi.repository.Gdk.Texture