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