gtkmm: Gtk::CellRendererPixbuf Class Reference

Renders a pixbuf in a cell. More...

#include <gtkmm/cellrendererpixbuf.h>

Inheritance diagram for Gtk::CellRendererPixbuf:

Public Member Functions

CellRendererPixbuf ( CellRendererPixbuf && src) noexcept
CellRendererPixbuf & operator= ( CellRendererPixbuf && src) noexcept
CellRendererPixbuf (const CellRendererPixbuf &)=delete
CellRendererPixbuf & operator= (const CellRendererPixbuf &)=delete
~CellRendererPixbuf () noexceptoverride
GtkCellRendererPixbuf* gobj ()
Provides access to the underlying C GtkObject. More...

const GtkCellRendererPixbuf* gobj () const
Provides access to the underlying C GtkObject. More...

CellRendererPixbuf ()
Glib::PropertyProxy < Glib::RefPtr < Gdk::Pixbuf > > property_pixbuf ()
The pixbuf to render. More...

Glib::PropertyProxy_ReadOnly < Glib::RefPtr < Gdk::Pixbuf > > property_pixbuf () const
The pixbuf to render. More...

Glib::PropertyProxy < Glib::RefPtr < Gdk::Pixbuf > > property_pixbuf_expander_open ()
Pixbuf for open expander. More...

Glib::PropertyProxy_ReadOnly < Glib::RefPtr < Gdk::Pixbuf > > property_pixbuf_expander_open () const
Pixbuf for open expander. More...

Glib::PropertyProxy < Glib::RefPtr < Gdk::Pixbuf > > property_pixbuf_expander_closed ()
Pixbuf for closed expander. More...

Glib::PropertyProxy_ReadOnly < Glib::RefPtr < Gdk::Pixbuf > > property_pixbuf_expander_closed () const
Pixbuf for closed expander. More...

Glib::PropertyProxy < Glib::ustring > property_stock_id ()
The stock ID of the stock icon to render. More...

Glib::PropertyProxy_ReadOnly < Glib::ustring > property_stock_id () const
The stock ID of the stock icon to render. More...

Glib::PropertyProxy < guint > property_stock_size ()
The GtkIconSize value that specifies the size of the rendered icon. More...

Glib::PropertyProxy_ReadOnly < guint > property_stock_size () const
The GtkIconSize value that specifies the size of the rendered icon. More...

Glib::PropertyProxy < Glib::ustring > property_stock_detail ()
Render detail to pass to the theme engine. More...

Glib::PropertyProxy_ReadOnly < Glib::ustring > property_stock_detail () const
Render detail to pass to the theme engine. More...

Glib::PropertyProxy < Glib::ustring > property_icon_name ()
The name of the themed icon to display. More...

Glib::PropertyProxy_ReadOnly < Glib::ustring > property_icon_name () const
The name of the themed icon to display. More...

Glib::PropertyProxy < bool > property_follow_state ()
Specifies whether the rendered pixbuf should be colorized according to the Gtk::CellRendererState . More...

Glib::PropertyProxy_ReadOnly < bool > property_follow_state () const
Specifies whether the rendered pixbuf should be colorized according to the Gtk::CellRendererState . More...

Glib::PropertyProxy < Glib::RefPtr < Gio::Icon > > property_gicon ()
The GIcon representing the icon to display. More...

Glib::PropertyProxy_ReadOnly < Glib::RefPtr < Gio::Icon > > property_gicon () const
The GIcon representing the icon to display. More...

Glib::PropertyProxy < :: Cairo::RefPtr < :: Cairo::Surface > > property_surface ()
The surface to render. More...

Glib::PropertyProxy_ReadOnly < :: Cairo::RefPtr < :: Cairo::Surface > > property_surface () const
The surface to render. More...

- Public Member Functions inherited from Gtk::CellRenderer
CellRenderer ( CellRenderer && src) noexcept
CellRenderer & operator= ( CellRenderer && src) noexcept
CellRenderer (const CellRenderer &)=delete
CellRenderer & operator= (const CellRenderer &)=delete
~CellRenderer () noexceptoverride
GtkCellRenderer* gobj ()
Provides access to the underlying C GtkObject. More...

const GtkCellRenderer* gobj () const
Provides access to the underlying C GtkObject. More...

SizeRequestMode get_request_mode () const
Gets whether the cell renderer prefers a height-for-width layout or a width-for-height layout. More...

void get_preferred_width ( Widget & widget, int& minimum_width, int& natural_width) const
Retreives a renderer’s natural size when rendered to widget . More...

void get_preferred_height_for_width ( Widget & widget, int width, int& minimum_height, int& natural_height) const
Retreives a cell renderers’s minimum and natural height if it were rendered to widget with the specified width . More...

void get_preferred_height ( Widget & widget, int& minimum_height, int& natural_height) const
Retreives a renderer’s natural size when rendered to widget . More...

void get_preferred_width_for_height ( Widget & widget, int height, int& minimum_width, int& natural_width) const
Retreives a cell renderers’s minimum and natural width if it were rendered to widget with the specified height . More...

void get_preferred_size ( Widget & widget, Requisition & minimum_size, Requisition & natural_size) const
Retrieves the minimum and natural size of a cell taking into account the widget’s preference for height-for-width management. More...

void get_aligned_area ( Widget & widget, CellRendererState flags, const Gdk::Rectangle & cell_area, Gdk::Rectangle & aligned_area)
Gets the aligned area used by cell inside cell_area . More...

void render (const :: Cairo::RefPtr < :: Cairo::Context >& cr, Widget & widget, const Gdk::Rectangle & background_area, const Gdk::Rectangle & cell_area, CellRendererState flags)
Invokes the virtual render function of the Gtk::CellRenderer . More...

bool activate (GdkEvent* event, Widget & widget, const Glib::ustring & path, const Gdk::Rectangle & background_area, const Gdk::Rectangle & cell_area, CellRendererState flags)
Passes an activate event to the cell renderer for possible processing. More...

CellEditable * start_editing (GdkEvent* event, Widget & widget, const Glib::ustring & path, const Gdk::Rectangle & background_area, const Gdk::Rectangle & cell_area, CellRendererState flags= CellRendererState (0))
Passes an activate event to the cell renderer for possible processing. More...

void set_fixed_size (int width, int height)
Sets the renderer size to be explicit, independent of the properties set. More...

void get_fixed_size (int& width, int& height) const
Fills in width and height with the appropriate size of cell . More...

void set_alignment (float xalign, float yalign)
Sets the renderer’s alignment within its available space. More...

void get_alignment (float& xalign, float& yalign) const
Fills in xalign and yalign with the appropriate values of cell . More...

void set_padding (int xpad, int ypad)
Sets the renderer’s padding. More...

void get_padding (int& xpad, int& ypad) const
Fills in xpad and ypad with the appropriate values of cell . More...

void set_visible (bool visible=true)
Sets the cell renderer’s visibility. More...

bool get_visible () const
Returns the cell renderer’s visibility. More...

void set_sensitive (bool sensitive=true)
Sets the cell renderer’s sensitivity. More...

bool get_sensitive () const
Returns the cell renderer’s sensitivity. More...

bool is_activatable () const
Checks whether the cell renderer can do something when activated. More...

void stop_editing (bool canceled=false)
Informs the cell renderer that the editing is stopped. More...

StateFlags get_state ( Widget & widget, CellRendererState cell_state) const
Translates the cell renderer state to Gtk::StateFlags , based on the cell renderer and widget sensitivity, and the given Gtk::CellRendererState . More...

StateFlags get_state ( CellRendererState cell_state) const
Translates the cell renderer state to StateFlags, based on the cell renderer and the given CellRendererState. More...

Glib::SignalProxy < void > signal_editing_canceled ()
Glib::SignalProxy < void, CellEditable *, const Glib::ustring & > signal_editing_started ()
Glib::PropertyProxy < CellRendererMode > property_mode ()
Editable mode of the CellRenderer . More...

Glib::PropertyProxy_ReadOnly < CellRendererMode > property_mode () const
Editable mode of the CellRenderer . More...

Glib::PropertyProxy < bool > property_visible ()
Display the cell. More...

Glib::PropertyProxy_ReadOnly < bool > property_visible () const
Display the cell. More...

Glib::PropertyProxy < bool > property_sensitive ()
Display the cell sensitive. More...

Glib::PropertyProxy_ReadOnly < bool > property_sensitive () const
Display the cell sensitive. More...

Glib::PropertyProxy < float > property_xalign ()
The x-align. More...

Glib::PropertyProxy_ReadOnly < float > property_xalign () const
The x-align. More...

Glib::PropertyProxy < float > property_yalign ()
The y-align. More...

Glib::PropertyProxy_ReadOnly < float > property_yalign () const
The y-align. More...

Glib::PropertyProxy < unsigned int > property_xpad ()
The xpad. More...

Glib::PropertyProxy_ReadOnly < unsigned int > property_xpad () const
The xpad. More...

Glib::PropertyProxy < unsigned int > property_ypad ()
The ypad. More...

Glib::PropertyProxy_ReadOnly < unsigned int > property_ypad () const
The ypad. More...

Glib::PropertyProxy < int > property_width ()
The fixed width. More...

Glib::PropertyProxy_ReadOnly < int > property_width () const
The fixed width. More...

Glib::PropertyProxy < int > property_height ()
The fixed height. More...

Glib::PropertyProxy_ReadOnly < int > property_height () const
The fixed height. More...

Glib::PropertyProxy < bool > property_is_expander ()
Row has children. More...

Glib::PropertyProxy_ReadOnly < bool > property_is_expander () const
Row has children. More...

Glib::PropertyProxy < bool > property_is_expanded ()
Row is an expander row, and is expanded. More...

Glib::PropertyProxy_ReadOnly < bool > property_is_expanded () const
Row is an expander row, and is expanded. More...

Glib::PropertyProxy_WriteOnly < Glib::ustring > property_cell_background ()
Cell background color as a string. More...

Glib::PropertyProxy < Gdk::Color > property_cell_background_gdk ()
Cell background as a Gdk::Color . More...

Glib::PropertyProxy_ReadOnly < Gdk::Color > property_cell_background_gdk () const
Cell background as a Gdk::Color . More...

Glib::PropertyProxy < Gdk::RGBA > property_cell_background_rgba ()
Cell background as a Gdk::RGBA . More...

Glib::PropertyProxy_ReadOnly < Gdk::RGBA > property_cell_background_rgba () const
Cell background as a Gdk::RGBA . More...

Glib::PropertyProxy < bool > property_cell_background_set ()
Whether the cell background color is set. More...

Glib::PropertyProxy_ReadOnly < bool > property_cell_background_set () const
Whether the cell background color is set. More...

Glib::PropertyProxy_ReadOnly < bool > property_editing () const
Whether the cell renderer is currently in editing mode. More...

- Public Member Functions inherited from Gtk::Object
Object ( Object && src) noexcept
Object & operator= ( Object && src) noexcept
~Object () noexceptoverride
GObject* gobj ()
Provides access to the underlying C GtkObject. More...

const GObject* gobj () const
Provides access to the underlying C GtkObject. More...

- Public Member Functions inherited from Glib::Object
Object (const Object &)=delete
Object & operator= (const Object &)=delete
Object ( Object &&src) noexcept
Object & operator= ( Object &&src) noexcept
void * get_data (const QueryQuark &key)
void set_data (const Quark &key, void *data)
void set_data (const Quark &key, void *data, DestroyNotify notify)
void remove_data (const QueryQuark &quark)
void * steal_data (const QueryQuark &quark)
Glib::RefPtr < Glib::Object > wrap (GObject *object, bool take_copy=false)
- Public Member Functions inherited from Glib::ObjectBase
ObjectBase (const ObjectBase &)=delete
ObjectBase & operator= (const ObjectBase &)=delete
void set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value)
void get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const
void set_property (const Glib::ustring &property_name, const PropertyType &value)
void get_property (const Glib::ustring &property_name, PropertyType &value) const
void connect_property_changed (const Glib::ustring &property_name, const sigc::slot < void > &slot)
void connect_property_changed (const Glib::ustring &property_name, sigc::slot < void > &&slot)
sigc::connection connect_property_changed_with_return (const Glib::ustring &property_name, const sigc::slot < void > &slot)
sigc::connection connect_property_changed_with_return (const Glib::ustring &property_name, sigc::slot < void > &&slot)
void freeze_notify ()
void thaw_notify ()
virtual void reference () const
virtual void unreference () const
GObject * gobj ()
const GObject * gobj () const
GObject * gobj_copy () const
- Public Member Functions inherited from sigc::trackable
trackable () noexcept
trackable (const trackable &src) noexcept
trackable ( trackable &&src)
~trackable ()
void add_destroy_notify_callback (void *data, func_destroy_notify func) const
void notify_callbacks ()
trackable & operator= (const trackable &src)
trackable & operator= ( trackable &&src)
void remove_destroy_notify_callback (void *data) const

Static Public Member Functions

static GType get_type ()
Get the GType for this class, for use with the underlying GObject type system. More...

- Static Public Member Functions inherited from Gtk::CellRenderer
static GType get_type ()
Get the GType for this class, for use with the underlying GObject type system. More...

Related Functions

(Note that these are not member functions.)

Gtk::CellRendererPixbuf * wrap (GtkCellRendererPixbuf* object, bool take_copy=false)
A Glib::wrap() method for this object. More...

Additional Inherited Members

- Public Types inherited from Glib::Object
typedef void(*)(gpointer data DestroyNotify )
- Public Types inherited from sigc::trackable
typedef internal::func_destroy_notify func_destroy_notify
- Protected Member Functions inherited from Gtk::CellRenderer
virtual void on_editing_canceled ()
This is a default handler for the signal signal_editing_canceled() . More...

virtual void on_editing_started ( CellEditable * editable, const Glib::ustring & path)
This is a default handler for the signal signal_editing_started() . More...

CellRenderer ()
virtual SizeRequestMode get_request_mode_vfunc () const
virtual void get_preferred_width_vfunc ( Widget & widget, int& minimum_width, int& natural_width) const
virtual void get_preferred_height_for_width_vfunc ( Widget & widget, int width, int& minimum_height, int& natural_height) const
virtual void get_preferred_height_vfunc ( Widget & widget, int& minimum_height, int& natural_height) const
virtual void get_preferred_width_for_height_vfunc ( Widget & widget, int height, int& minimum_width, int& natural_width) const
virtual void render_vfunc (const :: Cairo::RefPtr < :: Cairo::Context >& cr, Widget & widget, const Gdk::Rectangle & background_area, const Gdk::Rectangle & cell_area, CellRendererState flags)
virtual bool activate_vfunc (GdkEvent* event, Widget & widget, const Glib::ustring & path, const Gdk::Rectangle & background_area, const Gdk::Rectangle & cell_area, CellRendererState flags)
virtual CellEditable * start_editing_vfunc (GdkEvent* event, Widget & widget, const Glib::ustring & path, const Gdk::Rectangle & background_area, const Gdk::Rectangle & cell_area, CellRendererState flags)
- Protected Member Functions inherited from Glib::Object
Object ()
Object (const Glib::ConstructParams &construct_params)
Object (GObject *castitem)
~Object () noexceptoverride
- Protected Member Functions inherited from Glib::ObjectBase
ObjectBase ()
ObjectBase (const char *custom_type_name)
ObjectBase (const std::type_info &custom_type_info)
ObjectBase ( ObjectBase &&src) noexcept
ObjectBase & operator= ( ObjectBase &&src) noexcept
virtual ~ObjectBase () noexcept=0
void initialize (GObject *castitem)
void initialize_move (GObject *castitem, Glib::ObjectBase *previous_wrapper)

Detailed Description

Renders a pixbuf in a cell.

A CellRendererPixbuf can be used to render an image in a cell. It allows you to render either a given Pixbuf (set via the pixbuf property) or a stock icon (set via the stock_id property).

To support the tree view, CellRendererPixbuf also supports rendering two alternative pixbufs, when the is_expanded property is true. If the is_expanded property is true and the pixbuf_expander_open property is set to a pixbuf, it renders that pixbuf. If the is_expanded property is false and the* pixbuf_expander_closed property is set to a pixbuf, it renders that one.

Constructor & Destructor Documentation

Gtk::CellRendererPixbuf::CellRendererPixbuf ( CellRendererPixbuf && src )
noexcept
Gtk::CellRendererPixbuf::CellRendererPixbuf ( const CellRendererPixbuf & )
delete
Gtk::CellRendererPixbuf::~CellRendererPixbuf ( )
override noexcept
Gtk::CellRendererPixbuf::CellRendererPixbuf ( )

Member Function Documentation

static GType Gtk::CellRendererPixbuf::get_type ( )
static

Get the GType for this class, for use with the underlying GObject type system.

GtkCellRendererPixbuf* Gtk::CellRendererPixbuf::gobj ( )
inline

Provides access to the underlying C GtkObject.

const GtkCellRendererPixbuf* Gtk::CellRendererPixbuf::gobj ( ) const
inline

Provides access to the underlying C GtkObject.

CellRendererPixbuf & Gtk::CellRendererPixbuf::operator= ( CellRendererPixbuf && src )
noexcept
CellRendererPixbuf & Gtk::CellRendererPixbuf::operator= ( const CellRendererPixbuf & )
delete
Glib::PropertyProxy < bool > Gtk::CellRendererPixbuf::property_follow_state ( )

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

Since gtkmm 2.8:

Deprecated: 3.16: Cell renderers always follow state.

Deprecated:
Cell renderers always follow state.
Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < bool > Gtk::CellRendererPixbuf::property_follow_state ( ) const

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

Since gtkmm 2.8:

Deprecated: 3.16: Cell renderers always follow state.

Deprecated:
Cell renderers always follow state.
Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy < Glib::RefPtr < Gio::Icon > > Gtk::CellRendererPixbuf::property_gicon ( )

The GIcon representing the icon to display.

If the icon theme is changed, the image will be updated automatically.

Since gtkmm 2.14:
Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < Glib::RefPtr < Gio::Icon > > Gtk::CellRendererPixbuf::property_gicon ( ) const

The GIcon representing the icon to display.

If the icon theme is changed, the image will be updated automatically.

Since gtkmm 2.14:
Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy < Glib::ustring > Gtk::CellRendererPixbuf::property_icon_name ( )

The name of the themed icon to display.

This property only has an effect if not overridden by "stock_id" or "pixbuf" properties.

Since gtkmm 2.8:
Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < Glib::ustring > Gtk::CellRendererPixbuf::property_icon_name ( ) const

The name of the themed icon to display.

This property only has an effect if not overridden by "stock_id" or "pixbuf" properties.

Since gtkmm 2.8:
Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy < Glib::RefPtr < Gdk::Pixbuf > > Gtk::CellRendererPixbuf::property_pixbuf ( )

The pixbuf to render.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < Glib::RefPtr < Gdk::Pixbuf > > Gtk::CellRendererPixbuf::property_pixbuf ( ) const

The pixbuf to render.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy < Glib::RefPtr < Gdk::Pixbuf > > Gtk::CellRendererPixbuf::property_pixbuf_expander_closed ( )

Pixbuf for closed expander.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < Glib::RefPtr < Gdk::Pixbuf > > Gtk::CellRendererPixbuf::property_pixbuf_expander_closed ( ) const

Pixbuf for closed expander.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy < Glib::RefPtr < Gdk::Pixbuf > > Gtk::CellRendererPixbuf::property_pixbuf_expander_open ( )

Pixbuf for open expander.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < Glib::RefPtr < Gdk::Pixbuf > > Gtk::CellRendererPixbuf::property_pixbuf_expander_open ( ) const

Pixbuf for open expander.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy < Glib::ustring > Gtk::CellRendererPixbuf::property_stock_detail ( )

Render detail to pass to the theme engine.

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < Glib::ustring > Gtk::CellRendererPixbuf::property_stock_detail ( ) const

Render detail to pass to the theme engine.

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy < Glib::ustring > Gtk::CellRendererPixbuf::property_stock_id ( )

The stock ID of the stock icon to render.

Deprecated: 3.10: Use Gtk::CellRendererPixbuf::property_icon_name() instead.

Deprecated:
Use property_icon_name() instead.
Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < Glib::ustring > Gtk::CellRendererPixbuf::property_stock_id ( ) const

The stock ID of the stock icon to render.

Deprecated: 3.10: Use Gtk::CellRendererPixbuf::property_icon_name() instead.

Deprecated:
Use property_icon_name() instead.
Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy < guint > Gtk::CellRendererPixbuf::property_stock_size ( )

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

Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < guint > Gtk::CellRendererPixbuf::property_stock_size ( ) const

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

Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy < :: Cairo::RefPtr < :: Cairo::Surface > > Gtk::CellRendererPixbuf::property_surface ( )

The surface to render.

Since gtkmm 3.10:
Returns
A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly < :: Cairo::RefPtr < :: Cairo::Surface > > Gtk::CellRendererPixbuf::property_surface ( ) const

The surface to render.

Since gtkmm 3.10:
Returns
A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

Friends And Related Function Documentation

Gtk::CellRendererPixbuf * wrap ( GtkCellRendererPixbuf * object ,
bool take_copy = false
)
related

A Glib::wrap() method for this object.

Parameters
object The C instance.
take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns
A C++ instance that wraps this C instance.