Class
GtkCellRendererPixbuf
Description [src]
final class Gtk.CellRendererPixbuf : Gtk.CellRenderer {
/* No available fields */
}
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.
Constructors
gtk_cell_renderer_pixbuf_new
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
.
Instance methods
Methods inherited from GtkCellRenderer (27)
gtk_cell_renderer_activate
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.
gtk_cell_renderer_get_aligned_area
Gets the aligned area used by cell
inside cell_area
. Used for finding
the appropriate edit and focus rectangle.
gtk_cell_renderer_get_alignment
Fills in xalign
and yalign
with the appropriate values of cell
.
gtk_cell_renderer_get_fixed_size
Fills in width
and height
with the appropriate size of cell
.
gtk_cell_renderer_get_is_expanded
Checks whether the given GtkCellRenderer
is expanded.
gtk_cell_renderer_get_is_expander
Checks whether the given GtkCellRenderer
is an expander.
gtk_cell_renderer_get_padding
Fills in xpad
and ypad
with the appropriate values of cell
.
gtk_cell_renderer_get_preferred_height
Retrieves a renderer’s natural size when rendered to widget
.
gtk_cell_renderer_get_preferred_height_for_width
Retrieves a cell renderers’s minimum and natural height if it were rendered to
widget
with the specified width
.
gtk_cell_renderer_get_preferred_size
Retrieves the minimum and natural size of a cell taking into account the widget’s preference for height-for-width management.
gtk_cell_renderer_get_preferred_width
Retrieves a renderer’s natural size when rendered to widget
.
gtk_cell_renderer_get_preferred_width_for_height
Retrieves a cell renderers’s minimum and natural width if it were rendered to
widget
with the specified height
.
gtk_cell_renderer_get_request_mode
Gets whether the cell renderer prefers a height-for-width layout or a width-for-height layout.
gtk_cell_renderer_get_sensitive
Returns the cell renderer’s sensitivity.
gtk_cell_renderer_get_state
Translates the cell renderer state to GtkStateFlags
,
based on the cell renderer and widget sensitivity, and
the given GtkCellRenderer
State.
gtk_cell_renderer_get_visible
Returns the cell renderer’s visibility.
gtk_cell_renderer_is_activatable
Checks whether the cell renderer can do something when activated.
gtk_cell_renderer_set_alignment
Sets the renderer’s alignment within its available space.
gtk_cell_renderer_set_fixed_size
Sets the renderer size to be explicit, independent of the properties set.
gtk_cell_renderer_set_is_expanded
Sets whether the given GtkCellRenderer
is expanded.
gtk_cell_renderer_set_is_expander
Sets whether the given GtkCellRenderer
is an expander.
gtk_cell_renderer_set_padding
Sets the renderer’s padding.
gtk_cell_renderer_set_sensitive
Sets the cell renderer’s sensitivity.
Methods inherited from GObject (42)
Properties
Gtk.CellRendererPixbuf:gicon
The GIcon representing the icon to display. If the icon theme is changed, the image will be updated automatically.
Gtk.CellRendererPixbuf:icon-name
The name of the themed icon to display. This property only has an effect if not overridden by the “pixbuf” property.
Gtk.CellRendererPixbuf:icon-size
The GtkIconSize
value that specifies the size of the rendered icon.
Gtk.CellRendererPixbuf:pixbuf
Gtk.CellRendererPixbuf:pixbuf-expander-closed
Gtk.CellRendererPixbuf:pixbuf-expander-open
Gtk.CellRendererPixbuf:texture
Properties inherited from GtkCellRenderer (15)
Gtk.CellRenderer:cell-background
Gtk.CellRenderer:cell-background-rgba
Cell background as a GdkRGBA
Gtk.CellRenderer:cell-background-set
Gtk.CellRenderer:editing
Gtk.CellRenderer:height
Gtk.CellRenderer:is-expanded
Gtk.CellRenderer:is-expander
Gtk.CellRenderer:mode
Gtk.CellRenderer:sensitive
Gtk.CellRenderer:visible
Gtk.CellRenderer:width
Gtk.CellRenderer:xalign
Gtk.CellRenderer:xpad
Gtk.CellRenderer:yalign
Gtk.CellRenderer:ypad
Signals
Signals inherited from GtkCellRenderer (2)
Gtk.CellRenderer::editing-canceled
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.
Gtk.CellRenderer::editing-started
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
.