CellRendererPixbuf
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.
Skipped during bindings generation
method
gicon
: Property has no getter nor settermethod
icon-name
: Property has no getter nor settermethod
icon-size
: Property has no getter nor settermethod
pixbuf
: Property has no getter nor settermethod
pixbuf-expander-closed
: Property has no getter nor settermethod
pixbuf-expander-open
: Property has no getter nor settermethod
texture
: Property has no getter nor setter
Constructors
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
.
Properties
Functions
Passes an activate event to the cell renderer for possible processing. Some cell renderers may use events; for example, GtkCellRendererToggle
toggles when it gets a mouse click.
This signal gets emitted when the user cancels the process of editing a cell. For example, an editable cell renderer could be written to cancel editing when the user presses Escape.
This signal gets emitted when a cell starts to be edited. The intended use of this signal is to do special setup on @editable, e.g. adding a GtkEntryCompletion
or setting up additional columns in a GtkComboBox
.
Gets the aligned area used by @cell inside @cell_area. Used for finding the appropriate edit and focus rectangle.
Checks whether the given GtkCellRenderer
is expanded.
Checks whether the given GtkCellRenderer
is an expander.
Retrieves the minimum and natural size of a cell taking into account the widget’s preference for height-for-width management.
Gets whether the cell renderer prefers a height-for-width layout or a width-for-height layout.
Returns the cell renderer’s sensitivity.
Translates the cell renderer state to GtkStateFlags
, based on the cell renderer and widget sensitivity, and the given GtkCellRenderer
State.
Returns the cell renderer’s visibility.
Checks whether the cell renderer can do something when activated.
Sets the renderer’s alignment within its available space.
Sets the renderer size to be explicit, independent of the properties set.
Sets whether the given GtkCellRenderer
is expanded.
Sets whether the given GtkCellRenderer
is an expander.
Sets the renderer’s padding.
Sets the cell renderer’s sensitivity.
Sets the cell renderer’s visibility.
Starts editing the contents of this @cell, through a new GtkCellEditable
widget created by the GtkCellRenderer
Class.start_editing virtual function.
Informs the cell renderer that the editing is stopped. If @canceled is true, the cell renderer will emit the GtkCellRenderer
::editing-canceled signal.