gtkmm  4.16.0
Public Member Functions | Static Public Member Functions | Related Functions | List of all members
Gtk::CellRendererSpinner Class Reference

Renders a spinning animation in a cell. More...

#include <gtkmm/cellrendererspinner.h>

Inheritance diagram for Gtk::CellRendererSpinner:
Inheritance graph
[legend]

Public Member Functions

 CellRendererSpinner (CellRendererSpinner&& src) noexcept
 
CellRendererSpinneroperator= (CellRendererSpinner&& src) noexcept
 
 CellRendererSpinner (const CellRendererSpinner&)=delete
 
CellRendererSpinneroperator= (const CellRendererSpinner&)=delete
 
 ~CellRendererSpinner () noexcept override
 
GtkCellRendererSpinner* gobj ()
 Provides access to the underlying C GObject. More...
 
const GtkCellRendererSpinner* gobj () const
 Provides access to the underlying C GObject. More...
 
 CellRendererSpinner ()
 
Glib::PropertyProxy< bool > property_active ()
 Whether the spinner is active (ie. More...
 
Glib::PropertyProxy_ReadOnly< bool > property_active () const
 Whether the spinner is active (ie. More...
 
Glib::PropertyProxy< guint > property_pulse ()
 Pulse of the spinner. More...
 
Glib::PropertyProxy_ReadOnly< guint > property_pulse () const
 Pulse of the spinner. More...
 
Glib::PropertyProxy< Gtk::IconSizeproperty_size ()
 The Gtk::IconSize value that specifies the size of the rendered spinner. More...
 
Glib::PropertyProxy_ReadOnly< Gtk::IconSizeproperty_size () const
 The Gtk::IconSize value that specifies the size of the rendered spinner. More...
 
- Public Member Functions inherited from Gtk::CellRenderer
 CellRenderer (CellRenderer&& src) noexcept
 
CellRendereroperator= (CellRenderer&& src) noexcept
 
 CellRenderer (const CellRenderer&)=delete
 
CellRendereroperator= (const CellRenderer&)=delete
 
 ~CellRenderer () noexcept override
 
GtkCellRenderer* gobj ()
 Provides access to the underlying C GObject. More...
 
const GtkCellRenderer* gobj () const
 Provides access to the underlying C GObject. 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
 Retrieves 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
 Retrieves 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
 Retrieves 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
 Retrieves 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...
 
Gdk::Rectangle get_aligned_area (Widget& widget, CellRendererState flags, const Gdk::Rectangle& cell_area) const
 Gets the aligned area used by this CellRenderer inside cell_area. More...
 
void snapshot (const Glib::RefPtr< Gtk::Snapshot >& snapshot, 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 (const Glib::RefPtr< const Gdk::Event >& 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...
 
CellEditablestart_editing (const Glib::RefPtr< const Gdk::Event >& event, Widget& widget, const Glib::ustring& path, const Gdk::Rectangle& background_area, const Gdk::Rectangle& cell_area, CellRendererState flags=CellRendererState(0))
 Starts editing the contents of this cell, through a new Gtk::CellEditable widget created by the Gtk::CellRendererClass.start_editing virtual function. 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 set_is_expander (bool is_expander=true)
 Sets whether the given Gtk::CellRenderer is an expander. More...
 
bool get_is_expander () const
 Checks whether the given Gtk::CellRenderer is an expander. More...
 
void set_is_expanded (bool is_expanded=true)
 Sets whether the given Gtk::CellRenderer is expanded. More...
 
bool get_is_expanded () const
 Checks whether the given Gtk::CellRenderer is expanded. 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
 A get_state() convenience overload. More...
 
Glib::SignalProxy< void()> signal_editing_canceled ()
 
Glib::SignalProxy< void(CellEditable*, const Glib::ustring&)> signal_editing_started ()
 
Glib::PropertyProxy< CellRendererModeproperty_mode ()
 Default value: Gtk::CellRendererMode::INERT. More...
 
Glib::PropertyProxy_ReadOnly< CellRendererModeproperty_mode () const
 Default value: Gtk::CellRendererMode::INERT. More...
 
Glib::PropertyProxy< bool > property_visible ()
 Default value: true More...
 
Glib::PropertyProxy_ReadOnly< bool > property_visible () const
 Default value: true More...
 
Glib::PropertyProxy< bool > property_sensitive ()
 Default value: true More...
 
Glib::PropertyProxy_ReadOnly< bool > property_sensitive () const
 Default value: true More...
 
Glib::PropertyProxy< float > property_xalign ()
 Default value: 0.5. More...
 
Glib::PropertyProxy_ReadOnly< float > property_xalign () const
 Default value: 0.5. More...
 
Glib::PropertyProxy< float > property_yalign ()
 Default value: 0.5. More...
 
Glib::PropertyProxy_ReadOnly< float > property_yalign () const
 Default value: 0.5. More...
 
Glib::PropertyProxy< unsigned int > property_xpad ()
 Default value: 0. More...
 
Glib::PropertyProxy_ReadOnly< unsigned int > property_xpad () const
 Default value: 0. More...
 
Glib::PropertyProxy< unsigned int > property_ypad ()
 Default value: 0. More...
 
Glib::PropertyProxy_ReadOnly< unsigned int > property_ypad () const
 Default value: 0. More...
 
Glib::PropertyProxy< int > property_width ()
 Default value: -1. More...
 
Glib::PropertyProxy_ReadOnly< int > property_width () const
 Default value: -1. More...
 
Glib::PropertyProxy< int > property_height ()
 Default value: -1. More...
 
Glib::PropertyProxy_ReadOnly< int > property_height () const
 Default value: -1. More...
 
Glib::PropertyProxy< bool > property_is_expander ()
 Default value: false More...
 
Glib::PropertyProxy_ReadOnly< bool > property_is_expander () const
 Default value: false More...
 
Glib::PropertyProxy< bool > property_is_expanded ()
 Default value: false More...
 
Glib::PropertyProxy_ReadOnly< bool > property_is_expanded () const
 Default value: false More...
 
Glib::PropertyProxy_WriteOnly< Glib::ustring > property_cell_background ()
 Default value: "". More...
 
Glib::PropertyProxy< Gdk::RGBAproperty_cell_background_rgba ()
 Cell background as a GdkRGBA More...
 
Glib::PropertyProxy_ReadOnly< Gdk::RGBAproperty_cell_background_rgba () const
 Cell background as a GdkRGBA More...
 
Glib::PropertyProxy< bool > property_cell_background_set ()
 Default value: false More...
 
Glib::PropertyProxy_ReadOnly< bool > property_cell_background_set () const
 Default value: false More...
 
Glib::PropertyProxy_ReadOnly< bool > property_editing () const
 Default value: false More...
 
- Public Member Functions inherited from Gtk::Object
 Object (Object&& src) noexcept
 
Objectoperator= (Object&& src) noexcept
 
 ~Object () noexcept override
 

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::CellRendererSpinnerwrap (GtkCellRendererSpinner* object, bool take_copy=false)
 A Glib::wrap() method for this object. More...
 

Additional Inherited Members

- Protected Member Functions inherited from Gtk::CellRenderer
 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 snapshot_vfunc (const Glib::RefPtr< Gtk::Snapshot >&snapshot, Widget& widget, const Gdk::Rectangle& background_area, const Gdk::Rectangle& cell_area, CellRendererState flags)
 
virtual bool activate_vfunc (const Glib::RefPtr< const Gdk::Event >& event, Widget& widget, const Glib::ustring& path, const Gdk::Rectangle& background_area, const Gdk::Rectangle& cell_area, CellRendererState flags)
 
virtual CellEditablestart_editing_vfunc (const Glib::RefPtr< const Gdk::Event >& event, Widget& widget, const Glib::ustring& path, const Gdk::Rectangle& background_area, const Gdk::Rectangle& cell_area, CellRendererState flags)
 
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...
 

Detailed Description

Renders a spinning animation in a cell.

A CellRendererSpinner can be used as an alternative to CellRendererProgress for displaying indefinite activity, instead of actual progress.

To start the animation in a cell, set the active property to true and increment the pulse property at regular intervals.

Deprecated:
4.10: List views use widgets to display their contents. You should use Gtk::Spinner instead.

Constructor & Destructor Documentation

Gtk::CellRendererSpinner::CellRendererSpinner ( CellRendererSpinner&&  src)
noexcept
Gtk::CellRendererSpinner::CellRendererSpinner ( const CellRendererSpinner )
delete
Gtk::CellRendererSpinner::~CellRendererSpinner ( )
overridenoexcept
Gtk::CellRendererSpinner::CellRendererSpinner ( )

Member Function Documentation

static GType Gtk::CellRendererSpinner::get_type ( )
static

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

GtkCellRendererSpinner* Gtk::CellRendererSpinner::gobj ( )
inline

Provides access to the underlying C GObject.

const GtkCellRendererSpinner* Gtk::CellRendererSpinner::gobj ( ) const
inline

Provides access to the underlying C GObject.

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

Whether the spinner is active (ie.

shown) in the cell

Default value: false

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::CellRendererSpinner::property_active ( ) const

Whether the spinner is active (ie.

shown) in the cell

Default value: false

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::CellRendererSpinner::property_pulse ( )

Pulse of the spinner.

Increment this value to draw the next frame of the spinner animation. Usually, you would update this value in a timeout.

By default, the Gtk::Spinner widget draws one full cycle of the animation, consisting of 12 frames, in 750 milliseconds.

Default value: 0

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::CellRendererSpinner::property_pulse ( ) const

Pulse of the spinner.

Increment this value to draw the next frame of the spinner animation. Usually, you would update this value in a timeout.

By default, the Gtk::Spinner widget draws one full cycle of the animation, consisting of 12 frames, in 750 milliseconds.

Default value: 0

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< Gtk::IconSize > Gtk::CellRendererSpinner::property_size ( )

The Gtk::IconSize value that specifies the size of the rendered spinner.

Default value: Gtk::IconSize::INHERIT

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< Gtk::IconSize > Gtk::CellRendererSpinner::property_size ( ) const

The Gtk::IconSize value that specifies the size of the rendered spinner.

Default value: Gtk::IconSize::INHERIT

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::CellRendererSpinner* wrap ( GtkCellRendererSpinner *  object,
bool  take_copy = false 
)
related

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

Parameters
objectThe C instance.
take_copyFalse 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.