GtkCellRendererSpin

GtkCellRendererSpin — Renders a spin button in a cell

Synopsis


#include <gtk/gtk.h>


                    GtkCellRendererSpin;
GtkCellRenderer*    gtk_cell_renderer_spin_new          (void);


Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkCellRenderer
                     +----GtkCellRendererText
                           +----GtkCellRendererSpin

Properties


  adjustment               GtkAdjustment         : Read / Write
  climb-rate               gdouble               : Read / Write
  digits                   guint                 : Read / Write

Description

GtkCellRendererSpin renders text in a cell like GtkCellRendererText from which it is derived. But while GtkCellRendererText offers a simple entry to edit the text, GtkCellRendererSpin offers a GtkSpinButton widget. Of course, that means that the text has to be parseable as a floating point number.

The range of the spinbutton is taken from the adjustment property of the cell renderer, which can be set explicitly or mapped to a column in the tree model, like all properties of cell renders. GtkCellRendererSpin also has properties for the climb rate and the number of digits to display. Other GtkSpinButton properties can be set in a handler for the start-editing signal.

The GtkCellRendererSpin cell renderer was added in GTK+ 2.10.

Details

GtkCellRendererSpin

typedef struct _GtkCellRendererSpin GtkCellRendererSpin;


gtk_cell_renderer_spin_new ()

GtkCellRenderer*    gtk_cell_renderer_spin_new          (void);

Creates a new GtkCellRendererSpin.

Returns : a new GtkCellRendererSpin

Since 2.10

Property Details

The :adjustment property

  adjustment               GtkAdjustment         : Read / Write

The adjustment that holds the value of the spinbutton. This must be non-NULL for the cell renderer to be editable.

Since 2.10


The :climb-rate property

  climb-rate               gdouble               : Read / Write

The acceleration rate when you hold down a button.

Allowed values: >= 0

Default value: 0

Since 2.10


The :digits property

  digits                   guint                 : Read / Write

The number of decimal places to display.

Allowed values: <= 20

Default value: 0

Since 2.10

See Also

GtkCellRendererText, GtkSpinButton